التوثيق

Get customer by ID

Retrieves customer lifecycle information (id, type, name, email, phone, address, metadata). Response shape is identical to the `customer.*` webhook payload. For transaction counts + payment methods, call `GET /customers/:id/stats`.

GET
/customers/{id}

Retrieves customer lifecycle information (id, type, name, email, phone, address, metadata). Response shape is identical to the customer.* webhook payload. For transaction counts + payment methods, call GET /customers/:id/stats.

Authorization

api-key
AuthorizationBearer <token>

API key for merchant integrations. Send as Authorization: Bearer <your key>.

In: header

Path Parameters

id*string

Customer ID

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/customers/string"
{  "id": "cus_abc123xyz",  "object": "customer",  "type": "registered",  "createdAt": "string",  "updatedAt": "string",  "name": "string",  "email": "string",  "phone": "string",  "address": {    "line1": "string",    "line2": "string",    "city": "string",    "state": "string",    "postalCode": "string",    "country": "string",    "property1": null,    "property2": null  },  "guestFingerprint": {    "emails": [      "string"    ],    "phones": [      "string"    ],    "cardFingerprints": [      {}    ]  },  "metadata": {    "property1": null,    "property2": null  },  "merchantId": "string"}

Create a customer POST

Creates a new customer record. At least one contact method (email or phone) is required. Customers are environment-specific (test vs live database).

List payment links GET

Lists payment links with filtering, pagination, and search. Features: - Filter by active status - Search by product name, description, or unit label - Filter by amount (equal, between, greater, less) - Filter by date (last period, equal, between, after, before) - Pagination support