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
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": {},
"guestFingerprint": {},
"metadata": {},
"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 advanced filtering, pagination, and search. Features: - Filter by active status - Search by product name, description, or unitLabel - Filter by amount (equal, between, greater, less) - Filter by date (last period, equal, between, after, before) - Pagination support