Apply Customer Info

Here we will apply customer info to the cart (including the address).

Note: For more details on this endpoint please refer to the API Reference

Once you have a cart with products in it you need to apply the customer information. For a brand new customer this would likely include Apply Guest Customer to Cart , Set Shipping Address , and Set Billing Address.

For the sake of ease in this example we will simplify address handling and use the same address for billing and shipping and pass this along with the customer the body of the request. For more details on what fields this API can take, refer to the documentation linked above. In this example, we have used the cart we created in the previous step. Your Cart Id will be unique and need to be updated in the request below.

Using same_address: true we can set the shipping and billing address simultaneously.

See our Quick Checkout Guide for tips on how you can combine this step with the create cart call to reduce e-comm requests and use less rates

Apply Customer to Cart

post
Path parameters
cart_idinteger · int64Required
Query parameters
price_cartbooleanOptionalDefault: false
Header parameters
X-Violet-TokenstringRequired
X-Violet-App-SecretstringRequired
X-Violet-App-Idinteger · int32Required
Body

Details of the customer placing the order.

first_namestring · max: 32Required

Customer's first name.

last_namestring · max: 32Required

Customer's last name.

emailstring · max: 64Required

Customer's valid email address.

same_addressbooleanOptional

When only one address is provided, should the one address be used for both the shipping and billing addresses.

Default: false
namestringRead-onlyOptional

Full name of the customer.

Responses
200
success
application/json
post
POST /v1/checkout/cart/{cart_id}/customer HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "customer": {
    "first_name": "Super",
    "last_name": "Mario",
    "email": "[email protected]"
  }
}
{
  "id": 10000,
  "token": "fz8x7gksdjsy2p9fdlonw7k9svwjso4b",
  "user_id": 10000,
  "app_id": 10000,
  "developer_id": 10000,
  "customer": {
    "user_id": 10000,
    "first_name": "Super",
    "last_name": "Mario",
    "email": "[email protected]",
    "name": "Super Mario"
  },
  "bags": [],
  "shipping_address": null,
  "billing_address": null,
  "payment_method": null,
  "sub_total": 0,
  "shipping_total": 0,
  "tax_total": 0,
  "discount_total": 0,
  "total": 0,
  "app_order_id": "00100100",
  "status": "IN_PROGRESS",
  "is_guest": true,
  "date_created": "2017-06-15T01:01:01+0000",
  "date_last_modified": "2017-06-15T01:01:01+0000",
  "priced": false,
  "wallet_based_checkout": false,
  "currency": "USD",
  "channel": "APP",
  "currency_symbol": "$",
  "stripe_key": "pk_test_UHg8oLvg4rrDCbvtqfwTE8qd",
  "payment_intent_client_secret": "pi_vw8krrsvposl347c5l7x1nt5_secret_vbcw5t2bze37iptq430tmx7s",
  "payment_transactions": null,
  "intent_based_checkout": true,
  "guest": true,
  "order_id": 11111
}

Last updated

Was this helpful?