Sign in

v2

latestOpenAPI 3.0.02026-07-261677104.9 KB
Account

Add a payment method

Add a payment method to a shopper's Bolt Account Wallet. For security purposes, this request must come from your backend. <br/> Note: Before using this API, the credit card details must be tokenized by Bolt's credit card tokenization service. Please review our Bolt Payment Field Component or Install the Bolt Tokenizer documentation.

post/account/payment-methods

Headers

X-Publishable-Keystring required

The publicly shareable identifier used to identify your Bolt merchant division.

X-Merchant-Client-Idstring

A unique identifier for a shopper's device, generated by Bolt. The value is retrieved with Bolt.state.merchantClientId in your frontend context, per-shopper. This header is required for proper attribution of this operation to your analytics reports. Omitting this header may result in incorrect statistics.

Request body

OR
OR
OR
OR
OR
OR
OR
OR

Example request

{
  ".tag": "credit_card",
  "id": "X5h6j8uLpVGK",
  "type": "credit_card",
  "billing_address": {
    ".tag": "id",
    "id": "D4g3h5tBuVYK9"
  },
  "network": "visa",
  "bin": "411111",
  "last4": "1004",
  "expiration": "2029-03",
  "token": "a1B2c3D4e5F6G7H8i9J0k1L2m3N4o5P6Q7r8S9t0",
  "affirm_vcn_token": "a1B2c3D4e5F6G7H8i9J0k1L2m3N4o5P6Q7r8S9t0",
  "default": true
}

Response

The payment method was successfully added

OR
OR
OR
OR
OR
OR
OR
OR

Example response

{
  ".tag": "credit_card",
  "id": "X5h6j8uLpVGK",
  "type": "credit_card",
  "billing_address": {
    ".tag": "id",
    "id": "D4g3h5tBuVYK9"
  },
  "network": "visa",
  "bin": "411111",
  "last4": "1004",
  "expiration": "2029-03",
  "token": "a1B2c3D4e5F6G7H8i9J0k1L2m3N4o5P6Q7r8S9t0",
  "affirm_vcn_token": "a1B2c3D4e5F6G7H8i9J0k1L2m3N4o5P6Q7r8S9t0",
  "default": true
}