Group Payment 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_GROUP_PAYMENT | The request attempted to validate a card as part of a group payment. The request was rejected. Corrective action: Create a payment with a card payment method, set 'capture' to false, set 'amount’ to 0, and list only one payment in the 'payments' array. |
ERROR_CASH_NOT_SUPPORTED_FOR_GROUP_PAYMENT | The request tried to create a group payment, but one of the payment methods in the individual payments was a cash payment method. The request was rejected. Corrective action: For all payments, use the following types of payment methods: card, bank_redirect, bank_transfer. |
ERROR_CREATE_GROUP_PAYMENT_EXCEEDED_MAX_PARTICIPANTS | The request tried to create a group payment, but there were too many individual payments. The request was rejected. Corrective action: Use 2 to 10 payments. |
ERROR_CREATE_GROUP_PAYMENT_INVALID_EXPIRATION | The request tried to create a group payment, but the expiration was not valid. The request was rejected. Corrective action: For 'expiration', use a Unix timestamp for a time in the future. |
ERROR_CREATE_GROUP_PAYMENT_INVALID_PAYMENTS | The request tried to create a group payment, but the payments were not in the form of an array. The request was rejected. Corrective action: For the 'payments' array, use an array of 'payment' objects. |
ERROR_CREATE_GROUP_PAYMENT_MISSING_CURRENCY | The request tried to create a group payment, but one of the payment methods did not specify a currency. The request was rejected. Corrective action: For all payments, specify the same currency. |
ERROR_CREATE_GROUP_PAYMENT_MISSING_PAYMENTS | The request tried to create a group payment, but the payments were not found. The request was rejected. Corrective action: For the 'payments' array, use an array of 'payment' objects. |
ERROR_CREATE_GROUP_PAYMENT_PARTICIPANTS_LESS_THAN_MIN | The request tried to create a group payment, but there was only one individual payment. The request was rejected. Corrective action: Use 2 to 10 payments. |
ERROR_DIFFERENT_COUNTRIES_NOT_SUPPORTED_FOR_GROUP_PAYMENT | The request tried to create a group payment, but the payment methods in the individual payments were not all from the same country. The request was rejected. Corrective action: For all payments, use payment methods that are supported in the same country. |
ERROR_DIFFERENT_CURRENCIES_NOT_SUPPORTED_FOR_GROUP_PAYMENT | The request tried to create a group payment or replace a failed payment in a group payment, but the individual payments did not all use the same currency. The request was rejected. Corrective action: Use the same currency for all payments. |
ERROR_ESCROW_NOT_SUPPORTED_FOR_GROUP_PAYMENT | The request tried to create a group payment, but one of the payment methods required an escrow. The request was rejected. Corrective action: For all payments, do not use escrow. |
ERROR_FX_NOT_SUPPORTED_FOR_GROUP_PAYMENT | The request tried to create a group payment, but one of the payment methods required currency exchange. The request was rejected. Corrective action: For all payments, do not use currency exchange. |
ERROR_GET_GROUP_PAYMENT | The request attempted an operation that requires a group payment, but the group payment was not found. The request was rejected. Corrective action: Use the ID of a valid group payment, a string starting with 'gp_'. |
ERROR_GROUP_PAYMENT_CAN_NOT_BE_CANCELED | The request tried to cancel a group payment, but the statuses of the individual payments were not all 'ERR' or 'ACT'. The request was rejected. Corrective action: None. Contact Rapyd Client Support. |
ERROR_GROUP_PAYMENT_CAN_NOT_BE_REFUNDED | The request tried to create a refund on a group payment, but the statuses of the individual payments were not all 'ERR' or 'CLO'. The request was rejected. Corrective action: None. Wait until all payments are closed, or contact Client Support. |
ERROR_GROUP_PAYMENT_NO_FAILED_PAYMENTS_TO_REPLACE | The request tried to replace a payment in a group payment, but there were no failed payments to replace. The request was rejected. Corrective action: None. Wait until one of the payments fails. |
ERROR_GROUP_PAYMENT_PAYMENT_AMOUNT_EXCEEDS_FAILED_PAYMENTS_TOTAL_AMOUNT | The request tried to replace a payment in a group payment, but the amount was greater than the total amount of failed payments. The request was rejected. Corrective action: Set 'amount' to the total amount of failed payments. |
ERROR_INVALID_GROUP_PAYMENT | The request attempted an operation that requires a group payment, but the ID of the group payment was not a string. The request was rejected. Corrective action: For 'group_payment', use the ID of a valid group payment, which is a string starting with 'gp'. |
ERROR_MISSING_GROUP_PAYMENT | The request attempted an operation that requires a group payment, but the group payment was not found. The request was rejected. Corrective action: Use the ID of a valid group payment, a string starting with 'gp_'. |
ERROR_REFUND_GROUP_PAYMENT_INVALID_AMOUNT | The request tried to refund against a group payment, but the amount was not valid. The request was rejected. Corrective action: For 'amount', use a decimal number. |