Payment page

Hosted payment page

Changed on Nov 3, 2026

post/paymentPage

Request

Base URL
https://api.centrobill.com
URL
https://api.centrobill.com/paymentPage
Auth
API key in header Authorization

Headers

X-Request-IDstring

Unique ID of request

Request body

metadataobject

Use to store additional information associated with the payment. You can add parameters <b>udf1</b> and <b>udf2</b> to pass your internal values such as transactionId, chargeId, orderId, bundleId, or affiliateId. Any values passed will be available in the Merchant Portal

ttlinteger

The payment page lifetime in seconds. By default, set to 600

Example request

{
  "sku": [
    {
      "name": "TEST_EN_00",
      "siteId": "1811",
      "price": [
        {
          "offset": "0d",
          "amount": 29.37,
          "currency": "USD",
          "repeat": false
        },
        {
          "offset": "60d",
          "amount": 50,
          "currency": "USD",
          "repeat": false
        },
        {
          "offset": "30d",
          "amount": 30,
          "currency": "USD",
          "repeat": true
        }
      ],
      "currency": "USD",
      "title": "30 day recurring + First 30 Days For Free",
      "url": {
        "redirectUrl": "https://google.com/payment/gateway/success",
        "ipnUrl": "https://google.com/callback"
      },
      "parameters": {
        "xsell": 0
      }
    },
    {
      "name": "TEST_XSELL_00",
      "siteId": "1812",
      "price": [
        {
          "offset": "0d",
          "amount": 9.99,
          "currency": "USD",
          "repeat": false
        }
      ],
      "currency": "USD",
      "title": "Cross-sell product",
      "url": {
        "redirectUrl": "https://google.com/payment/gateway/success",
        "ipnUrl": "https://google.com/callback"
      },
      "xsell": "checked",
      "parameters": {
        "xsell": 1,
        "offer": "A"
      }
    }
  ],
  "consumer": {
    "id": "59024134",
    "externalId": "some-12958305390",
    "firstName": "John",
    "lastName": "Doe",
    "email": "someuser2020130110@google.com"
  },
  "payment": {
    "method": [
      "card",
      "sepa"
    ],
    "selected": "card",
    "secure": true,
    "test": false,
    "mid": "s938503530f"
  },
  "metadata": {
    "trackingId": "98530968732-93625235"
  },
  "emailOptions": {
    "send": true
  },
  "ttl": 1200
}

Response

Created

urlstring

Gateway payment page URL to which you redirect your user

Example response

{
  "url": "https://pay.centrobill.com/unique-hash"
}

Changes

Nov 3, 20260a3e445a9d65 Revision changes
- breaking
  removed the enum value banktransferChile of the request property ///
- breaking
  removed the enum value banktransferChile of the request property /
- breaking
  the / request property format changed from ISO2 to ISO 639-1
- info
  added the new optional request property
- info
  added the new optional request property /
- info
  added the new optional request property ///
- info
  added the new optional request property ///
- info
  added the new optional request property ///
- info
  added the new blik enum value to the request property ///
- info
  added the new blik enum value to the request property /
- info
  added the new cashapp enum value to the request property ///
- info
  added the new cashapp enum value to the request property /
- info
  added the new duitnow enum value to the request property ///
- info
  added the new duitnow enum value to the request property /
- info
  added the new gojekid enum value to the request property ///
- info
  added the new gojekid enum value to the request property /
- info
  added the new neteller enum value to the request property ///
- info
  added the new neteller enum value to the request property /
- info
  added the new offlinebanking enum value to the request property ///
- info
  added the new offlinebanking enum value to the request property /
- info
  added the new pago enum value to the request property ///
- info
  added the new pago enum value to the request property /
- info
  added the new payconiq enum value to the request property ///
- info
  added the new payconiq enum value to the request property /
- info
  added the new paynow enum value to the request property ///
- info
  added the new paynow enum value to the request property /
- info
  added the new promptpay enum value to the request property ///
- info
  added the new promptpay enum value to the request property /
- info
  added the new rapid enum value to the request property ///
- info
  added the new rapid enum value to the request property /
- info
  added the new toss enum value to the request property ///
- info
  added the new toss enum value to the request property /
- info
  added the new trustly enum value to the request property ///
- info
  added the new trustly enum value to the request property /
- info
  added the new viettelpay enum value to the request property ///
- info
  added the new viettelpay enum value to the request property /

Operation history