Create Customer - Paylias Docs

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

boolean

Indicates if the operation was successful

Example:

true

data

object

Customer information

Show child attributes