Create and Update a Customer

A customer represents the person being charged. Customers are normally added at the Merchant Account level. If you intend to use reusable Payment Methods, a customer is required.

Create a Customer

To create a customer utilizing the Tilled API, you will make a Create a Customer request. Creating a customer allows merchants to track multiple charges that are associated with the same customer. While the request body is not required, it is essential to provide information that will help you identify the customer.

 1curl -X POST 'https://sandbox-app.tilled.com/v1/customers' \
 2-H 'tilled-account: {{MERCHANT_ACCOUNT_ID}}' \
 3-H 'tilled-api-key: {{SECRET_KEY}}' \
 4-H 'Content-Type: application/json' \
 5-d '{
 6   "first_name": "John",
 7   "last_name": "Doe",
 8   "email": "[email protected]",
 9   "phone": "555-555-5555",
10   "metadata": {
11       "internal_customer_id": "7cb1159d-875e-47ae-a309-319fa7ff395b"
12   }
13}'

Update a Customer

If you need to add, retrieve, or modify customer data, you can use the Update a Customer request. This allows you to update the customer’s first_name, middle_name, last_name, email, phone, or metadata . Any parameters that are not provided in the request body will be left unchanged.

1curl -X POST 'https://sandbox-app.tilled.com/v1/customers' \
2-H 'tilled-account: {{MERCHANT_ACCOUNT_ID}}' \
3-H 'tilled-api-key: {{SECRET_KEY}}' \
4-H 'Content-Type: application/json' \
5-d '{
6   "email": "[email protected]",
7   "phone": "555-555-5556",
8}'