TeePayDocs
API ReferencePayouts

Create a payout

POST
/v1/disbursements

Confirms a valid quote and sends the payout. Your balance is reserved for the amount plus the fee before the payout is sent. If the outcome is uncertain (202), read the payout and never retry with a new idempotency_key. Requires disbursement:create.

Authorization

BearerAuth
headerAuthorizationBearer <token>

Secret API key: tp_test_. or tp_live_.. Server-side only.

Request Body

application/json
  1. body
quote_id*string
Lengthlength <= 128
idempotency_key*string
Length8 <= length <= 128

Response Body

Current committed payout state

Example Request
curl -X POST 'https://api.teepay.me/v1/disbursements' \  -H 'Content-Type: application/json' \  -d '{  "quote_id": "QUOTE_ID_FROM_QUOTE_RESPONSE",  "idempotency_key": "payout-2026-10-0001"}'
Example Response
Empty

Quote a payout POST

Prices a payout to a mobile wallet or bank account. A quote does not send money. It expires after two minutes and must be confirmed with Create a payout. Requires disbursement:create and approved payouts.

Get a payout GET

One payout by its TeePay reference. Requires disbursement:read.