Register wallet customer

Creates a customer, provisions the initial YER primary wallet and returns a bearer token.

Access tierpublicRate limitpay_apiIdempotencynoneAuthenticationPublic

SourceLuxApi/Modules/LuxPayIdentity/Http/Controllers/Api/UserAuthController.php::customerRegisterLuxPayProjects @ 146e98baa44e

Parameters

X-Request-IDheader

stringOptional

Client correlation identifier. LuxPay may generate one when omitted.

Example: req_01J...

Request body

CustomerRegisterRequestRequired

full_name

string

Example: أحمد محمد

phone

string

Example: +9677XXXXXXX

email

string | null

password

string

JSON example

{
  "full_name": "أحمد محمد",
  "phone": "+9677XXXXXXX",
  "email": "string",
  "password": "string"
}

Code examples

The displayed sandbox host is a placeholder until an official host is provisioned. Never paste a production token into a public browser.

curl --request POST \
  --url 'https://sandbox-api.luxpay.example/v1/auth/customer/register' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "full_name": "أحمد محمد",
  "phone": "+9677XXXXXXX",
  "email": "string",
  "password": "string"
}'

Responses

201Successful response.

success

boolean

Example: true

message

string | null

token

string

customer

Customer

{
  "success": true,
  "message": "string",
  "token": "string",
  "customer": {
    "id": 1,
    "full_name": "string",
    "phone": "string"
  }
}

400

401

403

404

409

422

429

500

OpenAPI JSON OpenAPI YAML Postman collection