Skip to content

Payment page

Solidgate Payment Page allows merchants to securely redirect customers to a payment gateway's hosted page for completing transactions, without the need for custom integration on the merchant's website.

Operations

Create page

Request

Please note that the payment page link expires in 24 hours.

Security
merchant and signature
Headers
merchantstringrequired

Unique public key provided upon registration and must be shared for identification purposes.

Example:api_pk_7b197...ba108f842
signaturestringrequired

Request signature that allows verification of merchant authenticity on the payment gateway server.

Example:M2E3OTkyNzcz...xMmExODI4
Bodyapplication/json
One of:
orderobjectrequired

Information required to create an order.

page_customizationobjectrequired

Information required to customize the payment page display.

curl -i -X POST \
  https://payment-page.solidgate.com/api/v1/init \
  -H 'Content-Type: application/json' \
  -H 'merchant: YOUR_API_KEY_HERE' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -d '{
    "order": {
      "order_id": "923bb4e6-4a5f-41ec-81fb-28eb8a152e55",
      "amount": 1020,
      "currency": "EUR",
      "future_usage": {
        "payment_type": "one-time"
      },
      "order_description": "Premium package",
      "order_items": "item 1 x 10, item 2 x 30",
      "order_date": "2025-12-21 11:21:30",
      "order_number": 9,
      "settle_interval": 0,
      "authorization_type": "final",
      "force3ds": false,
      "google_pay_allowed_auth_methods": [
        "PAN_ONLY"
      ],
      "customer_date_of_birth": "1988-11-21",
      "customer_email": "example@example.com",
      "customer_first_name": "Nikola",
      "customer_last_name": "Tesla",
      "customer_phone": "+11234567890",
      "item_category": "physical_goods",
      "billing_address": {
        "country": "USA",
        "state": "NY",
        "city": "New York",
        "zip": "10001",
        "address": "123 Main St"
      },
      "shipping_address": {
        "country": "USA",
        "state": "NY",
        "city": "New York",
        "zip": "10001",
        "line1": "123 Main St",
        "line2": "Apt. 4B"
      },
      "dynamic_descriptor": {
        "suffix": "PRODUCTX"
      },
      "payment_type_data": {
        "klarna_network_session_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.klarna_session_token_example",
        "klarna_network_data": "{\"order_lines\":[{\"name\":\"Premium package\",\"quantity\":1,\"unit_price\":1020,\"total_amount\":1020}]}",
        "sweden_pin": "19811228-9874"
      },
      "traffic_source": "facebook",
      "transaction_source": "main_menu",
      "purchase_country": "USA",
      "geo_country": "USA",
      "geo_city": "New Castle",
      "language": "pt",
      "website": "https://merchant.example",
      "order_metadata": {
        "coupon_code": "NY2025",
        "partner_id": "123989"
      },
      "success_url": "https://merchant.example/success",
      "fail_url": "https://merchant.example/fail"
    },
    "page_customization": {
      "public_name": "Public Name",
      "order_title": "Order Title",
      "order_description": "Premium package",
      "payment_methods": [
        "paypal",
        "klarna-network"
      ],
      "button_font_color": "#FFFFFF",
      "button_color": "#00816A",
      "font_name": "Open Sans",
      "is_cardholder_visible": true,
      "terms_url": "https://merchant.example/terms",
      "terms_accepted_by_default": false,
      "back_url": "https://merchant.example/back"
    }
  }'

Responses

Request received

Bodyapplication/json
Any of:
urlstringrequired

Specific URL where the customer should be directed to complete their transaction.

Example:"https://payment-page.solidgate.com/VxKnj3D"
idstringrequired

Unique payment page identifier.

Example:"VxKnj3D"
guidstringdeprecated

Unique payment session identifier.

Response
{
  "url": "https://payment-page.merchant.example/VxKnj3D",
  "id": "VxKnj3D"
}