Update a customer
Correct your account's copy of a customer's name, email or address. Send only the fields you are changing; `""` clears a field. The phone identifies the buyer and cannot be changed. `email` reads back as `buyer_email`.
Authorization
ApiKey API key issued to the partner, sent with the Bearer prefix — for example: Authorization: Bearer su_key_9f2c4d1ab3….
Keys minted on the live instance are prefixed su_key_ and keys minted on sandbox su_test_key_. The two instances keep separate key tables and separate hosts, so a sandbox key sent to the live host — or the reverse — answers Invalid API key. rather than falling back to the other environment.
In: header
Path Parameters
Public ID of the customer (cus_…), as returned in the id field of list or retrieve.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Send only the fields you are changing; none is required.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/customers/string/" \ -H "Content-Type: application/json" \ -d '{ "full_name": "Ram Bahadur" }'{ "id": "cus_2a108b4eb", "buyer_phone": "9810000001", "buyer_email": "[email protected]", "full_name": "Ram Bahadur", "address": "Kathmandu, Nepal", "created_at": "2026-07-03T10:15:00Z"}Retrieve a customer GET
Return a single customer belonging to your account.
List products GET
Paginated active products of your account, newest first, 20 per page by default and 100 at most (`page`, `page_size`), each with its plans and visible billing periods. Use a billing period's `pbp_id` to create a subscription, and its `interval_type` to tell a recurring plan from a one-time purchase before you offer cancel or resume on it.