Customers

Customer records are reusable — attach them to checkouts and invoices instead of repeating name/email each time.

Object

{
  "id": "uuid",
  "merchant_id": "uuid",
  "name": "Alice Smith",
  "email": "[email protected]",
  "phone": "+1 415 000 0000",
  "country": "SGP",
  "notes": null,
  "created_at": "2026-03-16T10:00:00Z",
  "updated_at": "2026-03-16T10:00:00Z"
}

---

Create Customer

POST /v1/customers

Body

Field	Type	Required	Description
name	string	✓	Full name
email	string
phone	string		E.164 format recommended
country	string		ISO 3166-1 alpha-3 (e.g. SGP, USA)
notes	string		Internal notes
merchant_id	uuid		Reseller only. Create this customer under another merchant. See Reseller

Example

curl -X POST https://api-test.dpt.xyz/v1/customers \
  -H "Authorization: Bearer dptb_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alice Smith",
    "email": "[email protected]",
    "country": "SGP"
  }'

---

List Customers

GET /v1/customers

---

Get Customer

GET /v1/customers/{id}

---

Update Customer

PUT /v1/customers/{id}

Body

Field	Type	Required	Description
name	string	✓	Full name
email	string
phone	string		E.164 format recommended
country	string		ISO 3166-1 alpha-3 (e.g. SGP, USA)
notes	string		Internal notes

---

Delete Customer

DELETE /v1/customers/{id}

Returns 204 No Content. Existing checkouts and invoices referencing this customer are unaffected.