Skip to content

Creating a Customer

The method registers a customer in the system and links them to the merchant's shop.

URL

Method: POST

  • Production: https://api.pay.kvell.group/v1/customers
  • Stage: https://api.pay.stage.kvell.group/v1/customers

Request parameters

Name Data type Required Description
customer_key string Yes Customer identifier in the merchant's system
email string No Customer's email address
phone string No Customer's phone number

Request example

{
  "customer_key": "string",
  "email": "user@example.com",
  "phone": "string"
}

Request headers

Name Data type Required Description
X-Api-Key string Yes Unique shop identifier
X-Signature string Yes Signature

The X-Signature signature is generated by concatenating X-Api-Key, customer_key, and secret_key. sha256 is computed from the resulting string:

sha256({x-api-key}{customer_key}{secret_key})

where secret_key is the secret key found in the merchant's shop settings.

Response

Response example

{
  "customer_key": "string",
  "email": "string",
  "phone": "string"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}