--- title: "Create Checkout Page" source_url: https://docs.rapyd.net/en/create-checkout-page.html lang: en --- # Create Checkout Page Create a checkout page that makes a payment. This method can be used by all clients without the need for PCI certification. After the customer submits the information on the hosted page, Rapyd processes the request and sends you one or more webhooks, depending on the payment method and parameters of the request. See [Create Payment](https://docs.rapyd.net/en/create-payment.md "Create Payment"). The [Payment Succeeded Webhook](https://docs.rapyd.net/en/payment-succeeded-webhook.md "Payment Succeeded Webhook") is sent when the customer successfully submits the information on the hosted page. > **Note:** > > - If you create the checkout page specifying the `customer` field, only the customer’s default payment method appears on the checkout page. > - The `amount` must be specified in either `amount` or the `amount` field of each item in the cart. > - For setting up digital wallet payments on a checkout page, see [Recurring Digital Wallet Payments](https://docs.rapyd.net/en/recurring-digital-wallet-payments.md "Recurring Digital Wallet Payments"). > - If the payment method type is Google Pay, the customer must open the checkout page in a single browser window. On an Apple device, the customer must use Safari. > - To enable account funding transactions, contact [Rapyd Client Support](https://support.rapyd.net). > - You have the option to include customer information directly within a request instead of indicating an existing `customer` ID. This option automatically creates a `customer` with the payment transaction, and the response returns their `customer` ID. See also the related code sample 'Create Checkout Page with Customer Object' on this page. > - The code samples include successful requests (200) and bad requests (400). > > - For error messages that appear due to bad requests (400), see: > > - [General Errors](https://docs.rapyd.net/en/general-errors.md "General Errors") > - [Checkout Errors](https://docs.rapyd.net/en/checkout-errors.md "Checkout Errors") > - For information about unauthorized request (401) and other authentication errors, see [Troubleshooting Authentication and Authorization Errors](https://docs.rapyd.net/en/troubleshooting-authentication-and-authorization-errors.md "Troubleshooting Authentication and Authorization Errors"). ### Parameters ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - idempotency - A unique key that prevents the platform from creating the same object twice. See [Idempotency](https://docs.rapyd.net/en/idempotency.md "Idempotency"). - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Request Body Parameters - account_funding_transaction - Details of an account funding transaction (AFT), which transfers funds from a card to a cardholder's wallet. You can transfer funds from a card directly to the cardholder's own wallet. You can also transfer the funds indirectly through the **company** wallet of a licensed business entity that manages the customer's wallet. The business forwards the funds to the customer's wallet. When a business transfers the funds, `customer` is required in the root of the request. The customer address must include `phone_number`, `line_1` (street and number), `city`, `country`, and `zip` (postal code). This feature is in beta testing. Relevant to payment method types that support AFT. To enable this feature, contact [Rapyd Client Support](https://support.rapyd.net). Contains the following fields: - - ewallet - ID of a Rapyd wallet. String starting with **ewallet_**. The wallet contact must include first name, last name, country, and the `address` object, which must contain `line_1` (street and number), `city`, and `zip` (postal code). The cardholder's first name, last name, and country must match the values of the wallet contact. - - payment_method_types - Array of strings. One or more card payment method types that support AFT. - - purpose_code - Describes the purpose of the AFT transaction. One of the following values: - crowd_lending - crypto_currency - education - emergency_need - family_support - gifts - high_risk_securities - hospitalization_and_medical_treatment - other - regular_labor_transfers - salary - savings - travel_and_tourism - - amount - The amount of the payment, in units of the currency defined in `currency`. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. If the amount is a whole number, use an integer and not a decimal. Required when `cart_items` is not specified. - cancel_checkout_url - URL where the customer is redirected after pressing **Back to Website** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - capture - Determines when the payment is processed for capture. Relevant to card payments. - **true** - Capture the payment immediately. - **false** - Authorize the payment, then capture some or all of the payment at a later time, when the merchant runs the [Capture Payment](https://docs.rapyd.net/en/capture-payment.md "Capture Payment") method. > **Note:** > > Some card payment methods do not support delayed capture. true - - cart_items - Describes the cart items that the customer is purchasing. These items are displayed at the checkout page. Contains the following fields: - - amount - The price of the item in the currency defined in `currency`. - - amount_off - The size of a discount, measured in the amount of money. Decimal. Range: Positive decimal number, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. Relevant when `percent_off` is not set. - - image - The image that appears for this item in the checkout page. - - name - The name of the item. - - percent_off - The size of a discount, measured in percent. Integer. Range: 1-100. Relevant when `amount_off` is not set. - - quantity - The quantity of the item. - complete_checkout_url - URL where the customer is redirected after pressing **Finish** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - complete_payment_url - URL where the customer is redirected when payment is successful, after returning from an external page such as a 3DS page. Does not support localhost URLs. - - country - The two-letter ISO 3166-1 ALPHA-2 code for the country. To determine the code for a country, see [List Countries](https://docs.rapyd.net/en/list-countries.md "List Countries"). - - currency - Defines the currency for the amount received by the seller (merchant). Three-letter ISO 4217 code. In FX transactions, when `fixed_side` is **buy**, it is the currency received by the merchant. When `fixed_side` is **sell**, it is the currency charged to the buyer. - - custom_elements - Describes customizations of the page as it appears to the customer. - - billing_address_collect - Determines whether the customer is asked to fill in the billing address. Relevant when a card payment method is selected. - **true** - The address fields appear on the checkout page. - **false** - The address fields appear only if the `country` is **US**, **GB** or **CA**. false > **Note:** > > When the customer already has address details, it is always displayed. - - cardholder_name - The name of the card owner, printed on the front of the card. - - display_description - Determines whether the checkout page displays the payment description. - **true** - The payment description appears. - **false** - The payment description does not appear. false Relevant when `description` is passed in the [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request. - - dynamic_currency_conversion - Determines whether the checkout page displays multiple currency options for a payment. - **true** - Multiple currency options appear. - **false** - Currency options do not appear. false When the customer selects the requested currency, the checkout page displays the following information: - The original amount and currency. - The converted amount in the requested currency. - The exchange rate. Relevant when: - The [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request passes `requested_currency`. - `fixed_side` is **buy**. - One or more payment methods support the values for `currency` and `requested_currency`. - - merchant_color - Reserved. - - merchant_currency_only - In a payment with FX where `fixed_side`=**buy**, determines whether the buyer's currency and the exchange rate appear. One of the following: - **true** - The currency and the exchange rate are hidden. - **false** - The currency and the exchange rate appear. false - - payment_fees_display - Determines whether payment fees appear on the checkout page. - **true** - Payment fees appear when the `payment_fees` object is set in the [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request. - **false** - Payment fees do not appear. true - - required_customer_fields - Indicates the list of fields that the customer has to fill in on the payment page before completing the payment via hosted checkout. Valid values include: - **name**– The customer's full name (default). - **email** – The customer's email address. - **phone_number** – The customer's phone number. - **address** – The address of the customer. - - save_card_default - Determines whether the **save card** checkbox is checked by default. - **true** - The **save card** checkbox is checked. - **false** - The **save card** checkbox is cleared. false Relevant when `customer` ID (token) is passed in the the [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request. Alternatively, you can pass a `customer` object in the request. See also the related code sample 'Create Checkout Page with Customer Object' on this page. - - customer - ID of the customer. String starting with **cus_**. When used, the customer has the option to save card details for future purchases. This field is for some payment methods and for all **company**-type wallets. Alternatively, a `customer` object that includes their details can be used. The response then return this customer object's ID. See also the related code sample 'Create Checkout Page with Customer Object' on this page. - - description - Description of the payment transaction. To display the description, set `display_description` to **true** in `custom_elements`. - error_payment_url - URL where the customer is redirected when payment is not successful, after returning from an external page, such as a 3DS page. Does not support localhost URLs. - - escrow - Determines whether the payment is held in escrow for later release. - - escrow_release_days - Determines the number of days after creation of the payment that funds are released from escrow. Funds are released at 5:00 pm GMT on the day indicated. Integer, range: 1-90. - - ewallet - ID of the wallet that the money is paid into. String starting with **ewallet_**. Relevant for specifying a single wallet in the request. - - ewallets - Specifies one or more wallets that the money is collected into. - - amount - The amount of the payment to the wallet, in units of the currency defined in `currency`. Decimal. If the total amount of the payment is not fully accounted for, the balance appears in the client wallet. Relevant when `percentage` is not set. - - ewallet - ID of the wallet. String starting with **ewallet_**. - - percentage - The percentage that is paid to the wallet out of the total payment. Positive decimal between 0 and 100. More than 2 decimal places are rounded up to the next 0.01%. For example, 10 percent is represented by **percentage="10"**. If the total amount of the payment is not fully accounted for, the balance appears in the client wallet. Relevant when `amount` is not set. - - expiration - Time when the payment expires if it is not completed, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). When both `expiration` and `payment_expiration` are set, the payment expires at the earlier time. 14 days after creation of the checkout page. - - fixed_side - Indicates whether the FX rate is fixed for the buy side (seller) or for the sell side (buyer). One of the following values: - **buy** - The checkout page shows the currency that the seller (merchant) receives for goods or services. For example, a US-based merchant wants to charge 100 USD. The buyer (customer) pays the amount in MXN that converts to 100 USD. - **sell** - The checkout page shows the currency that the buyer is charged with to purchase goods or services from the seller. For example, a US-based merchant wants to charge a buyer 2,000 MXN and will accept whatever amount in USD that is converted from 2,000 MXN. buy - language - Determines the default language of the hosted page. For a list of values, see [List Supported Languages](https://docs.rapyd.net/en/list-supported-languages.md "List Supported Languages"). - When this parameter is null, the language of the user's browser is used. - If the language of the user's browser cannot be determined, the default language is English. - - max_payment_retries_attempt - Determines the number of times Rapyd can attempt to create a payment after an initial failure. **Range:** 0-10. 5 - - merchant_ewallet - ID of the Rapyd wallet that serves as the merchant's wallet. String starting with **ewallet_**. Restricted to Payment Facilitator (PayFac). See also the 'Create Checkout page with merchant wallet' sample on this page. Contact Rapyd Client Support before using this field. - - merchant_fields - Object that contains payment method fields that the merchant fills in. Can include one or both of the following: - `payment_method_options` object. - `payment_options` object. The fields of both objects are not displayed to the customer on the hosted page. To retrieve the fields of both objects for a payment method, use [Get Payment Method Required Fields](https://docs.rapyd.net/en/get-payment-method-required-fields.md "Get Payment Method Required Fields"). > **Note:** > > For 3DS, the `payment_method_options` object must be a top level object that includes the `3d_required` Boolean field. See also the 'Create Checkout Page - 3DS Required' sample on this page. - merchant_reference_id - Identifier defined by the client for reference purposes. Limit: 45 characters. - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - page_expiration - End of the time when the customer can use the hosted page, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). If `page_expiration` is not set, the hosted page expires 14 days after creation. **Range:** 1 minute to 30 days. - - payment_expiration - Length of time for the payment to be completed after it is created, measured in seconds. When both `expiration` and `payment_expiration` are set, the payment expires at the earlier time. - payment_fees - Defines transaction fees and foreign exchange fees. These are fees that the Rapyd merchant can define for its consumers in addition to the payment amount. They are not related to the fees Rapyd charges to its clients. - - transaction_fee - Describes the fee for processing the transaction. - - calc_type - Specifies how the fee is calculated. One of the following: - **net** - The fee is deducted from the amount paid. For example, in a payment of $100 with a fee of 5%, the recipient receives $95.00 and the $5.00 fee goes to the client wallet. - **gross** - The fee is added to the amount paid. For example, for a transaction of $100 with a fee of 5%, the sender pays $105.00. - - fee_type - One of the following: - **percentage** - A percentage of the transaction amount. For example, 5 percent is represented by **value=5**. - **absolute** - A fixed amount. - - value - The amount of the fee. - - fx_fee - Describes the fees for processing the currency exchange. Relevant to payments with FX. - - calc_type - Specifies how the fee is calculated. One of the following: - **net** - The fee is deducted from the amount paid. For example, in a payment of $100 with a fee of 5%, the recipient receives $95.00 and the $5.00 fee goes to the client wallet. - **gross** - The fee is added to the amount paid. For example, for a transaction of $100 with a fee of 5%, the sender pays $105.00. - - value - The amount of the fee. Percentage. - - gross_fees - The total gross fees for the transaction, in units defined by `currency_code`. - - net_fees - The total net fees for the transaction, in units defined by `merchant_requested_currency`. - - total_merchant_fees - The amount of the fee. - - payment_method_required_fields - Relevant only to subsequent card payments on the hosted checkout page. The object contains the hosted checkout page's displayed payment method fields that for increased security, the customer is always required to fill in. Must include the following object: - The `payment_method_options` object which includes one or more of its required fields. To retrieve the fields of a payment method, use [Get Payment Method Required Fields](https://docs.rapyd.net/en/get-payment-method-required-fields.md "Get Payment Method Required Fields"). See also the 'Create Checkout Page - Payment Method Required Fields' sample on this page. - - payment_method_type - The type of the payment method. For example, **it_visa_card**. To get a list of payment methods for a country, use [List Payment Methods by Country](https://docs.rapyd.net/en/list-payment-methods-by-country.md "List Payment Methods by Country"). See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - payment_method_type_categories - A list of the categories of payment method that are supported on the checkout page. The categories appear on the page in the order provided. One or more of the following: - **bank_redirect** - **bank_transfer** - **card** - **cash** - **ewallet** See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - payment_method_types_exclude - List of payment methods that are excluded from display on the checkout page. See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - payment_method_types_include - List of payment methods that are displayed on the checkout page. The payment methods appear on the page in the order provided. See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - recurrence_type - Specifies the primary intended purpose of the saved payment method. See [Saving a European Card While Creating a Payment](https://docs.rapyd.net/en/saving-a-european-card-while-creating-a-payment.md "Saving a European Card While Creating a Payment"). One of the following values: - **installment** - Regular payments for a defined number of payment cycles. - **recurring** - Regular payments for an indefinite period. - **unscheduled** - Individual unrelated payments. > **Note:** > > When value is `recurring` or `installment` then `save_payment_method` must be **true**. > > In subsequent payments, the checkbox **Save this card for future payments** is not displayed on the Hosted Checkout page. Only cards that were previously used by the customer and have a `recurrence_type` set to **recurring** or **installment** are displayed. unscheduled - - requested_currency - When `fixed_side` is **sell**, it is the currency received by the merchant. When `fixed_side` is **buy**, it is the currency charged to the buyer (customer). Three-letter ISO 4217 code. The checkout page displays the following information: - The original amount and currency. - The converted amount in the requested currency. - The exchange rate. Relevant to payments with FX. - require_card_cvv - Require the customer to enter their Card Verification Value (CVV) for each subsequent payment made using a saved card. Relevant to card payments. - **true** - Customer must enter CVV. - **false** - Customer not required to enter CVV. false - statement_descriptor - A text description suitable for a customer's payment statement. 5-22 characters. ### Response Parameters - - account_funding_transaction - Details of an account funding transaction (AFT), which transfers funds from a card to a cardholder's wallet. Contains the following fields: - - ewallet - ID of a Rapyd wallet. - - payment_method_types - Array of strings. One or more card payment method types that support AFT. - - purpose_code - Describes the purpose of the AFT transaction. - - amount - The amount of the payment, in units of the currency defined in `currency`. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. If the amount is a whole number, use an integer and not a decimal. - - cancel_checkout_url - URL where the customer is redirected after pressing **Back to Website** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - - capture - Determines when the payment is processed for capture. Relevant to card payments. - **true** - Capture the payment immediately. - **false** - Authorize the payment, then capture some or all of the payment at a later time, when the merchant runs the [Capture Payment](https://docs.rapyd.net/en/capture-payment.md "Capture Payment") method. - - cart_items - Describes the cart items that the customer is purchasing. These items are displayed at the checkout page. Contains the following fields: - - amount - The price of the item in the currency defined in `currency`. - - amount_off - The size of the discount, measured in the amount of money. Decimal. Range: Positive decimal number, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. - - discount - The total amount of money deducted from the payment for the discount. Decimal. Range: Positive decimal number, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. - - image - The image that appears in the checkout page for this item. - - name - The name of the item. - - percent_off - The size of the discount, measured in percent. Integer. Range: 1-100. - - quantity - The quantity of the item. - - complete_checkout_url - URL where the customer is redirected after pressing **Finish** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - - complete_payment_url - URL where the customer is redirected when payment is successful, after returning from an external page such as a 3DS page. Does not support localhost URLs. - - country - The two-letter ISO 3166-1 ALPHA-2 code for the country. To determine the code for a country, see [List Countries](https://docs.rapyd.net/en/list-countries.md "List Countries"). - - currency - Defines the currency for the amount received by the seller (merchant). Three-letter ISO 4217 code. In FX transactions, when `fixed_side` is **buy**, it is the currency received by the merchant. When `fixed_side` is **sell**, it is the currency charged to the buyer. - - custom_elements - Describes customizations of the page as it appears to the customer. - - billing_address_collect - Determines whether the customer is asked to fill in the billing address. Relevant when a card payment method is selected. - **true** - The address fields appear on the checkout page. - **false** - The address fields appear only if the `country` is **US**, **GB** or **CA**. false > **Note:** > > When the customer already has address details, it is always displayed. - - cardholder_name - The name of the card owner, printed on the front of the card. - - display_description - Determines whether the checkout page displays the payment description. - **true** - The payment description appears. - **false** - The payment description does not appear. false Relevant when `description` is passed in the [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request. - - dynamic_currency_conversion - Determines whether the checkout page displays multiple currency options for a payment. - **true** - Multiple currency options appear. - **false** - Currency options do not appear. false When the customer selects the requested currency, the checkout page displays the following information: - The original amount and currency. - The converted amount in the requested currency. - The exchange rate. Relevant when: - The [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request passes `requested_currency`. - `fixed_side` is **buy**. - One or more payment methods support the values for `currency` and `requested_currency`. - - merchant_color - Reserved. - - merchant_currency_only - In a payment with FX where `fixed_side`=**buy**, determines whether the buyer's currency and the exchange rate appear. One of the following: - **true** - The currency and the exchange rate are hidden. - **false** - The currency and the exchange rate appear. false - - payment_fees_display - Determines whether payment fees appear on the checkout page. - **true** - Payment fees appear when the `payment_fees` object is set in the [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request. - **false** - Payment fees do not appear. true - - required_customer_fields - Indicates the list of fields that the customer has to fill in on the payment page before completing the payment via hosted checkout. Valid values include: - **name**– The customer's full name (default). - **email** – The customer's email address. - **phone_number** – The customer's phone number. - **address** – The address of the customer. - - save_card_default - Determines whether the **save card** checkbox is checked by default. - **true** - The **save card** checkbox is checked. - **false** - The **save card** checkbox is cleared. false Relevant when `customer_id` is passed in the [Create Checkout Page](https://docs.rapyd.net/en/create-checkout-page.md "Create Checkout Page") request. - - customer - ID of the customer. String starting with **cus_**. When used, the customer has the option to save card details for future purchases. This field is for some payment methods and for all **company**-type wallets. - - description - Description of the payment transaction. To display the description, set `display_description` to **true** in `custom_elements`. - - error_payment_url - URL where the customer is redirected when payment is not successful, after returning from an external page, such as a 3DS page. Does not support localhost URLs. - - escrow - Determines whether the payment is held in escrow for later release. - - escrow_release_days - Determines the number of days after creation of the payment that funds are released from escrow. Funds are released at 5:00 pm GMT on the day indicated. Integer, range: 1-90. - - ewallet - ID of the wallet that the money is paid into. String starting with **ewallet_**. Relevant for specifying a single wallet in the request. - - ewallets - Specifies one or more wallets that the money is collected into. - - amount - The amount of the payment to the wallet, in units of the currency defined in `currency`. - - ewallet_id - ID of the wallet. - - percent - The percentage that is paid to the wallet out of the total payment. - - refunded_amount - The total amount refunded against this payment, in units of the currency defined in `currency`. - - expiration - Time when the payment expires if it is not completed, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). When both `expiration` and `payment_expiration` are set, the payment expires at the earlier time. 14 days after creation of the checkout page. - - fixed_side - Indicates whether the FX rate is fixed for the buy side (seller) or for the sell side (buyer). One of the following values: - **buy** - The checkout page shows the currency that the seller (merchant) receives for goods or services. For example, a US-based merchant wants to charge 100 USD. The buyer (customer) pays the amount in MXN that converts to 100 USD. - **sell** - The checkout page shows the currency that the buyer is charged with to purchase goods or services from the seller. For example, a US-based merchant wants to charge a buyer 2,000 MXN and will accept whatever amount in USD that is converted from 2,000 MXN. - - id - ID of the Rapyd checkout page. String starting with **checkout_**. - - language - Determines the default language of the hosted page. For a list of values, see [List Supported Languages](https://docs.rapyd.net/en/list-supported-languages.md "List Supported Languages"). - When this parameter is null, the language of the user's browser is used. - If the language of the user's browser cannot be determined, the default language is English. - - max_payment_retries_attempt - Indicates the number of times Rapyd can attempt to create a payment after an initial failure. - - merchant_alias - Client's name. Rapyd - - merchant_color - Color of the call-to-action (CTA) button on the hosted page. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_customer_support - Contains details of the client’s customer support. To configure these fields, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - email - Email address. - - url - URL for the client's customer support service. - - phone_number - Phone number for contacting the client's customer support service. - - merchant_ewallet - ID of the Rapyd wallet that serves as the merchant's wallet. String starting with **ewallet_**. Restricted to Payment Facilitators (PayFac). See also the 'Create Checkout page with merchant wallet' sample on this page. - - merchant_fields - Object that contains payment method fields that the merchant fills in. Can include one or both of the following: - `payment_method_options` object. - `payment_options` object. The fields of both objects are not displayed to the customer on the hosted page. To retrieve the fields of both objects for a payment method, use [Get Payment Method Required Fields](https://docs.rapyd.net/en/get-payment-method-required-fields.md "Get Payment Method Required Fields"). - - merchant_logo - URL for the image of the client's logo. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_main_button - A string that represents the text on the main Call to Action (CTA) button. One of the following: - **place_your_order** - Place Your Order. - **pay** - Pay. - **pay_now** - Pay Now. - **make_payment** - Make Payment. - **purchase** - Purchase. - **buy** - Buy. - **donate** - Donate. place_your_order To configure this button, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_privacy_policy - URL for the terms and conditions of the agreement between the client and the client’s customers. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_reference_id - Identifier defined by the client for reference purposes. Limit: 45 characters. - - merchant_terms - URL for the client's terms and conditions. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_website - The URL where the customer is redirected after exiting the hosted page. Relevant when one or both of the following fields is unset: - `cancel_url` - `complete_url` To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - - page_expiration - End of the time when the customer can use the hosted page, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). If `page_expiration` is not set, the hosted page expires 14 days after creation. **Range:** 1 minute to 30 days. - - payment - Describes the payment that will result from the hosted page. The `id` and `status` values are null until the customer successfully submits the information on the hosted page. For more information about fields in the 'payment' object, see [Create Payment](https://docs.rapyd.net/en/create-payment.md "Create Payment"). - - payment_expiration - Length of time for the payment to be completed after it is created, measured in seconds. When both `expiration` and `payment_expiration` are set, the payment expires at the earlier time. - - payment_fees - Defines transaction fees and foreign exchange fees. These are fees that the Rapyd merchant can define for its consumers in addition to the payment amount. They are not related to the fees Rapyd charges to its clients. - - transaction_fee - Describes the fee for processing the transaction. - - calc_type - Specifies how the fee is calculated. One of the following: - **net** - The fee is deducted from the amount paid. For example, in a payment of $100 with a fee of 5%, the recipient receives $95.00 and the $5.00 fee goes to the client wallet. - **gross** - The fee is added to the amount paid. For example, for a transaction of $100 with a fee of 5%, the sender pays $105.00. - - fee_type - One of the following: - **percentage** - A percentage of the transaction amount. For example, 5 percent is represented by **value=5**. - **absolute** - A fixed amount. - - value - The amount of the fee. - - fx_fee - Describes the fees for processing the currency exchange. Relevant to payments with FX. - - calc_type - Specifies how the fee is calculated. One of the following: - **net** - The fee is deducted from the amount paid. For example, in a payment of $100 with a fee of 5%, the recipient receives $95.00 and the $5.00 fee goes to the client wallet. - **gross** - The fee is added to the amount paid. For example, for a transaction of $100 with a fee of 5%, the sender pays $105.00. - - value - The amount of the fee. Percentage. - - gross_fees - The total gross fees for the transaction, in units defined by `currency_code`. - - net_fees - The total net fees for the transaction, in units defined by `merchant_requested_currency`. - - total_merchant_fees - The amount of the fee. - - payment_method - Object that describes the payment method. This behavior is different from [Create Payment](https://docs.rapyd.net/en/create-payment.md "Create Payment"). Contains the following fields: - - account_name_inquiry - Data about the account name inquiry (ANI). - - account_name_inquiry_result - Result of the account name inquiry. One of the following values: - **match** - Indicates that the name provided in the request fully matched the issuing bank's records. - **partial match** - Indicates that the name provided in the request partially matched the issuing bank's records. - **no match** - Indicates that the name provided in the request did not match the issuing bank's records. - **not performed** - Indicates that the account name inquiry was not performed. - **not supported** - Indicates that the payment method does not support account name inquiries. - - account_name_inquiry_details - Details of the account name inquiry (ANI). - - first_name - Indicates the result of matching the cardholder's given name. One of the following values: - **match** - Indicates that the first name provided in the request fully matched the first name in the issuing bank's records. - **partial match** - Indicates that the first name provided in the request partially matched the first name in the issuing bank's records. - **no match** - Indicates that first the name provided in the request did not match the first name in the issuing bank's records. - - middle_name - Indicates the result of matching the cardholder's middle name. One of the following values: - **match** - Indicates that the middle name provided in the request fully matched the middle name in the issuing bank's records. - **partial match** - Indicates that the middle name provided in the request partially middle the first name in the issuing bank's records. - **no match** - Indicates that the middle name provided in the request did not match the middle name in the issuing bank's records. - - last_name - Indicates the result of matching the cardholder's family name. One of the following values: - **match** - Indicates that the last name provided in the request fully matched the family name in the issuing bank's records. - **partial match** - Indicates that the last name provided in the request partially matched the family name in the issuing bank's records. - **no match** - Indicates that the last name provided in the request did not match the family name in the issuing bank's records. - - address - Describes the address associated with the payment. Do not use an address ID. - - fields - Contains the fields that are required for the payment method. See [Get Payment Method Required Fields](https://docs.rapyd.net/en/get-payment-method-required-fields.md "Get Payment Method Required Fields"). - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - - name - Name of the payment method. - - type - The type of the payment method. - - payment_method_type - The type of the payment method. For example, **it_visa_card**. To get a list of payment methods for a country, use [List Payment Methods by Country](https://docs.rapyd.net/en/list-payment-methods-by-country.md "List Payment Methods by Country"). See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - payment_method_type_categories - A list of the categories of payment method that are supported on the checkout page. The categories appear on the page in the order provided. One or more of the following: - **bank_redirect** - **bank_transfer** - **card** - **cash** - **ewallet** See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - payment_method_types_exclude - List of payment methods that are excluded from display on the checkout page. See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - payment_method_types_include - List of payment methods that are displayed on the checkout page. The payment methods appear on the page in the order provided. See [Configuring List of Payment Methods](https://docs.rapyd.net/en/configuring-list-of-payment-methods.md "Configuring List of Payment Methods"). - - recurrence_type - Specifies the primary intended purpose of the saved payment method. See [Saving a European Card While Creating a Payment](https://docs.rapyd.net/en/saving-a-european-card-while-creating-a-payment.md "Saving a European Card While Creating a Payment"). One of the following values: - **installment** - Regular payments for a defined number of payment cycles. - **recurring** - Regular payments for an indefinite period. - **unscheduled** - Individual unrelated payments. - - redirect_url - URL of the hosted page that is shown to the customer. - - requested_currency - When `fixed_side` is **sell**, it is the currency received by the merchant. When `fixed_side` is **buy**, it is the currency charged to the buyer (customer). Three-letter ISO 4217 code. The checkout page displays the following information: - The original amount and currency. - The converted amount in the requested currency. - The exchange rate. Relevant to payments with FX. - - require_card_cvv - Require the customer to enter their Card Verification Value (CVV) for each subsequent payment made using a saved card. Relevant to card payments. - **true** - Customer must enter CVV. - **false** - Customer not required to enter CVV. - - statement_descriptor - A text description suitable for a customer's payment statement. 5-22 characters. - - status - Status of the hosted page. One of the following: - **NEW** - The hosted page was created. - **DON** - Done. The payment was completed. - **EXP** - The hosted page expired. - **INP** - Creation of the payment is still in progress. - **DEC** - Rapyd Protect blocked the payment. - - timestamp - Time of creation of the checkout page, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). ### Code Samples - - .NET - ```csharp using System; using System.Text.Json; namespace RapydApiRequestSample { class Program { static void Main(string[] args) { try { var requestObj = new { currency = "USD", customer = "cus_b3b8ad0174f4c415c663b35bcf542192", metadata = new { merchant_defined = true }, amount = 10 }; string request = JsonSerializer.Serialize(requestObj); string result = RapydApiRequestSample.Utilities.MakeRequest("POST", "/v1/checkout", request); Console.WriteLine(result); } catch (Exception e) { Console.WriteLine("Error completing request: " + e.Message); } } } } ``` - - JavaScript - ```javascript const makeRequest = require('/utilities').makeRequest; async function main() { try { const body = { currency: 'USD', customer: 'cus_b3b8ad0174f4c415c663b35bcf542192', metadata: { merchant_defined: true }, amount: 10 }; const result = await makeRequest('POST', '/v1/checkout', body); console.log(result); } catch (error) { console.error('Error completing request', error); } } ``` - - PHP - ```php /utilities.php"; $body = [ "currency" => "USD" "customer" => "cus_b3b8ad0174f4c415c663b35bcf542192", "amount" => 10 ]; try { $object = make_request('post', '/v1/checkout', $body); var_dump($object); } catch(Exception $e) { echo "Error => $e"; } ?> ``` - - Python - ```python from pprint import pprint from utilities import make_request checkout_page = { "amount": 100, "complete_payment_url": "http://example.com/complete", "country": "SG", "currency": "SGD", "customer": "cus_9761efaa881b6edeab25e9fbfec1ddf5", "error_payment_url": "http://example.com/error", "merchant_reference_id": "0912-2021", "language": "en", "metadata": { "merchant_defined": True }, "expiration": 1632027189, "payment_method_types_include": [ "sg_grabpay_ewallet" ] } result = make_request(method='post', path='/v1/checkout', body=checkout_page) pprint(result) ``` - /v1/checkout - Create Checkout Page for customer - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "complete_payment_url": "http://example.com/complete", "country": "SG", "currency": "SGD", "customer": "cus_4e25112ac20e144ad073a614dc46934b", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-02a", "language": "en", "payment_method_types_include": [ "sg_grabpay_ewallet" ], "expiration": 1763027189 }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "f2294735-ac1e-464a-99db-826cd505ea0f" }, "data": { "id": "checkout_d7789dc520318707f9e7ceefbfe2a9f9", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763297303, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_d7789dc520318707f9e7ceefbfe2a9f9", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-02a", "customer_token": "cus_4e25112ac20e144ad073a614dc46934b", "payment_method": null, "payment_method_data": {}, "expiration": 1763027189, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://example.com/complete", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": [ "sg_grabpay_ewallet" ], "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": "cus_4e25112ac20e144ad073a614dc46934b", "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762087704, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page for guest - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 123.45, "complete_payment_url": "http://complete.rapyd.net", "country": "SG", "currency": "SGD", "error_payment_url": "http://example.com/error", "merchant_reference_id": "2025-11-02b", "language": "en", "payment_method_types_include": [ "sg_grabpay_ewallet" ], "expiration": 1763027189 }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "150fc0d3-7ea9-4ac2-91b3-025b52d655b3" }, "data": { "id": "checkout_39d80c11ab793a3f6068761682de1d54", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763297585, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_39d80c11ab793a3f6068761682de1d54", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 123.45, "payment": { "id": null, "amount": 123.45, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-02b", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 1763027189, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://example.com/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": [ "sg_grabpay_ewallet" ], "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762087985, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page using categories - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "complete_payment_url": "http://example.com/complete", "country": "SG", "currency": "SGD", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-02c", "language": "en", "payment_method_type_categories": [ "card", "cash" ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "b76b03dd-4a92-4404-ab74-51262e7114fc" }, "data": { "id": "checkout_5769002d6ec2c73a9bf4798cd032a6df", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763297779, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_5769002d6ec2c73a9bf4798cd032a6df", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-02c", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://example.com/complete", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "card", "cash" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762088179, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with additional fees - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 128.45, "complete_payment_url": "http://example.net/complete", "country": "SG", "currency": "SGD", "error_payment_url": "http://example.net/error", "merchant_reference_id": "2025-11-02e", "language": "en", "requested_currency": "USD", "payment_method_type_categories": [ "card" ], "payment_fees": { "transaction_fee": { "calc_type": "gross", "value": 10, "fee_type": "percentage" }, "fx_fee": { "calc_type": "gross", "value": 2 } } }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "30a47f8e-9c81-475e-bca2-1a4454bfefb7" }, "data": { "id": "checkout_517a50dbc99644ba5cc67a3e7bc716cc", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763297906, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_517a50dbc99644ba5cc67a3e7bc716cc", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "USD", "amount": 110.2, "payment": { "id": null, "amount": 110.2, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-02e", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://example.net/complete", "error_payment_url": "http://example.net/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": 1.305478, "merchant_requested_currency": "SGD", "merchant_requested_amount": 143.86, "fixed_side": "buy", "payment_fees": { "fx_fee": { "value": 2, "calc_type": "gross" }, "net_fees": null, "gross_fees": null, "transaction_fee": { "value": 10, "fee_type": "percentage", "calc_type": "gross" } }, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "card" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762088306, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with Complete and Cancel URLs - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 223.48, "complete_payment_url": "http://complete.rapyd.net", "complete_checkout_url": "http://complete_checkout.rapyd.net", "cancel_checkout_url": "http://cancel_checkout.rapyd.net", "country": "SG", "currency": "SGD", "error_payment_url": "http://example.net/error", "merchant_reference_id": "2025-11-02f", "language": "en", "payment_method_type_categories": [ "card" ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "52393fd1-244b-4c77-84a4-686f23ae1582" }, "data": { "id": "checkout_d94ef891530bdb554bfe631dcfb2a4cd", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763298025, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_d94ef891530bdb554bfe631dcfb2a4cd", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "http://cancel_checkout.rapyd.net", "complete_checkout_url": "http://complete_checkout.rapyd.net", "country": "SG", "currency": "SGD", "amount": 223.48, "payment": { "id": null, "amount": 223.48, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-02f", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://example.net/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "card" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762088425, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with custom elements - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 127.95, "complete_payment_url": "http://example.com/complete", "country": "SG", "currency": "SGD", "error_payment_url": "http://example.com/error", "merchant_reference_id": "2025-11-03a", "language": "en", "custom_elements": { "billing_address_collect": true, "cardholder_name": "John Doe" } }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "c81ff323-ed7b-4779-84ca-519b7c45f0fb" }, "data": { "id": "checkout_a05ca50189e1bc6f483204da547769c8", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763365773, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_a05ca50189e1bc6f483204da547769c8", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 127.95, "payment": { "id": null, "amount": 127.95, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03a", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://example.com/complete", "error_payment_url": "http://example.com/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "cardholder_name": "John Doe", "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": true, "dynamic_currency_conversion": false }, "timestamp": 1762156173, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with cart items - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "SG", "currency": "SGD", "customer": "cus_4e25112ac20e144ad073a614dc46934b", "complete_payment_url": "http://example.com/complete", "error_payment_url": "http://example.com/error", "merchant_reference_id": "2025-11-03b", "language": "en", "expiration": 1771365790, "cart_items": [ { "name": "Bluetooth speaker model SJ-8097", "amount": 120.00, "percent_off": 10, "quantity": 2 }, { "name": "Pack of rechargeable batteries model 90-P", "amount": 5, "amount_off": 1, "quantity": 1 } ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "7ede80f1-173b-41a1-bcf1-b00bac37abe7" }, "data": { "id": "checkout_a829239536a69900b82fc328abae5444", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763365905, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_a829239536a69900b82fc328abae5444", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 220, "payment": { "id": null, "amount": 220, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03b", "customer_token": "cus_4e25112ac20e144ad073a614dc46934b", "payment_method": null, "payment_method_data": {}, "expiration": 1771365790, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://example.com/complete", "error_payment_url": "http://example.com/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": "cus_4e25112ac20e144ad073a614dc46934b", "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762156305, "payment_expiration": null, "cart_items": [ { "name": "Bluetooth speaker model SJ-8097", "amount": 108, "quantity": 2, "image": null, "discount": 12, "percent_off": 10 }, { "name": "Pack of rechargeable batteries model 90-P", "amount": 4, "quantity": 1, "image": null, "discount": 1, "amount_off": 1 } ], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with FX - fixed side buy - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "complete_payment_url": "http://example.com/complete", "country": "SG", "currency": "SGD", "error_payment_url": "http://example.com/error", "merchant_reference_id": "2025-11-03c", "language": "en", "requested_currency": "USD", "fixed_side": "buy" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "25fad7b7-5899-43e8-ab0a-5b44b2b3a210" }, "data": { "id": "checkout_79a999d57f9f5a6dbce4f976ba60397a", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763366000, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_79a999d57f9f5a6dbce4f976ba60397a", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "USD", "amount": 76.6, "payment": { "id": null, "amount": 76.6, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03c", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://example.com/complete", "error_payment_url": "http://example.com/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": 1.305478, "merchant_requested_currency": "SGD", "merchant_requested_amount": 100, "fixed_side": "buy", "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762156400, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with dynamic currency conversion - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 123.45, "complete_payment_url": "http://complete.rapyd.net", "country": "SG", "currency": "SGD", "requested_currency": "USD", "error_payment_url": "http://example.com/error", "merchant_reference_id": "2025-11-03d", "language": "en", "payment_method_type_categories": [ "card" ], "custom_elements": { "dynamic_currency_conversion": true } } ' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "919a0d58-a601-4594-8eda-cb272334c125" }, "data": { "id": "checkout_16e8767d107dec9051bb57962418953d", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763370647, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_16e8767d107dec9051bb57962418953d", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "USD", "amount": 94.56, "payment": { "id": null, "amount": 94.56, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03d", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://example.com/error", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": 1.305478, "merchant_requested_currency": "SGD", "merchant_requested_amount": 123.45, "fixed_side": "buy", "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "card" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": true }, "timestamp": 1762161047, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page using payment method type - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "country": "SG", "currency": "SGD", "customer": "cus_4e25112ac20e144ad073a614dc46934b", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03e", "language": "en", "payment_method_type": "sg_grabpay_ewallet" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "6ae2353a-f27a-4eef-bbcb-0c2cb1bae21f" }, "data": { "id": "checkout_e4f72e9ce370545f45bfb3ee92bf5e12", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763370798, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_e4f72e9ce370545f45bfb3ee92bf5e12", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03e", "customer_token": "cus_4e25112ac20e144ad073a614dc46934b", "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": "sg_grabpay_ewallet", "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": "cus_4e25112ac20e144ad073a614dc46934b", "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762161198, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with 'payment_method_types_exclude' - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "country": "SG", "currency": "SGD", "customer": "cus_4e25112ac20e144ad073a614dc46934b", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03f", "language": "en", "payment_method_types_exclude": [ "sg_grabpay_ewallet" ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "0b78dd82-3ece-4b43-aa94-67128b247754" }, "data": { "id": "checkout_9f73c8ed13c59ecbc56c46903c54252c", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763370986, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_9f73c8ed13c59ecbc56c46903c54252c", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03f", "customer_token": "cus_4e25112ac20e144ad073a614dc46934b", "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": [ "sg_grabpay_ewallet" ], "account_funding_transaction": null, "customer": "cus_4e25112ac20e144ad073a614dc46934b", "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762161386, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with escrow - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 110.45, "country": "AT", "currency": "USD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03g", "payment_method_type": "at_mastercard_card", "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861" } ], "escrow": true, "escrow_release_days": 5 }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "1d04c568-91c4-4c7d-bd2f-33178d9e98f7" }, "data": { "id": "checkout_c9f736c4b6be359e83c37b15de54e259", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763371220, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_c9f736c4b6be359e83c37b15de54e259", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "AT", "currency": "USD", "amount": 110.45, "payment": { "id": null, "amount": 110.45, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "AT", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03g", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "amount": 110.45, "percent": 100 } ], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": "at_mastercard_card", "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762161620, "payment_expiration": null, "cart_items": [], "escrow": true, "escrow_release_days": 5, "require_card_cvv": false } } ``` - Create Checkout Page - authorization only - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 123.45, "country": "BR", "currency": "BRL", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03g", "payment_method_type": "br_credit_mastercard_card", "capture": false }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "bc501af2-5289-4872-ab26-38548e9acee5" }, "data": { "id": "checkout_85530669970c2bb7883ab0f7bf22dbde", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763371437, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_85530669970c2bb7883ab0f7bf22dbde", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "BR", "currency": "BRL", "amount": 123.45, "payment": { "id": null, "amount": 123.45, "original_amount": 0, "is_partial": false, "currency_code": "BRL", "country_code": "BR", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03g", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": "br_credit_mastercard_card", "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762161837, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page split by amount - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 250.52, "country": "AT", "currency": "USD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03h", "payment_method_type": "at_mastercard_card", "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "amount": 200 }, { "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "amount": 50.52 } ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "78331420-f415-48da-9d69-7b55f347aa49" }, "data": { "id": "checkout_dbe8717895d6b8a4ead691ded90ff958", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763371657, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_dbe8717895d6b8a4ead691ded90ff958", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "AT", "currency": "USD", "amount": 250.52, "payment": { "id": null, "amount": 250.52, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "AT", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03h", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "amount": 200, "percent": 79.83 }, { "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "amount": 50.52, "percent": 20.17 } ], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": "at_mastercard_card", "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762162057, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page split by percentage - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 20.25, "country": "AT", "currency": "USD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03i", "payment_method_type": "at_mastercard_card", "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "percentage": 12.05 }, { "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "percentage": 25 }, { "ewallet": "ewallet_31fb2dbbaf6519461ee4fbe1062220d3", "percentage": null } ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "4bae3cff-66cb-44ef-8035-3a26fcc54e8c" }, "data": { "id": "checkout_a2e98fd799a8b62605ab2df8365b31c2", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763371884, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_a2e98fd799a8b62605ab2df8365b31c2", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "AT", "currency": "USD", "amount": 20.25, "payment": { "id": null, "amount": 20.25, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "AT", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03i", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "amount": 2.44, "percent": 12.05 }, { "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "amount": 5.06, "percent": 25 }, { "ewallet": "ewallet_31fb2dbbaf6519461ee4fbe1062220d3", "amount": 12.75, "percent": 62.96 } ], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": "at_mastercard_card", "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762162284, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with FX - fixed side sell - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "country": "SG", "currency": "SGD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03j", "language": "en", "requested_currency": "USD", "fixed_side": "sell" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "38c13c4d-8182-44e9-9524-82539b3063d9" }, "data": { "id": "checkout_e44b35d35e34a3e56d26f935f856ad4f", "status": "NEW", "language": "en", "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763372015, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_e44b35d35e34a3e56d26f935f856ad4f", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100.25, "payment": { "id": null, "amount": 100.25, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03j", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": 0.716276, "merchant_requested_currency": "USD", "merchant_requested_amount": 71.81, "fixed_side": "sell", "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762162415, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with page expiration - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100.25, "country": "SG", "currency": "SGD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03j", "page_expiration": 1772027189 }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "7ce9717b-b270-445b-884a-0e138e185edb" }, "data": { "id": "checkout_64355611c317dc66119a64baa663d696", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1764754538, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_64355611c317dc66119a64baa663d696", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100.25, "payment": { "id": null, "amount": 100.25, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03j", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762162538, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with payment expiration - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100.52, "country": "SG", "currency": "SGD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03m", "payment_expiration": 604800 }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "244417f9-324e-4eb1-a78e-ad84888c2a6d" }, "data": { "id": "checkout_a42dc66075b0d5796cc52f71d3a7d82d", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763372314, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_a42dc66075b0d5796cc52f71d3a7d82d", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100.52, "payment": { "id": null, "amount": 100.52, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03m", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762162714, "payment_expiration": 604800, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page - Card with requested currency - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100.52, "country": "SG", "currency": "SGD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03n", "payment_expiration": 604800, "requested_currency": "USD", "payment_method_type_categories": [ "card" ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "dd2bfa42-ab8f-43d2-aede-d050d1912dd9" }, "data": { "id": "checkout_1b431a179ab25869962c84789aa93cb4", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763374992, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_1b431a179ab25869962c84789aa93cb4", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "USD", "amount": 77, "payment": { "id": null, "amount": 77, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03n", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": 1.305478, "merchant_requested_currency": "SGD", "merchant_requested_amount": 100.52, "fixed_side": "buy", "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "card" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762165392, "payment_expiration": 604800, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page - Card with requested currency and fees - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100.52, "country": "SG", "currency": "SGD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03o", "requested_currency": "USD", "payment_method_type_categories": [ "card" ], "payment_fees": { "transaction_fee": { "calc_type": "gross", "value": 10, "fee_type": "percentage" }, "fx_fee": { "calc_type": "gross", "value": 2 } } }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "f3a36bfc-7717-4d42-8772-4b41ea8748d3" }, "data": { "id": "checkout_bdaebfabc7bdd6a26ed9f105505e3487", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763375094, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_bdaebfabc7bdd6a26ed9f105505e3487", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "USD", "amount": 86.24, "payment": { "id": null, "amount": 86.24, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03o", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": 1.305478, "merchant_requested_currency": "SGD", "merchant_requested_amount": 112.58, "fixed_side": "buy", "payment_fees": { "fx_fee": { "value": 2, "calc_type": "gross" }, "net_fees": null, "gross_fees": null, "transaction_fee": { "value": 10, "fee_type": "percentage", "calc_type": "gross" } }, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "card" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762165494, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with multiple payment method categories - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100.52, "country": "SG", "currency": "SGD", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-03p", "payment_method_type_categories": [ "cash", "card", "ewallet" ] }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "c72f0c87-f9b4-4e3f-9188-449be1e24c5e" }, "data": { "id": "checkout_8e9f60d44b3d07331b0916d29da40333", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763375187, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_8e9f60d44b3d07331b0916d29da40333", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "SG", "currency": "SGD", "amount": 100.52, "payment": { "id": null, "amount": 100.52, "original_amount": 0, "is_partial": false, "currency_code": "SGD", "country_code": "SG", "status": null, "description": "Payment via Checkout", "merchant_reference_id": "2025-11-03p", "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": [ "cash", "card", "ewallet" ], "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762165587, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with merchant fields - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "currency": "GBP", "country": "GB", "merchant_fields_": { "gb_visa_card": { "required_fields": { "recurrence_type": "recurring" }, "payment_method_options": { "3d_required": true } } } }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "3a246d15-06df-4f39-8e0f-d530164b43d5" }, "data": { "id": "checkout_9c4e9f33612c7f6c3c2d4cd6c49bd059", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1769951743, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_9c4e9f33612c7f6c3c2d4cd6c49bd059", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "GB", "currency": "GBP", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "GBP", "country_code": "GB", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": null, "error_payment_url": null, "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1768742143, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page - Account Funding Transaction - 'person' wallet - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "AT", "currency": "EUR", "amount": "100", "account_funding_transaction": { "ewallet": "ewallet_d2ab10025f4da04a5442ea264fd98f53", "payment_method_types": ["at_mastercard_card"] } }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "cdee23c4-6a06-45b9-a1e5-28e30a78ae89" }, "data": { "id": "checkout_b8f18ef475ad1934d896770b0fb85c65", "status": "NEW", "language": null, "merchant_color": "e8dcff", "merchant_logo": "https://iconslib.rapyd.net/merchant-logos/ohpc_8df12e51102d26bdc7e2321201120.jpg", "merchant_website": "https://rapyd.net", "merchant_customer_support": { "url": "https://www.rapyd.com", "email": "johndoe@rapyd.net", "phone_number": "55555555555" }, "merchant_alias": "rapyd", "merchant_terms": "https://www.termsfeed.com/terms-conditions-generator/", "merchant_privacy_policy": "https://www.privacypolicies.com/blog/privacy-policy-template/", "page_expiration": 1668597423, "redirect_url": "https://sboxcheckout.rapyd.net?token=checkout_b8f18ef475ad1934d896770b0fb85c65", "merchant_main_button": "place_your_order", "cancel_checkout_url": "https://rapyd.net", "complete_checkout_url": "https://rapyd.net", "country": "AT", "currency": "EUR", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "EUR", "country_code": "AT", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": null, "error_payment_url": null, "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": "customer_present", "mid": null, "next_action": "not_applicable" }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": { "ewallet": "ewallet_d2ab10025f4da04a5442ea264fd98f53", "payment_method_types": ["at_mastercard_card"] }, "customer": null, "custom_elements": { "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1667387823, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null } } ``` - Create Checkout Page - Required Customer Fields - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "GB", "currency": "GBP", "amount": "10.25", "custom_elements": { "required_customer_fields": [ "name", "email", "phone_number", "address" ] } }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "dcfb8330-eea5-453a-872d-35c8fb3a0251" }, "data": { "id": "checkout_66541ff67fa6f51248d11c8eb0f07c0e", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763377700, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_66541ff67fa6f51248d11c8eb0f07c0e", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "GB", "currency": "GBP", "amount": 10.25, "payment": { "id": null, "amount": 10.25, "original_amount": 0, "is_partial": false, "currency_code": "GBP", "country_code": "GB", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": null, "error_payment_url": null, "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "required_customer_fields": [ "name", "email", "phone_number", "address" ], "dynamic_currency_conversion": false }, "timestamp": 1762168100, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page - Payment Method Required Fields - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "IS", "amount": 100.25, "payment_method": { "type": "is_visa_card", "fields": { "number": "4111111111111111", "expiration_month": "12", "expiration_year": "30", "cvv": "566", "name": "John Doe" } }, "currency": "EUR", "payment_method_options": { "3d_required": true }, "payment_method_required_fields": { "is_visa_card": { "payment_method_options": [ "cvv" ] } }, "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "capture": false, "expiration": 1779859548, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "a7b39c1e-be3d-4c6b-af27-442dbe90c35c" }, "data": { "id": "checkout_1aa99cf3cc0d9da5531f1f5093c9c2f2", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763377954, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_1aa99cf3cc0d9da5531f1f5093c9c2f2", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "IS", "currency": "EUR", "amount": 100.25, "payment": { "id": null, "amount": 100.25, "original_amount": 0, "is_partial": false, "currency_code": "EUR", "country_code": "IS", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": { "type": "is_visa_card", "fields": { "cvv": "566", "name": "John Doe", "number": "4111111111111111", "expiration_year": "30", "expiration_month": "12" } }, "payment_method_data": {}, "expiration": 1779859548, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "amount": 100.25, "percent": 100 } ], "payment_method_options": { "3d_required": true }, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762168354, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page - Recurring payments - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 10, "currency": "GBP", "country": "GB", "recurrence_type":"recurring", "customer":"cus_4e25112ac20e144ad073a614dc46934b", "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "e759331a-fff0-4da6-b80b-cc390acafc72" }, "data": { "id": "checkout_a69c1e1ecac83474d37fd60a04c41736", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763379591, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_a69c1e1ecac83474d37fd60a04c41736", "merchant_main_button": "place_your_order", "recurrence_type": "recurring", "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "GB", "currency": "GBP", "amount": 10, "payment": { "id": null, "amount": 10, "original_amount": 0, "is_partial": false, "currency_code": "GBP", "country_code": "GB", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": "cus_4e25112ac20e144ad073a614dc46934b", "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": "cus_4e25112ac20e144ad073a614dc46934b", "custom_elements": { "hide_save_card": true, "save_card_default": true, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762169991, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page - CVV of card required on subsequent payments - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "GB", "currency": "GBP", "amount": "10.25", "customer": "cus_4e25112ac20e144ad073a614dc46934b", "require_card_cvv": true }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "839cd24f-b850-4881-ba6b-12f3983e40ff" }, "data": { "id": "checkout_c1fed5a2746f20da567910b7c535e03e", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763379715, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_c1fed5a2746f20da567910b7c535e03e", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "GB", "currency": "GBP", "amount": 10.25, "payment": { "id": null, "amount": 10.25, "original_amount": 0, "is_partial": false, "currency_code": "GBP", "country_code": "GB", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": "cus_4e25112ac20e144ad073a614dc46934b", "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": null, "error_payment_url": null, "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": "cus_4e25112ac20e144ad073a614dc46934b", "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762170115, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": true } } ``` - Create Checkout Page - 3DS Required - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "IS", "amount": 101.25, "payment_method": { "type": "is_visa_card", "fields": { "number": "4111111111111111", "expiration_month": "12", "expiration_year": "30", "cvv": "566", "name": "John Doe" } }, "currency": "EUR", "payment_method_options": { "3d_required": true }, "payment_method_required_fields": { "is_visa_card": { "payment_method_options": [ "cvv" ] } }, "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "capture": false, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net" } ' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "5c3db4aa-7642-42e9-a102-8ab3ce8e5ded" }, "data": { "id": "checkout_b293cd10889ad6ee674a9f46963aa7fa", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763379857, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_b293cd10889ad6ee674a9f46963aa7fa", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "IS", "currency": "EUR", "amount": 101.25, "payment": { "id": null, "amount": 101.25, "original_amount": 0, "is_partial": false, "currency_code": "EUR", "country_code": "IS", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": { "type": "is_visa_card", "fields": { "cvv": "566", "name": "John Doe", "number": "4111111111111111", "expiration_year": "30", "expiration_month": "12" } }, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallets": [ { "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861", "amount": 101.25, "percent": 100 } ], "payment_method_options": { "3d_required": true }, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762170257, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with Customer Object - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100.25, "country": "GB", "currency": "EUR", "customer": { "name": "John Doe" }, "custom_elements": { "save_card_default": true }, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "3df50999-7b7c-4dc5-9635-d7a8f24f764b" }, "data": { "id": "checkout_a4c83355ba1f2798e098161bb7305635", "status": "NEW", "language": null, "merchant_color": "323fff", "merchant_logo": null, "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1763379978, "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_a4c83355ba1f2798e098161bb7305635", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://example1234.net", "complete_checkout_url": "https://example1234.net", "country": "GB", "currency": "EUR", "amount": 100.25, "payment": { "id": null, "amount": 100.25, "original_amount": 0, "is_partial": false, "currency_code": "EUR", "country_code": "GB", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": "cus_109cc70db11d9d64ab1e5e2523f0790c", "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "http://complete.rapyd.net", "error_payment_url": "http://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": "cus_109cc70db11d9d64ab1e5e2523f0790c", "custom_elements": { "hide_save_card": false, "save_card_default": true, "display_description": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1762170378, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page for AFT - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 50, "country": "AT", "currency": "USD", "account_funding_transaction": { "purpose_code": "family_support" }, "complete_payment_url": "https://complete.rapyd.net", "error_payment_url": "https://error.rapyd.net" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "737f129a-ba39-42c1-8d8f-3c50152eae15" }, "data": { "id": "checkout_7b62c5ccdc886b2594becd04137ac3d4", "status": "NEW", "language": null, "merchant_color": null, "merchant_logo": null, "merchant_website": "https://www.rapyd.net/", "merchant_customer_support": {}, "merchant_alias": "Four Star Limousines", "merchant_terms": null, "merchant_privacy_policy": null, "page_expiration": 1771236952, "redirect_url": "https://checkout.rapyd.net/?token=checkout_7b62c5ccdc886b2594becd04137ac3d4", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://cancel.rapyd.net/", "complete_checkout_url": "https://complete.rapyd.net/", "country": "AT", "currency": "USD", "amount": 50, "payment": { "id": null, "amount": 50, "original_amount": 0, "is_partial": false, "currency_code": "USD", "country_code": "AT", "status": null, "description": "AFT Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": "https://complete.rapyd.net", "error_payment_url": "https://error.rapyd.net", "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": null }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": { "purpose_code": "family_support" }, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "hide_digital_wallets": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1770027352, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false } } ``` - Create Checkout Page with merchant wallet - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "country": "IS", "currency": "ISK", "amount": 100, "merchant_ewallet": "ewallet_8a5077a7d3b4778c73393b7171566ced" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "56b3c8f5-e190-4d8f-84b5-d06f4e6f1347" }, "data": { "id": "checkout_abf2f165afa5a5df11f7333bf70d4d54", "status": "NEW", "language": null, "merchant_color": null, "merchant_logo": null, "merchant_website": "https://www.rapyd.net/", "merchant_customer_support": {}, "merchant_alias": "aft business", "merchant_terms": null, "merchant_privacy_policy": null, "page_expiration": 1782371061, "redirect_url": "https://qacheckout.rapyd.net/?token=checkout_abf2f165afa5a5df11f7333bf70d4d54", "merchant_main_button": "place_your_order", "recurrence_type": null, "cancel_checkout_url": "https://www.rapyd.net/", "complete_checkout_url": "https://www.rapyd.net/", "country": "IS", "currency": "ISK", "amount": 100, "payment": { "id": null, "amount": 100, "original_amount": 0, "is_partial": false, "currency_code": "ISK", "country_code": "IS", "status": null, "description": "Payment via Checkout", "merchant_reference_id": null, "customer_token": null, "payment_method": null, "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": null, "redirect_url": null, "complete_payment_url": null, "error_payment_url": null, "receipt_number": null, "flow_type": null, "address": null, "statement_descriptor": null, "transaction_id": null, "created_at": 0, "updated_at": 0, "metadata": null, "failure_code": null, "failure_message": null, "paid": false, "paid_at": 0, "dispute": null, "refunds": null, "order": null, "outcome": null, "visual_codes": {}, "textual_codes": {}, "instructions": {}, "ewallet_id": null, "ewallets": [], "payment_method_options": {}, "payment_method_type": null, "payment_method_type_category": null, "fx_rate": null, "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": null, "payment_fees": null, "invoice": null, "escrow": null, "group_payment": null, "cancel_reason": null, "initiation_type": null, "mid": null, "next_action": "not_applicable", "merchant_ewallet": "ewallet_8a5077a7d3b4778c73393b7171566ced" }, "payment_method_type": null, "payment_method_type_categories": null, "payment_method_types_include": null, "payment_method_types_exclude": null, "account_funding_transaction": null, "customer": null, "custom_elements": { "hide_save_card": false, "save_card_default": false, "display_description": false, "hide_digital_wallets": false, "payment_fees_display": true, "merchant_currency_only": false, "billing_address_collect": false, "dynamic_currency_conversion": false }, "timestamp": 1781161462, "payment_expiration": null, "cart_items": [], "escrow": null, "escrow_release_days": null, "require_card_cvv": false, "max_payment_retries_attempt": 5 } } ``` - Bad Request - Invalid Currency - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 1, "country": "GB", "currency": "EURR", "complete_payment_url": "http://example123.com/complete", "customer": { "name": "John Doe" }, "custom_elements": { "save_card_default": true }, "error_payment_url": "http://example123.com/error" }' ``` - ```json { "status": { "error_code": "ERROR_HOSTED_PAGE_INVALID_CURRENCY", "status": "ERROR", "message": "The request attempted an operation that requires a currency, but the value was missing or not recognized. The request was rejected. Corrective action: Use the correct 3-letter ISO 4217 code for the currency in uppercase letters.", "response_code": "ERROR_HOSTED_PAGE_INVALID_CURRENCY", "operation_id": "cafe5cb6-b6e1-467b-afa3-2c4d93caa94a" } } ``` - Bad Request - Included Payment Method Type not Valid - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/checkout' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "amount": 100, "complete_payment_url": "http://example.com/complete", "country": "SG", "currency": "SGD", "customer": "cus_4e25112ac20e144ad073a614dc46934b", "error_payment_url": "http://error.rapyd.net", "merchant_reference_id": "2025-11-02a", "language": "en", "payment_method_types_include": [ "sgg_grabpay_ewallet" ], "expiration": 1763027189 }' ``` - ```json { "status": { "error_code": "ERROR_HOSTED_PAGE_UNRECOGNIZED_PAYMENT_METHOD_TYPES_TO_INCLUDE - ['sgg_grabpay_ewallet']", "status": "ERROR", "message": "The request tried to create a checkout page, but these payment method types in 'payment_method_types_include' were not recognized. The request was rejected. Corrective action: Specify payment method types that are valid for the country. Use 'List Payment Methods by Country'.", "response_code": "ERROR_HOSTED_PAGE_UNRECOGNIZED_PAYMENT_METHOD_TYPES_TO_INCLUDE - ['sgg_grabpay_ewallet']", "operation_id": "3bfe6e86-3484-4dd6-821f-cb8806a1d7d5" } } ``` ### Related Information - [Hosted Checkout Page Integration](https://docs.rapyd.net/en/hosted-checkout-page-integration.md "Hosted Checkout Page Integration")