Subscription

Change payment account for subscription

Changed on Nov 3, 2026

put/subscription/{id}/paymentAccount

Request

Base URL
https://api.centrobill.com
URL
https://api.centrobill.com/subscription/{id}/paymentAccount
Auth
API key in header Authorization

Path parameters

idstring required

Gateway subscription ID

Headers

X-Request-IDstring

Unique ID of request

Request body

Example request

{
  "paymentSource": {
    "emulateCode": "5003",
    "mpiParameters": {
      "authStatus": "Y",
      "cavv": "kBMSV/fB8ausrgK8Xem8wIQBeP88",
      "eci": "02",
      "directoryServerTransactionId": "3ba1f2c9-613b-4c00-80b1-ec8869690b26",
      "scaExemption": "lowValue"
    }
  },
  "consumer": {
    "externalId": "14253ms92m0as",
    "email": "jonny.sonny@google.com",
    "phone": "+1987654320",
    "country": "GBR",
    "zip": "36101"
  },
  "url": {
    "ipnUrl": "https://google.com/gateway/webhook/245252525252525",
    "redirectUrl": "https://google.com/oijhflsfs9"
  }
}

Response

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 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
- 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 optional property / to the response with the status
- info
  removed the banktransferChile enum value from the // response property for the response status

Operation history