Create Payment

Use the Create Payment endpoint to move funds into a customer account. This endpoint may return load limit and velocity violations in its response. Payments created with this endpoint are returned by the Get Account Overview endpoint only after several seconds have elapsed.

Load limit and velocity response

If the payment violates load or velocity limits, this endpoint returns status: 26 with limit_error, limit_id, and limit_response_code values. Use the limit_id for troubleshooting the load and velocity configuration. The limit_response_code values are enumerated in the Limit Response Codes table.

Consult the Creating a Payment guide for instructions on using this endpoint.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status codeDescription
408-01Success -- partial limit violation. The value in amount exceeds the maximum account load and will only be partially applied. Inform the customer that the payment was only partially loaded to the account.
408-02holdAmount is missing while holdExpirationDateTime is passed. When holdExpirationDateTime is populated, holdAmount is required.
408-03Holds are not enabled for this product/program. Please contact client support for more information.
408-04Provided XID does not map to a valid balance in our system. The internal account ID does not have a valid balance_id. Verify that the PRN is correct or contact Galileo for troubleshooting.
408-05Provided expiration date needs to be in the correct format (YYYY-MM-DD HH:MM:SS) and needs to be in the future. Verify that holdExpirationDateTime is in the correct format and is in the future.
408-08Amount must be equal to or less than the payment minus any other holds that have already been placed. The holdAmount is invalid.
408-09An unknown error occurred while creating the hold. Please contact client support if this error persists.
408-10Amount must be equal to or less than the account balance. The holdAmount cannot be a negative number or an amount larger than the account balance.
Click Try It! to start a request and see the response here!