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. The 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.
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.
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), bad requests (400), and an unauthorized request (401). For a list of all error messages that appear due to bad requests, see Checkout Errors and General Errors.

Parameters

Request Header Parameters

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

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.

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.

country
The two-letter ISO 3166-1 ALPHA-2 code for the country.
To determine the code for a country, see 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 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 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 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 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.

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

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

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.
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. See 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.

payment_method_types_exclude
List of payment methods that are excluded from display on the checkout page.
See 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.

recurrence_type
Specifies the primary intended purpose of the saved payment method. See 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.

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.
- 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 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.
- 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 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 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 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 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. 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.
  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.
- 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.
- merchant_customer_support
- Contains details of the client’s customer support. To configure these fields, use the Client Portal. See 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_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.
- merchant_logo
- URL for the image of the client's logo.
  To configure this field, use the Client Portal. See 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.
- 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.
- 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.
- 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.
- metadata
- A JSON object defined by the client. See Metadata.
- page_expiration
- End of the time when the customer can use the hosted page, in 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.
- 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. 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.
  metadata
  A JSON object defined by the client. See 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. See 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.
- payment_method_types_exclude
- List of payment methods that are excluded from display on the checkout page.
  See 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.
- recurrence_type
- Specifies the primary intended purpose of the saved payment method. See 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.

Code Samples

.NET

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

const makeRequest = require('<path-to-your-utility-file>/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
$path .= "/<path-to-your-utility-file>/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

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 -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
}'

{
    "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 -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
}'

{
    "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 -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"
    ]
}'

{
    "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 -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
        }
    }
}'

{
    "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 -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"
    ]
}'

{
    "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 -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"
    }
}'

{
    "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 -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
        }
    ]
}'

{
    "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 -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"
}'

{
    "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 -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
    }
}
'

{
    "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 -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"
}'

{
    "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 -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"
    ]
}'

{
    "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 -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
}'

{
    "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 -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
}'

{
    "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 -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
        }
    ]
}'

{
    "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 -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
        }
    ]
}'

{
    "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 -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"
}'

{
    "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 -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
}'

{
    "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 -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
}'

{
    "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 -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"
    ]
}'

{
    "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 -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
        }
    }
}'

{
    "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 -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"
    ]
}'

{
    "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 -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'
-d '{
    "amount": 10,
    "currency": "COP",
    "country": "CO",
    "merchant_fields": {
        "co_cash_cash": {
            "required_fields": {
                "tax": 7,
                "documentnumber": "654987575"
            },
            "payment_method_options": {}
        }
    }
}'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "38d78b3f-fa37-46a2-84e8-e195c57fcb28"
    },
    "data": {
        "id": "checkout_57b1366b899d01f02964874512ba555a",
        "status": "NEW",
        "language": null,
        "merchant_color": "e8dcff",
        "merchant_logo": "https://iconslib.rapyd.net/merchant-logos/ohpc_bc12.png",
        "merchant_website": "https://rapyd.net",
        "merchant_customer_support": {
            "url": "https://rapyd.net",
            "email": "johndoe@rapyd.net",
            "phone_number": "555555555"
        },
        "merchant_alias": "Rapyd",
        "merchant_terms": "https://rapyd.net",
        "merchant_privacy_policy": "https://rapyd.net",
        "page_expiration": 1668606927,
        "redirect_url": "https://checkout.rapyd.net?token=checkout_57b1366b899d01f02964874512ba555a",
        "merchant_main_button": "place_your_order",
        "cancel_checkout_url": "https://rapyd.net",
        "complete_checkout_url": "https://rapyd.net",
        "country": "CO",
        "currency": "COP",
        "amount": 10,
        "payment": {
            "id": null,
            "amount": 10,
            "original_amount": 0,
            "is_partial": false,
            "currency_code": "COP",
            "country_code": "CO",
            "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": null,
        "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": 1667397328,
        "payment_expiration": null,
        "cart_items": [],
        "escrow": null,
        "escrow_release_days": null
    }
}

Create Checkout Page - Account Funding Transaction - 'person' wallet

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'
-d '{
    "country": "AT",
    "currency": "EUR",
    "amount": "100",
    "account_funding_transaction": {
        "ewallet": "ewallet_d2ab10025f4da04a5442ea264fd98f53",
        "payment_method_types": ["at_mastercard_card"]
    }
}'

{
    "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 -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"
        ]
    }
}'

{
    "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 -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"
}'

{
    "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 -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"
}'

{
    "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 -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
}'

{
    "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 -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"
}
'

{
    "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 -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"
}'

{
    "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
    }
}

Bad Request - Invalid Currency

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"

}'

{
    "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 -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
}'

{
    "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"
    }
}

Unauthorized

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": "EUR",
    "complete_payment_url": "http://example123.com/complete",
    "customer": {
        "name": "John Doe"
    },
    "custom_elements": {
    "save_card_default": true
    },
    "error_payment_url": "http://example123.com/error"

}
'

{
    "status": {
        "error_code": "UNAUTHENTICATED_API_CALL",
        "status": "ERROR",
        "message": "The request was rejected due to an authentication issue. Corrective action: Check the status of your account in the 'Account Details' page of the Client Portal.",
        "response_code": "UNAUTHENTICATED_API_CALL",
        "operation_id": "034ff9bc-e27c-405b-8f8d-437becbc2358"
    }
}

Related Information

Hosted Checkout Page Integration

In this section:

Documentation

Create Checkout Page

Note

Parameters

Request Header Parameters

Request Body Parameters

Note

Note

Note

Note

Response Parameters

Note

Code Samples

Related Information

Search results