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».