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`.
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 API key for merchant integrations. Send as Authorization: Bearer <your key>.
In: header
Path Parameters
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