Skip to content

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 units
  • currency (ISO 4217, required)
  • payout_method (string, required) → "card"
  • external_id (string, optional) → your internal order or payout ID
  • callback_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
}