Skip to content

List of Cards

Method for retrieving the list of a customer's bound cards.

URL

Method: GET

  • Production: https://api.pay.kvell.group/v1/customers/{customer_key}/cards
  • Stage: https://api.pay.stage.kvell.group/v1/customers/{customer_key}/cards

Request parameters

Name Data type Required Description
customer_key string Yes Customer identifier in the merchant's system

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 built 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_id": 0,
    "pan_mask": "string",
    "token": "string",
    "created_at": "2022-07-07T12:35:57.432Z"
  }
]

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