Skip to content

Payouts to a Card

A method for making a payout to a card by its token. The method is similar to payout to a card by card number. The request body must include a customer_card object with the nested parameters customer_card_token and customer_key instead of recipient_pan.

URL

Method: POST

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

Request parameters

Name
Data type Required Description
amount integer Yes Amount in kopecks
description string Yes Transaction description. Maximum 210 characters.
transaction string Yes Unique transaction number on the merchant's side
customer_card json Yes Object
customer_card_token string Yes Linked card token
customer_key string Yes Customer identifier in the merchant's system
customer string No Customer's email / phone number

Request example

{
  "customer_card": {
    "customer_key": "ac3b8a75-74d2-4d12-b787-9223dc963be1",
    "customer_card_token": "Ue4N3VZ5Jbd6oPhXPk3J8995LBuR0IrTWVjBNGWvN7r"
  },
  "amount": 10000,
  "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
  "description": "test_transaction_1",
  "customer": "test@test.com"
}

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 the same way as described in the section «Generating a signature for payouts».