Skip to main content

Create payout application

POST 
/svc/ts/api/v2/payout_applications

Creates a payout application. On success the stored status is Pending for Transfer (inserted as Initiated, then updated in the same transaction).

Server validation order

  1. JSON must parse.
  2. If store_id is non-empty: resolve sub-store → set business; fail with 820012 when not found.
  3. Business (store) must be Active; required body fields non-empty: currency, ref_id, verify_code, staff_id; amount must be > 0 (500013 if ≤ 0).
  4. Currency must be enabled; amount decimal places must match currency rules.
  5. ref_id must be unique for the merchant.
  6. Within a transaction: insert record, then set status to Pending for Transfer and persist expired_at.

Request​

Responses​

Created successfully

Response Headers