Skip to main content
POST
/
api
/
v1
/
csp
/
customer
curl --request POST \
  --url https://sandbox.api.paylias.xyz/gateway/api/v1/csp/customer \
  --header 'Content-Type: application/json' \
  --header 'X-PAYLIAS-API-KEY: <api-key>' \
  --header 'idempotency-key: <idempotency-key>' \
  --header 'x-org-id: <x-org-id>' \
  --header 'x-partner-id: <x-partner-id>' \
  --data '{
  "type": "Individual",
  "first_name": "Sean",
  "last_name": "Combs",
  "middle_name": "",
  "email": "seancombs@gmail.com",
  "payment_address": "sean@safepay",
  "status": "ENABLED"
}'
{
  "data": {
    "created_at": {
      "seconds": 1743092228
    },
    "first_name": "Ziyad",
    "last_name": "Parekh",
    "nick_name": "ziyad",
    "partner_id": "part_ct23b6420or249k5boag",
    "payment_address": "ziyadparekh@safepay-platinum",
    "status": 2,
    "token": "cust_cvink1420or763mhjesg",
    "updated_at": {
      "seconds": 1743092228
    }
  },
  "ok": true
}

Authorizations

​
X-PAYLIAS-API-KEY
string
header
required

Headers

​
x-org-id
string
default:""
required

The Organization ID header used for authorization

​
x-partner-id
string
default:""
required

The Partner ID header used for authorization

​
idempotency-key
string
default:""
required

The Idempotency Key - usually a UUID

Body

application/json

Request to create a new customer

​
payment_address
string
required

Payment address of the customer

Example:

"john@safepay"

​
type
enum<string>
required

Type of the customer either Individual or Business

Available options:
Individual,
Business
Example:

"Individual"

​
first_name
string
required

First name of the customer

Example:

"John"

​
last_name
string
required

Last name of the customer

Example:

"Doe"

​
business_legal_name
string
required

The official registered name of the business as documented with government authorities.

Example:

"Safepay, Inc."

​
business_website
string
required

The business's primary website/web presence.

Example:

"https://getsafepay.pk"

​
business_trade_name
string
required

The trading name or DBA (Doing Business As) name under which the business operates publicly.

Example:

"Safepay"

​
business_industry
string
required

The industry in which this business operates.

Example:

12345

​
status
enum<string>

Status of the customer

Available options:
ENABLED,
DISABLED
Example:

"ENABLED"

​
middle_name
string

Middle name of the customer

Example:

"A"

​
business_description
string

A brief summary of the business

Example:

"Modern, digital wallet for payments"

Response

Response containing Customer information

Standard response structure for successful operations

​
ok
boolean

Indicates if the operation was successful

Example:

true

​
data
object

Contains the response data Customer information

⌘I