Payment

Server-to-server

Changed on Nov 3, 2026

post/payment

Request

Base URL
https://api.centrobill.com
URL
https://api.centrobill.com/payment
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

Example request

{
  "paymentSource": {
    "type": "card",
    "number": "4024007179366348",
    "expirationMonth": "11",
    "expirationYear": "22",
    "cvv": "100",
    "3ds": false
  },
  "parameters": {
    "descriptor": "SOME SHOP>Berlin DE"
  },
  "sku": {
    "title": "Product name",
    "siteId": "983759353",
    "price": [
      {
        "offset": "0d",
        "amount": 19.99,
        "currency": "USD",
        "repeat": false
      }
    ]
  },
  "consumer": {
    "id": "4242522",
    "email": "jonny.sonny@google.com",
    "firstName": "John",
    "lastName": "Doe",
    "phone": "+1987353539",
    "country": "USA",
    "state": "Alabama",
    "city": "Montgomery",
    "zip": "36101",
    "ip": "8.8.8.8",
    "userAgent": "mozilla/5.0 (iphone; cpu iphone os 13_1_2 like mac os x) applewebkit/605.1.15 (khtml, like gecko) version/13.0.1 mobile/15e148 safari/604.1",
    "deviceId": "1.1|hfp9sLiKhAoWyNSMpiQGh|mozilla/5.0 (windows nt 6.1) applewebkit/537.36 (khtml, like gecko) chrome/92.0.4515.131 safari/537.36|24#1344#840#799|internal-pdf-viewer#mhjfbmdgcfjbbpaeojofohoefgiehjai#internal-nacl-plugin|Win32|1g0u1g01u0u10r1u0x10g1y0g1d0g10g1010u101g0g1u01r0x10x101g01a010u101g01010u101r01z01ij01a0u1u01rd01r0r101ir01ii01aj01ux01ui01iy01y01ui0g1y01r01d0|MS|-1397920487|c39b35be"
  },
  "url": {
    "ipnUrl": "https://google.com/gateway/webhook/245252525252525",
    "redirectUrl": "https://google.com/gateway/redirect/245252525252525"
  },
  "metadata": {
    "foo": "bar"
  },
  "emailOptions": {
    "send": true
  }
}

Response

Created

metadataobject

Example response

{
  "payment": {
    "description": "APPROVED",
    "action": "charge",
    "url": "https://google.com/oijhflsfs9",
    "qrCode": "00020126910014BR.GOV.BCB.PIX2569api-pix-h.bancobs2.com.br/spi/v2/f8f7bd5e-d40a-40d1-ac98-4ec534c1bfc652040000530398654045.945802BR5925Visconde Pagamentos E Sol6014Belo Horizonte61083038040362070503***6304E381",
    "mode": "sale",
    "status": "success",
    "amount": 9.99,
    "currency": "USD",
    "amountUsd": 9.99,
    "orderId": "235324530",
    "transactionId": "12345",
    "descriptor": "centrohelp.com",
    "network_transaction_id": "987654321098765",
    "source": {
      "method": "card",
      "number": "402400****6348",
      "brand": "visa",
      "bankName": "BENDIGO AND ADELAIDE BANK, LTD",
      "bankCountry": "AUS",
      "paymentAccountId": "d86bdcbb-c369-46d9-a9d0-9c5010e3bfdb"
    }
  },
  "consumer": {
    "externalId": "14253ms92m0as",
    "email": "jonny.sonny@google.com",
    "phone": "+1987654320",
    "country": "GBR",
    "zip": "36101"
  },
  "subscription": {
    "status": "active",
    "renewalDate": "2020-04-17 13:43:02",
    "cancelDate": "2020-11-17 13:43:02"
  },
  "metadata": {
    "foo": "bar"
  },
  "timestamp": {
    "dateTime": "2020-04-17 13:43:02",
    "timezone": "UTC+02.00",
    "unixTime": "1637063718"
  }
}

Changes

Nov 3, 20260a3e445a9d65 Revision changes
- breaking
  removed subschema #24: Banktransfer Chile from the request property oneOf list
- warning
  added the new blik enum value to the // response property for the response status
- warning
  added the new cashapp enum value to the // response property for the response status
- warning
  added the new duitnow enum value to the // response property for the response status
- warning
  added the new gojekid enum value to the // response property for the response status
- warning
  added the new neteller enum value to the // response property for the response status
- warning
  added the new offlinebanking enum value to the // response property for the response status
- warning
  added the new pago enum value to the // response property for the response status
- warning
  added the new payconiq enum value to the // response property for the response status
- warning
  added the new paynow enum value to the // response property for the response status
- warning
  added the new promptpay enum value to the // response property for the response status
- warning
  added the new rapid enum value to the // response property for the response status
- warning
  added the new toss enum value to the // response property for the response status
- warning
  added the new trustly enum value to the // response property for the response status
- warning
  added the new viettelpay enum value to the // response property for the response status
- 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 subschema #2: Codi subschema #5: DuitNow subschema #8: Efecty subschema #10: Trustly subschema #11: GoJekId subschema #14: Lottery subschema #17: MBWay subschema #18: Rapid subschema #20: Multibanco subschema #23: Offlinebanking subschema #26: Pago subschema #29: Pago46 subschema #32: Payconiq subschema #34: Paynow subschema #35: PicPay subschema #38: Promptpay subschema #40: Banktransfer Chile Argentina subschema #41: Skrill subschema #42: SPEI subschema #44: Todito subschema #47: Toss subschema #49: Tpaga subschema #53: Cash App subschema #54: Blik subschema #55: Voucher subschema #56: Neteller subschema #57: Viettelpay to the request property oneOf list
- info
  added the optional property / to the response with the status
- info
  removed the banktransferChile enum value from the // response property for the response status

Operation history