v2

latestOpenAPI 3.0.02026-07-261677104.9 KB

Callbacks

Callback to update or create a full shopper account

Create or update a shopper account with profile information, payment and addresses. This is also known as the "upsert account" API, a combination of update and insert.

post/callbacks/accounts

Headers

X-Bolt-Hmac-Sha256string required

A Bolt-signed hash-based message authentication code (HMAC) to verify that the sender is Bolt.

Request body

customer_data_idstring

A unique identifier for this account on your cart platform.

Example request

{
  "account_details": {
    "addresses": [
      {
        "id": "D4g3h5tBuVYK9",
        "first_name": "Alice",
        "last_name": "Baker",
        "company": "ACME Corporation",
        "street_address1": "535 Mission St, Ste 1401",
        "street_address2": "c/o Shipping Department",
        "locality": "San Francisco",
        "postal_code": "94105",
        "region": "CA",
        "country_code": "US",
        "email": "alice@example.com",
        "phone": "+14155550199",
        "is_default": true
      }
    ],
    "payment_methods": [
      {
        ".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
      }
    ],
    "profile": {
      "first_name": "Alice",
      "last_name": "Baker",
      "email": "alice@example.com",
      "phone": "+14155550199"
    }
  },
  "customer_data_id": "5FEB9028D"
}

Response

The account details were successfully created/updated