Documentation

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_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_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'.