Escrow Errors
The following error codes and messages appear in REST responses when an error prevents completion of the request.
Error Code | Description |
|---|---|
ERROR_CARD_VALIDATION_IN_PAYMENT_WITH_ESCROW | The request attempted to validate a card as part of an escrow transaction, but these two operations must be done separately. The request was rejected. Corrective action: Create a payment with a card payment method, set 'capture' to false, set 'amount’ to 0, and set 'escrow' to null. Next, create the payment with the escrow. |
ERROR_ESCROW_ALREADY_RELEASED | The request tried to create or update a payment that does not involve an escrow, but 'escrow_release_days' was set. The request was rejected. Corrective action: Set 'escrow_release_days' to null. |
ERROR_ESCROW_RELEASE_DAYS_NOT_VALID | The request tried to set the number of days for release of an escrow, but the number was out of range. The request was rejected. Corrective action: For 'escrow_release_days', use an integer between 1 and 90. |
ERROR_GET_ESCROW | The request attempted an operation that requires a payment and its escrow, but the payment or the escrow was not found. The request was rejected. Corrective action: Use a valid ID for the payment and for the escrow. |
ERROR_PAYMENT_ESCROW_RELEASE_DAYS_NOT_APPLICABLE | The request tried to create or update a payment that does not involve an escrow, but 'escrow_release_days' was set. The request was rejected. Corrective action: Set 'escrow_release_days' to null. |
ERROR_PREVIOUS_RELEASE_FROM_ESCROW_WAS_NOT_PROPORTIONATE | The request tried to do a proportionate partial release of an escrow to multiple wallets, but there was a previous partial release by percentage or by specific amounts. The request was rejected. Corrective action: In the body of the request, provide an array of wallets, and for each wallet, indicate its ID and the specific 'percentage' or 'amount' to release. |
ERROR_RELEASE_ESCROW_DUPLICATE_EWALLET | The request tried to release an escrow, but one wallet appeared more than one time. The request was rejected. Corrective action: In the array of wallets, list each wallet only one time. |
ERROR_RELEASE_ESCROW_EWALLET_ALREADY_FULLY_RELEASED | The request tried to release an escrow, but the entire amount of the payment was already released, or the entire portion allotted to one wallet was already released. The request was rejected. Corrective action: None. Determine why an attempt was made to release more funds than was specified in the payment. |
ERROR_RELEASE_ESCROW_EWALLET_AMOUNT_EXCEEDS_ORIGINAL_SPLIT | The request tried to release an escrow, but the amount specified for one of the wallets and the amount previously released to that wallet was greater than the amount set in the payment for that wallet. The request was rejected. Corrective action: For each wallet in the 'ewallets' array, set an amount that is less than or equal to the amount set in the payment. |
ERROR_RELEASE_ESCROW_EWALLET_NOT_FOUND_IN_PAYMENT | The request tried to release an escrow, but one of the wallets was not specified when the payment was created. The request was rejected. Corrective action: In the 'ewallets' array, specify only wallets that were part of the payment. |
ERROR_RELEASE_ESCROW_EWALLETS_CANNOT_SET_BOTH_AMOUNT_AND_PERCENTAGE | The request tried to release an escrow, but the amount released to one of the wallets was specified by both amount and percentage. The request was rejected. Corrective action: In the 'ewallet' object, specify 'amount' or 'percentage' or neither. If you specify neither, the amounts will be released to the wallets in proportion to the amounts defined in the payment. |
ERROR_RELEASE_ESCROW_EWALLETS_INCONSISTENCY | The request tried to release an escrow to multiple wallets, but the method of determining the amounts was not the same for all the wallets. The request was rejected. Corrective action: For all of the wallets in the 'ewallets' array, use 'amount' or 'percentage' or neither. If you specify neither, the amounts will be released to the wallets in proportion to the amounts defined in the payment. |
ERROR_RELEASE_ESCROW_INVALID_AMOUNT | The request tried to release an escrow, but the amount was not recognized. The request was rejected. Corrective action: For 'amount', use a positive decimal number. |
ERROR_RELEASE_ESCROW_INVALID_EWALLETS | The request tried to release an escrow, but the wallets were not specified as part of an array. The request was rejected. Corrective action: For 'ewallets', use an array of one or more objects. |
ERROR_RELEASE_ESCROW_INVALID_EWALLETS_AMOUNT | The request tried to release an escrow, but the amount for one of the wallets was not a positive decimal number. The request was rejected. Corrective action: For 'amount', use a positive decimal number. |
ERROR_RELEASE_ESCROW_INVALID_EWALLETS_PERCENTAGE | The request tried to release an escrow, but the amount for one of the wallets was not recognized. The request was rejected. Corrective action: For 'percentage', use a positive decimal number less than 100, with up to two decimal places. |
ERROR_RELEASE_ESCROW_INVALID_PERCENTAGE | The request tried to release an escrow, but the allocation by percentage was not recognized. The request was rejected. Corrective action: For 'percentage' in each object in the 'ewallets' array, use a positive decimal number less than 100, with up to two decimal places. |
ERROR_RELEASE_ESCROW_MISSING_EWALLET_ID | The request tried to release an escrow, but one of the wallets was not found. The request was rejected. Corrective action: In the 'ewallets' array, use IDs of valid wallets. |
ERROR_RELEASE_ESCROW_MUST_SET_AMOUNT_OR_PERCENTAGE_OR_EWALLETS | The request tried to release an escrow, but the method of distributing the funds was unclear. The request was rejected. Corrective action: Specify one of the following fields: 'amount', 'percentage', 'ewallets', or none of them. |
ERROR_RELEASE_ESCROW_NO_FUNDS_ON_HOLD | The request tried to release funds from an escrow, but there are no funds on hold. The request was rejected. Corrective action: Release funds from escrow when there are funds on hold. |
ERROR_RELEASE_ESCROW_NOT_ENOUGH_FUNDS_ON_HOLD | The request tried to release an escrow, but the amount specified was more than the amount on hold. The request was rejected. Corrective action: Use 'amount' or 'percentage' or neither to define the release so that the amount released is less than or equal to the amount on hold. |
ERROR_RELEASE_ESCROW_STATUS | The request tried to release funds from an escrow, but the status of the escrow does not allow release. The request was rejected. Corrective action: Release funds from escrow when the 'status' of the escrow is 'released' or 'on_hold'. |