Skip to content

Card Top-Up

Top up an issued card using the card identifier idcard.

URL

Method: POST

  • Production: https://api.pay.kvell.group/v1/orders/payout/issue-card
  • Stage: https://api.pay.stage.kvell.group/v1/orders/payout/issue-card

Request parameters

Name Required Type Comment
card_id string Yes Identifier of the issued card
amount integer Yes Top-up amount in kopecks
transaction string Yes Unique transaction number
description string Yes Description. Maximum 210 characters.
customer string No Customer information
extra_data json No Additional data

Example request

{
  "card_id": "string",
  "amount": 1000,
  "transaction": "string",
  "description": "string",
  "customer": "string"
}

Request headers

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

Building the signature

The request must be signed using an electronic signature. The RSA/SHA256 algorithm is used. This value must be passed in the X-Signature HTTP request header. The signature-building algorithm is the same as for making a payout.

Response

Example response

{
    "order": {
        "id": "value",
        "status": "completed",
        "transaction": "value",
        "amount": "value",
        "commission": "value",
        "description": "value",
        "additional_data": {
            "auth_code": null,
            "rrn": null
        },
        "error_code": null,
        "error_message": null,
        "created_at": "value"
    }
    "status": "completed"
}

{
  "errors": [
    {
      "code": 20007,
      "message": "Transaction was already processed"
    }
  ]
}

List of statuses

Name Description
new New transaction
processing Transaction is being processed
canceled Transaction declined
completed Transaction completed