Create User

POST

/api/v1/users

Registers the end user a card will be issued for. Store the returned data.id (usr_...) on YOUR side — card creation is done with this ID. A successful response is written to the {{user_id}} variable automatically.

All fields are REQUIRED (KYC): phone must be E.164 (+905551112233), birthday YYYY-MM-DD, country ISO2, town must be a valid city code from GET /api/v1/reference/cities?country=TR.

Mock scenario: first_name="REJECTKYC" → 422 provider_declined (kyc_rejected).

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠422

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paylandcard.com/api/v1/users' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp: {{timestamp}}' \
--header 'X-Signature: {{signature}}' \
--header 'Accept: application/json' \
--header 'Idempotency-Key: {{$guid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "Ali",
    "last_name": "Veli",
    "email": "ali@firma.com",
    "phone": "+905551112233",
    "birthday": "1992-03-20",
    "country": "TR",
    "town": "TR-34-01",
    "address": "Bagdat Cad. No:1 Kadikoy",
    "post_code": "34710"
}'

Response Example

201 - 201 — Success

{
    "data": {
        "id": "usr_01kx0hq7p3y52m0fbwn4gftzht",
        "first_name": "Ali",
        "last_name": "Veli",
        "email": "ali@firma.com",
        "phone": "+905551112233",
        "birthday": "1992-03-20",
        "country": "TR",
        "town": "TR-34-01",
        "address": "Bagdat Cad. No:1 Kadikoy",
        "post_code": "34710",
        "status": "active",
        "created_at": "2026-07-08T12:00:00+00:00"
    },
    "status": true
}

Modified at 2026-07-17 06:22:49

Authentication

Get User