Appearance
Card Payouts
Use this page to create payouts using Card method.
- Base URL:
https://api.wirekassa.com/api/v1/payout/ - Endpoint:
POST /v1/payout/
All request and response bodies are flat: amount and currency are separate top-level fields, payout_method is the method type as a string, and every method field sits at the top level of the body.
Overview
Common fields (see Payout API):
channel(UUID, required)amount(string, required) → amount in major unitscurrency(ISO 4217, required)payout_method(string, required) →"card"external_id(string, optional) → your internal order or payout IDcallback_url(string, optional)
Method fields (payout_method: card)
Sent at the top level of the request body:
Required:
pan→ Card number
Optional:
expiry_month→"MM", defaults to"01"expiry_year→"YYYY", defaults to"3000"holder_name→ Name on card
Example Request
json
{
"channel": "b96d5b92-8f34-4b12-9b16-5f047b57c901",
"amount": "2500.00",
"currency": "RUB",
"payout_method": "card",
"pan": "4400444455550075",
"expiry_month": "01",
"expiry_year": "3000",
"holder_name": "Daniyar Akhmetov",
"external_id": "ORDER-49283",
"callback_url": "https://your-company.com/callback"
}Example Response
json
{
"status": "processing",
"transaction_id": "b5cff6ed-f3f0-46df-a390-2ffdb11430f4",
"external_id": "ORDER-49283",
"error_code": null,
"error_message": null
}