Checkout Errors
The following error codes and messages appear in REST responses when an error prevents completion of the request.
Error Code | Description |
|---|---|
ERROR_ACCOUNT_FUNDING_TRANSACTION | The request tried to create an account funding transaction, but your organization is not configured for such transactions. The request was rejected. Corrective action: Contact Rapyd Client Support. |
ERROR_CHECKOUT_AFT_MISSING_FIELDS_[<FIELD>] | The request tried to create a checkout page with a customer to customer AFT payment workflow, but one or more required fields were missing. The missing fields are listed at the end of the error code. The request was rejected. Corrective action: Rerun the request with all the required fields |
ERROR_CHECKOUT_AFT_WITH_MULTIPLE_WALLETS | The request tried to create a checkout page with 'aft' set to 'true', but the request included more than one wallet. The request was rejected. Corrective action: Set 'ewallets' to an array of one 'ewallet' object. |
ERROR_CHECKOUT_COUNTRY_CURRENCY_MISMATCH | The request tried to create a checkout page, but there is no payment method that is supported in the country for the currency provided. The request was rejected. Corrective action: Use a different currency or country. |
ERROR_CHECKOUT_CURRENCY_COUNTRY_MISMATCH | The request tried to create a checkout page, but there is no payment method that is supported in the country for the currency provided. The request was rejected. Corrective action: Use a different currency or country. |
ERROR_CHECKOUT_CUSTOMER_MISSING_FOR_RECURRING_OR_INSTALLMENT_RECURRENCE_TYPE | The request tried to create a checkout page without a ‘customer’ field while ‘recurrence_type’ was set to ‘installment’ or ‘recurring’. The request was rejected. Corrective action: Add a ‘customer’ field to the request and rerun it. |
ERROR_CHECKOUT_PAGE_REQUIRED_CUSTOMER_FIELDS_NOT_VALID | The request tried to create a checkout page, but one or more of the values in 'required_customer_fields' is not valid. The request was rejected. Corrective action: Provide an array of strings that contain only the following valid values: ‘name’, ‘email’, ‘phone_number’, ‘address’. |
ERROR_CHECKOUT_PAGE_DELAYED_CAPTURE_NO_REMAINING_SUPPORTING_CARDS | The request tried to generate a checkout page for a card payment method with delayed capture, but the request filtered the list of payment methods and none of the remaining payment methods support delayed capture. The request was rejected. Corrective action: Set 'capture' to null, or set 'payment_method_type', 'payment_method_type_categories', 'payment_method_types_exclude' and 'payment_method_types_include' such that one or more remaining payment method types are cards that support delayed capture. To determine whether a payment method type supports delayed capture, run 'Get Payment Method Required Fields'. |
ERROR_CHECKOUT_PAGE_DELAYED_CAPTURE_NO_SUPPORTING_CARDS | The request tried to generate a checkout page for a card payment method with delayed capture, but there are no card payment methods in the country that support delayed capture. The request was rejected. Corrective action: Set 'capture' to null. |
ERROR_CHECKOUT_PAGE_PAYMENT_METHOD_TYPE_CATEGORIES_VALUE_NOT_VALID | The request tried to create a checkout page, but one or more of the values in 'payment_method_type_categories' was set to null, an empty string or an unrecognized value. The request was rejected. Corrective action: Provide an array of strings that contain only the following values: 'bank_redirect', 'bank_transfer', 'card', 'cash', 'ewallet'. |
ERROR_CHECKOUT_PAGE_REQUIRED_CUSTOMER_FIELDS_NOT_VALID | The request tried to create a checkout page, but one or more of the values in 'required_customer_fields' is not valid. The request was rejected. Corrective action: Provide an array of strings that contain only the following valid values: ‘name’, ‘email’, ‘phone_number’, ‘address’. |
ERROR_CHECKOUT_PAYMENT_METHOD_CATEGORY_CURRENCY_MISMATCH | The request tried to create a checkout page, but one of the payment method categories provided did not contain any payment methods that are supported in the country for the currency provided. The request was rejected. Corrective action: Remove the payment method category from the list. |
ERROR_CHECKOUT_PAYMENT_METHOD_CURRENCY_MISMATCH | The request tried to create a checkout page, but the payment method was not recognized. The request was rejected. Corrective action: Specify a payment method that is valid for the country. Use 'List Payment Methods by Country'. |
ERROR_CREATE_CHECKOUT_AMOUNT_OUT_OF_RANGE | The request tried to create a checkout page, but the amount was out of range for all payment methods available to you in the country, or for all payment methods that you specified. The request was rejected. Corrective action: For ‘amount’, specify an amount that is between the minimum and the maximum for at least one payment method. For details, run 'List Payment Methods by Country'. |
ERROR_HOSTED_PAGE_AMOUNT_MISMATCH | The request tried to create a checkout page with a 'cart_items' object, but the value of the 'amount' parameter does not match the total amount of all items in the 'cart_items' object. The request was rejected. Corrective action: Specify the 'amount' parameter for each item in the cart, and omit it from the root of the request. |
ERROR_HOSTED_PAGE_CONFLICTING_PAYMENT_METHOD_TYPES | The request tried to create a checkout page, but the request specified multiple ways of determining available payment methods. The request was rejected. Corrective action: Specify a 'payment_method_type', a list of types in 'payment_method_types_include', a list of types in 'payment_method_types_exclude' or a list of categories in 'payment_method_type_categories', or leave all of these parameters blank. |
ERROR_HOSTED_PAGE_FX_FEE_VALUE_NOT_VALID | The request tried to create a payment, but the amount of the FX fee was incorrect. The request was rejected. Corrective action: In the 'fx_fee' object, set 'value' to a decimal number greater than 0 and less than 100. |
ERROR_HOSTED_PAGE_GET_CUSTOMER | The request tried to create a checkout page, but the customer was not found. The request was rejected. Corrective action: For 'customer', provide a valid customer ID, a string starting with 'cus_'. |
ERROR_HOSTED_PAGE_INVALID_COUNTRY | The request tried to create a checkout page, but the country was not recognized. The request was rejected. Corrective action: For the 'country' field, use the 2-letter ISO 3166-1 ALPHA-2 code in uppercase letters. |
ERROR_HOSTED_PAGE_INVALID_EXPORT_TYPE | The request tried to create a follow-up message after a payment via checkout page, but the 'type' parameter was not recognized. The request was rejected. Corrective action: Set 'type' to 'email' or 'text'. |
ERROR_HOSTED_PAGE_INVALID_PAYMENT_METHOD_TYPE | The request tried to create a checkout page, but the payment method was not recognized. The request was rejected. Corrective action: Specify a payment method that is valid for the country. Use 'List Payment Methods by Country'. |
ERROR_HOSTED_PAGE_INVALID_PAYMENT_METHOD_TYPE_AND_PAYMENT_METHOD_TYPE_CATEGORIES | The request tried to create a checkout page, but the request specified both a payment method type and a set of payment method type categories. The request was rejected. Corrective action: Specify 'payment_method_type' or a set of types in 'payment_method_type_categories', or leave both parameters blank. |
ERROR_HOSTED_PAGE_INVALID_PAYMENT_METHOD_TYPE_CATEGORIES | The request tried to create a checkout page, but one or more of the values in 'payment_method_type_categories' was set to null, an empty string or an unrecognized value. The request was rejected. Corrective action: Provide an array of strings that contain only the following values: 'bank_redirect', 'bank_transfer', 'card', 'cash', 'ewallet'. |
ERROR_HOSTED_PAGE_INVALID_STATUS | The request tried to create a payment for a checkout page, but the checkout page was already paid. The request was rejected. Corrective action: Determine why there were multiple attempts to pay the same checkout page. |
ERROR_HOSTED_PAGE_PAYMENT_METHOD_TYPE_CATEGORIES_NOT_ENABLED | The request tried to create a checkout page, but one or more of the payment method type categories was not enabled. The request was rejected. Corrective action: Use the Client Portal to enable the payment method type categories you want to appear in the checkout page. |
ERROR_HOSTED_PAGE_UNREADABLE_PAYMENT_METHOD_TYPES_EXCLUDE_LIST | The request tried to create a checkout page with a list of payment method types to exclude, but the data was not recognized. The request was rejected. Corrective action: In 'payment_method_types_exclude', specify a list of strings, each of which is a payment method type. |
ERROR_HOSTED_PAGE_UNREADABLE_PAYMENT_METHOD_TYPES_INCLUDE_LIST | The request tried to create a checkout page with a list of payment method types to include, but the data was not recognized. The request was rejected. Corrective action: In 'payment_method_types_include', specify a list of strings, each of which is a payment method type. |
ERROR_HOSTED_PAGE_UNRECOGNIZED_PAYMENT_METHOD_TYPE | The request tried to create a checkout page, but the payment method type specified is not available or does not exist at all. The request was rejected. Corrective action: Specify payment method types that are valid for the country. Use ‘List Payment Methods by Country’. |
ERROR_HOSTED_PAGE_UNRECOGNIZED_PAYMENT_METHOD_TYPES_TO_INCLUDE | The request tried to create a hosted page, but the payout method types in 'payout_method_types_include' were not recognized. The request was rejected. Corrective action: Specify payout method types that are valid for the category, country and entity type. Use 'List Payout Method Types'. |
ERROR_INVALID_ADDRESS | The request attempted an operation that requires a valid address, but the address details were missing or invalid. The request was rejected. Corrective action: Enter a full and valid address that includes at least one line ('line_1') and a zip code. |
ERROR_NOT_AFT_METHOD | The request attempted a hosted page operation for funding a wallet, but one of the payment methods does not support account-funding transactions (AFT) The request was rejected. Corrective action: None. In the 'payment_method_types' array, list only payment methods that support AFT. |
INVALID_DISCOUNT_PERCENT_AND_AMOUNT_OFF | The request tried to apply a discount, but the type of discount could not be determined. The request was rejected. Corrective action: Set 'percent_off' or set 'amount_off'. |