Payout Intents

Payout Intents

A Payout Intent is a request to transfer money from your merchant account to a beneficiary. It defines who gets paid, how much, and why.

You can think of it as saying: “I want to pay this person/company a certain amount”.

Control

Clearly define the payment before it’s sent.

Transparency

Each intent includes amount, purpose, and status.

Auditability

Intents can be tracked and approved before execution.Supports local and international accounts.

Creating a Payout Intent

1. Go to Payouts → Create Intent

2. Fill in the intent details:

Field	Description
Merchant Account	Select the merchant account funding the payout
Beneficiary	Choose the recipient
Beneficiary Account	Pick the account (IBAN, bank account)
Amount	The amount to transfer
Currency	The payout currency
Charge Type	Who bears the fee (e.g., BEN – beneficiary pays)
Purpose / Description	Why the payout is made (optional)
Reference ID	Internal ID for tracking (optional)
Webhook URL	Notify your system when status changes (optional)

1. Save the intent.

---

Example

• Merchant Account: Marketplace – Main Account

• Beneficiary: Al-Rashid Restaurant

• Beneficiary Account: IBAN SA123456789

• Amount: 5,000 SAR

• Currency: SAR

• Charge Type: BEN

• Purpose: Weekly settlement

---

Intent Statuses

Payout intents go through several stages:

1. Initialized – Created but not processed

2. Pending – Waiting for approval (if required)

3. Approved / Rejected – Based on workflow decisions

4. Executed – Payment completed

This ensures payouts are always controlled, reviewed, and traceable.