NewDash Dots are hereMini apps in Dash, with payments built inLearn more

Payout

Create Payout

Creates a new payout with a specified amount, destination, and optional source account.

POST
/v1/payouts

Authorization

Authorizationstringheaderrequired

Bearer HTTP authentication specified with the header Authorization: Bearer <access_token>

Headers

Idempotency-Keystringrequired

This header is used to uniquely identify a logical request, ensuring that it is not processed more than once during retries.

Length:length <= 64
Monime-Versionstring | nulloptional

Specifies which version of the Monime API will handle this request.

Available options:caph.2025-08-23caph.2025-06-20
Monime-Space-Idstringrequired

The value is the tenancy parameter that Monime uses to determine which space the request is intended for.

Match:^spc-.*$
Length:length <= 64

Body

application/json
amountobjectrequired

The amount to be paid out to the destination account.

destinationBank · objectrequired

Information about the destination account that will receive the payout.

sourceobject | nulloptional

Optional details of the source account to be debited. If omitted, the default 'main' account is used.

metadataobject | nulloptional

Optional metadata to associate additional business context with the payout.

Properties:properties <= 64

Response

200 - application/json

OK

successbooleanoptional

Represents the status of the query operation, confirming if it was successful. This field is always true

messagesarray<unknown>optional

Contains a list of messages providing relevant information or feedback related to the query or operation

resultPayoutoptional

A Payout is a disbursement of funds from a Financial Account to a designated destination such as a Bank Account or Mobile Money Wallet.
It represents outbound money flows and is commonly used for salary disbursements, vendor payments, and refunds in automated workflows.

Each payout records the amount, the source account, the destination details, and optional metadata.
It also tracks status changes throughout its lifecycle and may include provider-specific references for reconciliation.