Payouts overview

A payout sends money from your Mamo account to a bank account. Most integrations first save the destination as a recipient (name, bank details, and a reason), then pay that recipient by its ID, so you validate bank details once and reuse them.

How it fits together

Check the bank details with Validate IBAN (optional, but it catches typos before you save them).
Save the destination with Create Recipient.
Pay them:
- with Issue Payouts, which takes one or many payouts (at least AED 10 each) in a single call, to a saved recipient_id or to raw bank details;
- with Create International Payout for a recipient abroad, where the recipient's bank details decide the currency and corridor.
Track the result with the payout.processed / payout.failed webhooks, or Fetch Payout Info.

Managing recipients and payouts

You want to	Use
List or look up recipients	Fetching Recipients, Fetch Recipient
Change or remove a recipient	Update Recipient, Delete Recipient
See what a recipient is owed from split payments	Fetch Recipient Balance
See every payout	List Payouts

The Payout Object page describes the payout webhook payload field by field.

📘
Splitting customer payments with recipients
If you run a marketplace, you can route part of each customer payment to a recipient as it's captured, with payouts_share. See Marketplace & split payments.

Try it

Follow the Pay a recipient recipe in the sandbox. Sandbox settlement is slower than live by default, so a fresh sandbox balance may not be available to pay out straight away; see Sandbox testing.