Endpoints

Payout methods

GET/api/v1/me/payout/methods

The available payout rails, flagged with `funded` when you have a balance in their currency.

GET/api/v1/me/payout/methodssecret key

Lists the available payout methods (analogous to pay-in's GET /payment-methods). Each method carries `id` (you pass it to POST /me/payout/send), `currency`, `country`, `rail`, indicative limits, `funded` (true if you have a payout balance in that currency) + `currencyAvailable`, and `logoUrl` (alias `iconUrl`) — an absolute, public URL of the rail's brand icon you can render directly (`<img src={logoUrl}>`); it always resolves and reflects the operator's latest upload in real time. If you want to send in a local currency with no balance, do a USD→that-currency swap first.

Request

curl "https://sandbox.key2pay.ai/api/v1/me/payout/methods" \
  -H "Authorization: Bearer <accessToken>"

Response

{
  "items": [
    { "id": "po_usd_bank", "name": "Bank transfer (USD)", "currency": "USD", "country": "US", "rail": "bank", "minUsd": 10, "maxUsd": 50000, "logoUrl": "https://api.key2pay.ai/api/payment-method-logo/payout_bank?v=2026-07-04T00:00:00.000Z", "iconUrl": "https://api.key2pay.ai/api/payment-method-logo/payout_bank?v=2026-07-04T00:00:00.000Z", "funded": true, "currencyAvailable": 250.00 },
    { "id": "po_mxn_spei", "name": "SPEI", "currency": "MXN", "country": "MX", "rail": "spei", "minUsd": 5, "maxUsd": 30000, "logoUrl": "https://api.key2pay.ai/api/payment-method-logo/payout_spei?v=2026-07-04T00:00:00.000Z", "iconUrl": "https://api.key2pay.ai/api/payment-method-logo/payout_spei?v=2026-07-04T00:00:00.000Z", "funded": true, "currencyAvailable": 1850.00 }
  ]
}