v1

latestOpenAPI 3.0.1MIT2026-07-26336777.7 KB

Create a new customer in the xPay system

post/customer/create

Headers

Idempotency-Keystring

A unique key for making the request idempotent. Must match pattern: ^[a-zA-Z0-9\-_:\.]+$. See Idempotent Requests for more details.

Request body

Example request

{
  "customerDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "contactNumber": "+919123456789",
    "customerAddress": {
      "addressLine1": "123 Main St",
      "addressLine2": "Apt 1",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postalCode": "2424"
    }
  }
}

Response

Customer created successfully

customerIdstring

Unique identifier for the created customer

Example response

{
  "customerId": "cus_Tfd3Jq1tZxPjYVhRQW2r3"
}
All 33 operations