Step 1: Create Your Checkout Experience

Log into the Rapyd Client Portal and start building your own checkout experience. Add your own colors, logo, and select all the payment methods that you would like to accept.

Customize Your Checkout Page

Checkout enables you to customize the look and feel to match your brand and website experience.

Once you create a Rapyd account, sign in to the Client Portal as described in Accessing the Client Portal and navigate to Settings > Branding.

The Checkout Page appears.
Tap the first icon on the toolbar and upload an image file (png, jpg, jpeg, gif) containing your company logo.
Tap the color icon to select the color of the buttons on the display.
In the Fallback URL field, enter the URL of the page that appears when the checkout process is completed or canceled and no specific URLs are provided for complete_checkout_url or cancel_checkout_url when you generate your Checkout page.

Note: Other Hosted pages may have different fields such as complete_url and cancel_url( e.g. Beneficiary Tokenization Page, Rapyd Verify Hosted Page, Hosted IDV Page, and Hosted Page Card Token Object).

Tap the wallet icon to select only the Payment Methods that you want to appear on your Checkout Page (Hosted Checkout only).

Choose your call to action (CTA) main text (Hosted Checkout only).
Add your customer support details including your privacy policy and terms & conditions. (optional).

Your customized Checkout Page appears in the Preview panel.
Tap Save.

Refer to Customizing Your Hosted Page for a detailed guide.

Step 2: Generate Your Checkout Page

To generate your Rapyd Checkout page, use the Create Checkout Page method.

Before you send your first API request to the Rapyd platform, you need to set up your Authentication Headers including your Request Signatures, and then send a HTTPS POST Request to Rapyd which will generate the Rapyd Checkout page.

Note: See Make Your First API Call to set this up if you haven’t yet done so.

Once your Headers and Signature setup is complete, request the Checkout Body. The following three required parameters are required for creating a checkout page:

Amount
Country
Currency

The example below shows a list of required and optional parameters used in the body of a Create Checkout Page request. The request should contain at least the three required parameters mentioned above:

Parameter	Description
amount (required)	The amount of the payment, in units of the currency defined in currency. Decimal.
country (required)	The two-letter ISO 3166-1 ALPHA-2 code for the country. Uppercase.
currency (required)	Three-letter ISO 4217 code for the currency used in the amount field. Uppercase.
complete_checkout_url	URL where the customer is redirected when checkout is successful. This page can be set dynamically for each generated checkout page as it overrides the fallback URL that was set in the Client Portal.
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.
payment_method_types_include	List of payment methods that are displayed on the checkout page.
merchant_reference_id	Identifier for the transaction. Defined by the merchant. Can be used for reconciliation.
requested_currency	Determines the currency that the customer will use to pay, when it is different from the currency that the merchant wants to receive. Three-letter ISO 4217 code. When this field is set, the checkout page displays the following information: - Original amount and currency. - The converted amount in the requested currency. - The exchange rate.

Note: For a description of all the parameters, see Checkout Page Object.

📘
Third Party Payment Flow
When the payment_flow_type of the payment method/s that you provide to your customers is a third party redirect, make sure to provide URLs in the complete_payment_url and error_payment_url parameters.
The customer will be redirected to these URLs after completing a payment.
To determine the payment_flow_type, see List Payment Methods by Country

Example of a Request Body

Refer to Code Samples for more information.

// Request URL: POST https://sandboxapi.rapyd.net/v1/checkout
// Message body:
{
    "amount": 100,
    "country": "SG",
    "currency": "SGD",
    "requested_currency": "USD",
    "complete_checkout_url": "https://example.com/complete",
    "cancel_checkout_url":"https://example.com/cancel"
    "merchant_reference_id": "950ae8c6-76",
    "payment_method_types_include": [
        "sg_credit_mastercard_card",
        "sg_credit_visa_card"   
     ]
}

using System;
 using System.Text.Json;

 namespace RapydApiRequestSample
 {
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                string[] payment_method_types_include = new string[] { "sg_credit_mastercard_card", "sg_credit_visa_card" };

                var requestObj = new
                {
                    amount = 100,
                    complete_checkout_url = "http://example.com/complete",
                    country = "SG",
                    currency = "SGD",
             requested_currency = “USD”,
                    merchant_reference_id = "950ae8c6-76",
                    payment_method_types_include
                };

                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);
            }
        }
    }
 }

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const body = {
      amount: 100,
      complete_checkout_url: 'http://example.com/complete',
      country: ‘SG’,
      currency: 'SGD',
      requested_currency: ‘USD’,
      merchant_reference_id: '950ae8c6-76',
      payment_method_types_include: [‘sg_credit_mastercard_card’, ‘sg_credit_visa_card’]
    };
    const result = await makeRequest('POST', '/v1/checkout', body);

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

