Документация/Выплаты/Создать выплату
Создать выплату
POST/api/v1/payouts
Выплата на карту получателя.
HMACIdempotency-Key requiredcreatePayout
Параметры тела
| Поле | Тип | Описание |
|---|---|---|
| order_idreq | string | Your own reference. Unique per API key. |
| amount_minorreq | int64 | |
| currencyreq | string | |
| accountreq | string | The account the transfer is drawn against, as agreed with the provider. Required — it is not the destination card, and it is safe to display in the cabinet. |
| payout_methodreq | object | Exactly one of `card`, `saved_card_id` or `wallet`, matching `type`. Sending both a card and a saved card is `400 card_and_saved_card_are_exclusive`. |
| typereq | "card" | "apple_pay" | "google_pay" | "samsung_pay" | |
| card | object | The destination card. `cvv` is optional here and required nowhere: a CVV proves the payer is holding the card, which is worth asking when taking money and means nothing when giving it back. |
| numberreq | string | |
| expire_monthreq | integer | |
| expire_yearreq | integer | |
| cvv | string | |
| cardholder | string | |
| saved_card_id | uuid | A card stored earlier, addressed by the id from `GET /cabinet/v1/payment-method-tokens`. Must belong to you and to the same provider, otherwise `422 saved_card_not_found`. |
| wallet | object | Wallet payment token |
| payload_mode | "token" | "direct" | |
| description | string | |
| return_url | uri | Where to send the payer back after a 3DS challenge. |
| customer | object | Card-holder data. For a Mastercard PAN email is required. For a Visa PAN first_name, last_name, email, billing_address.country and billing_address.line1 are required. country is accepted as a current ISO 3166-1 alpha-2 code and converted to PSP numeric-3 by the backend. |
| first_name | string | |
| last_name | string | |
| phone | string | |
| billing_address | object | |
| country | string | Current assigned ISO 3166-1 alpha-2 country code. |
| postal_code | string | |
| region | string | |
| city | string | |
| line1 | string | |
| line2 | string | null | |
| line3 | string | null | Third address line, forwarded to the PSP as address_line_3. Optional everywhere; no card scheme requires it. |
| device | object | Browser data forwarded to the issuer for 3DS. |
| metadata | object |
Пример
Запрос
POST /api/v1/payouts
Idempotency-Key: order-20260817-001
{
"order_id": "order-20260817-001",
"amount_minor": 1001,
"currency": "EUR",
"account": "account",
"payout_method": {
"type": "card"
},
"description": "Заказ №014",
"return_url": "https://merchant.example.com/payments/return"
}Ответ 201
{
"payout_id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
"order_id": "order-20260817-001",
"status": "processing",
"final": false,
"amount_minor": 1001,
"currency": "EUR",
"account": "account",
"payout_method": "card",
"created_at": "2026-08-17T12:45:22Z",
"updated_at": "2026-08-17T12:45:22Z"
}Собрать запрос
Собрать запрос
curl -X POST \
https://api.calibripay.com/api/v1/payouts \
-H "X-Access-Key: $CALIBRIPAY_ACCESS_KEY" \
-H "X-Timestamp: $TS" \
-H "X-Nonce: $NONCE" \
-H "X-Signature: $SIGNATURE" \
-H "Idempotency-Key: order-20260817-001" \
-d '{ "order_id": "order-20260817-001", "amount_minor": 1001, "currency": "EUR", "account": "account", "payout_method": { "type": "card" }, "description": "Заказ №014", "return_url": "https://merchant.example.com/payments/return" }'$TS, $NONCE и $SIGNATURE вычисляются на вашем backend по канонической строке. secret_key никогда не должен попадать в браузер, в командную строку из истории и в тикеты.
Связанные операции
Была ли страница полезной?