v14

OpenAPI 3.1.02026-08-03122113375.9 KB
seller-finance

Create payout

Create a payout request for the authenticated seller.

Use this endpoint when a seller explicitly requests withdrawal of available funds.

Validation and rules:

  • Reads current balance before creating a payout.
  • Enforces a minimum available balance of 1000 (smallest currency unit).
  • Returns 400 if balance is below the minimum threshold.

Response:

  • Returns 201 with the created payout resource on success.
post/seller/payouts/withdraw

Request body

amountinteger required

Amount to withdraw in the smallest currency unit

currencystring required

Three-letter ISO currency code for the payout

Response

Payout created

idstring required

Unique identifier for the payout

amountnumber required

Amount of the payout in the smallest currency unit

currencystring required

Currency for the payout

arrivalDatestring required

Estimated date when the payout will arrive

statusstring required

Current status of the payout