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 code | Description |
---|---|
408-01 | Success -- 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-02 | holdAmount is missing while holdExpirationDateTime is passed . When holdExpirationDateTime is populated, holdAmount is required. |
408-03 | Holds are not enabled for this product/program. Please contact client support for more information. |
408-04 | Provided 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-05 | Provided 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-08 | Amount must be equal to or less than the payment minus any other holds that have already been placed. The holdAmount is invalid. |
408-09 | An unknown error occurred while creating the hold. Please contact client support if this error persists. |
408-10 | Amount 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. |