Create International Payout

post

https://business.mamopay.com/manage_api/v1/international_payouts

Initiates an international payout to an existing recipient, created via the Create Recipient API. The destination currency and corridor are determined by the recipient's bank details.

Accepts an optional Idempotency-Key header so you can safely retry the request without risking a duplicate payout.

Exactly one of source_amount or destination_amount must be provided — not both.

ℹ️
Send an Idempotency-Key header and reuse the same key when you retry. See Idempotency for how retries work.

Body Params

recipient_id

string

required

Defaults to REP-081BCADE9A

The identifier of an existing recipient (created via the Create Recipient API) to send the payout to.

reason

string

enum

required

Defaults to supplier_payment

The reason / category for this payout. Must be one of the allowed values.

relationship

string

enum

The relationship between you and the recipient. Required when paying out to the India (IN) corridor; optional for other corridors.

description

string

A free-text description of what the payout is for.

source_amount

string

Defaults to 500.00

The amount to deduct from the merchant's balance, as a string, always in AED. The minimum is dynamic (default 100 AED, and may differ for your account). Provide either source_amount or destination_amount, not both.

destination_amount

string

The amount the recipient should receive, as a string, in the recipient's destination currency. Each corridor also enforces a maximum payout amount. Provide either source_amount or destination_amount, not both.

Headers

Authorization

string

Idempotency-Key

string

Optional. A unique key for this request, such as a UUID v4, so you can retry it safely. See Idempotency.

Responses

500

Unexpected error

201Payout created

403Forbidden — the API key is unauthorised, or international payouts are not enabled for the account.

422Unprocessable entity. Request-validation failures return VALIDATION_ERROR with a messages value of ["See errors"] and a per-field errors array. Business-rule failures return a specific error_code with a human-readable messages array.