Customers

Manage customer information.

Create Customer

Create or retrieve a customer by email/phone.

Endpoint: POST /v1/pay/customers

Authentication: Required

Request Body:

Field	Type	Required	Description
`email`	string	No*	Customer email
`phone`	string	No*	Customer phone number
`name`	string	Yes	Customer name
`metadata`	object	No	Custom metadata

*At least one of email or phone required

Example:

HTTP

TypeScript

Python

Success Response (201):

{
  "data": {
    "id": "cus_abc123",
    "email": "customer@example.com",
    "phone": "+2207654321",
    "name": "John Doe",
    "metadata": {},
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Get Customer

Get details of a specific customer.

Endpoint: GET /v1/pay/customers/{id}

Authentication: Required

List Customers

Get a paginated list of customers.

Endpoint: GET /v1/pay/customers

Authentication: Required

Query Parameters:

Parameter	Type	Required	Description
`offset`	integer	No	Number of items to skip (default: 0)
`limit`	integer	No	Maximum number of items to return (default: 20, max: 100)
`email`	string	No	Filter by email
`phone`	string	No	Filter by phone

Update Customer

Update an existing customer.

Endpoint: PUT /v1/pay/customers/{id}

Authentication: Required

Request Body:

Field	Type	Required	Description
`email`	string	No	Customer email
`phone`	string	No	Customer phone
`name`	string	No	Customer name
`metadata`	object	No	Custom metadata

Delete Customer

Delete a customer.

Endpoint: DELETE /v1/pay/customers/{id}

Authentication: Required

Success Response (204): No content

Customers

Create Customer#

Get Customer#

List Customers#

Update Customer#

Delete Customer#

Create Customer

Get Customer

List Customers

Update Customer

Delete Customer