Payment Page

With Solidgate Payment Page, you can create a payment page and share a URL to it with your customers or embed it on your website.

Payment Page supports payments via credit and debit cards, PayPal, Apple Pay, and Google Pay.

It is important to note that the list of currencies available for PayPal is limited.

In addition, the payment page is translated into five languages and automatically matches your customer’s preferred browser language. We will enable language selection directly on the payment page if we have defined a language other than English. 

Payment Page URL Generation

To get an URL to the payment page, you need to follow these steps:

1. Create the request body.
2. Generate the Signature from the JSON body.
3. Add the Merchant and Signature to the header of Request.
4. Make a POST request with the Headers & Body.

A detailed description of each step is described below.

You can use our postman collection to generate a Payment Page link. You only need to pass the mandatory fields and your channel data.

Create the request body

The body includes two objects: order information and page customization. The mandatory body parameters are described in the following table.

Additionally, in the HUB Public Information section you can define Channel Logo (JPEG, PNG, GIF up to 1024 kb). 

You can also pass more order or/and page customization information, but these parameters are optional. The list of optional body parameters is described in the table below.

Generate the Signature from the JSON body

The signature allows verifying whether the request is genuine on the Solidgate server. The signature is generated from the JSON body on your Backend.

The detailed process of generating the Solid Payment Form initialization signature is presented in the following article.

To authenticate to Solidgate API, you should add the following headers to each request:

• Merchant - public_key of your channel keys;
• Signature - that you receive in the previous step.

To display PayPal on the payment page, you need to use API keys with “All” type. For more information about credential types, contact your Account manager.

Make a POST request with the Headers & Body

To get a Payment Page URL, you need to make a POST request with the headers and body JSON to the Solidgate endpoint: https://payment-page.solidgate.com/api/v1/init

An example of a request with a minimum set of parameters to get a Payment Page URL is below.

{ 
   "order": { 
        "currency": "EUR", 
        "amount": 1690, 
        "order_id": "135udhyu5-3h", 
        "order_description": "order_description",
        "customer_email":  "test@mail.com"
    },
    "page_customization": { 
        "public_name": "Shop Name", 
        "order_title": "Title Sample", 
        "order_description": "Order Description Sample"
    }
 }

As a response, you will receive the JSON with the URL and guid of the Payment Page link created.

{
    "url": "https://payment-page.solidgate.com/Q6JgG72g7K",
    "guid": "1b9a536f-57eb-4f79-9597-1319097882fa"
}

Track your payment

When a payment is completed using the Payment Page, Solidgate sends the webhook that you can use for fulfillment and reconciliation. For more information, see the guide for notifications.

You can also find the order completed by Payment Page in Solidgate HUB - home of your payments.

Currency list for PayPal