$body = [
    "amount" => 100,
    "complete_checkout_url" => "http://example.com/complete",
    "country" => "SG",
    "currency" => "SGD",
    “requested_currency” => “USD”,
    "merchant_reference_id" => "950ae8c6-76",
    "payment_method_types_include" => [
       "sg_credit_mastercard_card", 
       "sg_credit_visa_card"
    ]
];

try {
    $object = make_request('post', '/v1/checkout', $body);
    var_dump($object);
} catch (Exception $e) {
    echo "Error: $e";
}
?>

from pprint import pprint

from utilities import make_request

checkout_page = {
    "amount": 100,
    "complete_checkout_url": "http://example.com/complete",
    "country": "SG",
    "currency": "SGD",
    “requested_currency”: “USD”,
    "merchant_reference_id": "950ae8c6-76",
    "payment_method_types_include": [
        "sg_credit_mastercard_card", 
        "sg_credit_visa_card"
    ]
}

results = make_request(method="post",
                       path="/v1/checkout",
                       body=checkout_page)
pprint(results)

You can include the customer ID starting with cus_ and save_card_default to include a filled "save card" checkbox as described in Create Checkout Page.

📘
Pre-Fill Checkout Fields
You can pre-fill, or exempt select checkout fields by including them in the merchant_fields object in your API request. The fields will not appear on the hosted page.

The sample list below shows the body of the response which contains the following fields as described in Create Checkout Page:

Fields	Description
id	ID of the Rapyd Checkout page.
amount	The amount of the payment, in units of the currency defined in currency.
country	The two-letter ISO 3166-1 ALPHA-2 code for the country.
currency	Three-letter ISO 4217 code for the currency used in the amount field.
customer	ID of the 'customer' object. String starting with cus_. Relevant when the customer is already signed up and stored on the Rapyd platform.
merchant_website	URL of the merchant’s website, provided by the merchant. Relevant when `cancel_checkout_url` or `complete_checkout_url` are unset. Configured in the Client Portal when setting the Fallback URL field as described in Customizing Your Hosted Page.
merchant_logo	URL of the merchant’s logo, provided by the merchant.
redirect_url	URL of the redirect for the Rapyd Checkout page, provided by Rapyd.

The response also shows the entire payment object, which has been edited out, except for the complete_payment_url and the error_payment_url.

Example of a Response Body

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "c343cac1-d682-4983-a386-345aa75d9aaf"
    },
    "data": {
        "id": "checkout_e6a30340c23be7201346eade2bfe3417",
        "country": "SG",
        "currency": "SGD",
        "amount": 100,
        "status": "NEW",
        "payment": {
            "id": "",
            "amount": 100,
            "original_amount": 0,
            "is_partial": false,
            "currency_code": "SGD",
            "country_code": "SG",

//          ...
             
            "merchant_reference_id": "950ae8c6-76",

//          ...
             "merchant_requested_currency": "USD",

//          ...
        },
       "payment_method_type": "",
       "payment_method_type_categories": null,
       "payment_method_types_include": [
        "sg_credit_mastercard_card",
        "sg_credit_visa_card"   
         ],
      
//          ...
       "payment_method_types_exclude": null,
        "customer": "",
        "customer_default_payment_method": {},
        "country_name": "Singapore",
        "merchant_color": "5387e6",
        "merchant_website": "https://www.rapyd.net/",
        "merchant_logo": "https://sboxiconslib.rapyd.net/merchant-logos/ohpc_04e7f6ae2362818fb6eb723b821824ad.jpg",
        "merchant_customer_support": {},
       //          ...
        "language": "en",
        "complete_checkout_url": "http://example.com/complete",
        "cancel_checkout_url": "",
        "redirect_url": "https://sandboxcheckout.rapyd.net?token=checkout_e6a30340c23be7201346eade2bfe3417",
        "timestamp": 1592143929,
        "expiration": 1593353529
    }
}

Step 3: Redirect Your Customer

Redirect your customer to the URL you received in the response to Create Checkout Page. The redirect URL appears in the redirect_url field and includes all the parameters for the Checkout session.

Note: The checkout page expires 14 days after creation by default.

Alternatively, you may specify a page_expiration parameter in the Create Checkout Page request and choose a different value for the expiration of the Checkout page, in Unix time.

Rapyd Docs and API Reference

Rapyd Documentation and API Reference

Hosted Checkout Page Integration

Step 1: Create Your Checkout Experience

Customize Your Checkout Page

Step 2: Generate Your Checkout Page

📘
Third Party Payment Flow

Example of a Request Body

📘
Pre-Fill Checkout Fields

Example of a Response Body

Step 3: Redirect Your Customer

What's Next

Hosted Checkout Page Integration

Suggested Edits are limited on API Reference Pages

Step 1: Create Your Checkout Experience

Customize Your Checkout Page

Step 2: Generate Your Checkout Page

📘Third Party Payment Flow

Example of a Request Body

📘Pre-Fill Checkout Fields

Example of a Response Body

Step 3: Redirect Your Customer

What's Next

📘
Third Party Payment Flow

📘
Pre-Fill Checkout Fields