Submit Payout
Submits a previously reviewed payout, executing the payment. The proposalId is the id returned
by POST /v1/payouts. Must be called before the proposal’s validUntilTs, otherwise it is rejected
as expired.
Authorizations
Basic authentication using the partner API keys from https://console.grainfinance.co/keys
Path Parameters
Response
Payout submitted
A Payout represents an executed payment to a vendor. Returned by GET /v1/payouts/{id},
GET /v1/payouts, and POST /v1/payouts/{id}/submit.
The id of the payout within the Grain platform.
[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}"8173b9a7-ee61-413e-b9e3-7c04b2a067c5"
The current status of the payout.
in_process, sent, paid, failed, rejected "in_process"
The payout id, as identified within your system.
^[A-Za-z0-9_.\-]{1,64}$"inv_2026_001"
The alpha-3 ISO 4217 currency code of the payout.
^[A-Za-z]{3}$"USD"
The payout amount, denoted in currency.
5000
The fee applied to this payout, denoted in currency.
1.5
Total amount that will leave the wallet (amount + fee), denoted in currency.
5001.5
The compliance reason categorising this payout, as a numeric code:
1 - Intercompany Payment 2 - Purchase of Good(s) 3 - Purchase of Service(s) 4 - Transferring to Own Accounts 5 - Valid Vendor Purchases
1, 2, 3, 4, 5 2
Free-form description supplied when initiating the payout.
The date the payout was sent to the bank, in YYYY-MM-DD format.
\d{4}-\d{2}-\d{2}"2026-05-15"
The payment method that will be used to send the payout.
SWIFT, SEPA, WIRE, ACH, FPS, EFT, NPP, IBG, BECS, CCASS, SPEI "SEPA"
The vendor receiving the payout, including their bank account details.