Send Payout

POST

/v3/payouts

Sends money to a destination account, quoting the inquiry the merchant already made for it.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "id": "SO-99120",
    "inquiry_id": "I0010200000123",
    "beneficiary": {
        "first_name": "Nur Aisyah",
        "last_name": "binti Rahman",
        "country_code": "MY",
        "account": {
            "bank_code": "ARBKMYKL",
            "number": "8881234567",
            "name": "Nur Aisyah binti Rahman"
        }
    },
    "amount": {
        "value": 250.75,
        "currency": "MYR"
    },
    "remark": "Invoice 99120 settlement",
    "metadata": {
        "order_ref": "PO-4471"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v3/payouts' \
--header 'Authorization;' \
--header 'Signature: hR8kQ2vLpX4nT7wY0aZ3cB6dE9fG1hJ5kM8nP2qS4tV' \
--header 'Client-Id: BRN-0231' \
--header 'Request-Timestamp: 2026-09-13T09:15:22Z' \
--header 'Idempotency-Id: 6f1c2a90-3b5d-4e77-9a01-8c2d4e6f0b13' \
--header 'API-Version: arabica.2025-12-01' \
--header 'Content-Type: application/json' \
--data '{
    "id": "SO-99120",
    "inquiry_id": "I0010200000123",
    "beneficiary": {
        "first_name": "Nur Aisyah",
        "last_name": "binti Rahman",
        "country_code": "MY",
        "account": {
            "bank_code": "ARBKMYKL",
            "number": "8881234567",
            "name": "Nur Aisyah binti Rahman"
        }
    },
    "amount": {
        "value": 250.75,
        "currency": "MYR"
    },
    "remark": "Invoice 99120 settlement",
    "metadata": {
        "order_ref": "PO-4471"
    }
}'

Responses

🟢200OK

application/json

The payout was accepted, refused by the destination bank, or left pending. The status field says which. A pending payout is resolved by asking for its status.

Headers

Bodyapplication/json

Examples

accepted by the destination bankthe bank has not answered yetRefused by the destination bank, with the funds returned

{
    "id": "SO-99120",
    "reference_no": "DK0000123",
    "inquiry_id": "I0010200000123",
    "status": "SUCCESS",
    "beneficiary": {
        "first_name": "Nur Aisyah",
        "last_name": "binti Rahman",
        "country_code": "MY",
        "account": {
            "bank_code": "ARBKMYKL",
            "number": "8881234567",
            "name": "NUR AISYAH BINTI RAHMAN"
        }
    },
    "amount": {
        "value": 250.75,
        "currency": "MYR"
    },
    "remark": "Invoice 99120 settlement",
    "metadata": {
        "order_ref": "PO-4471"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

🟠422Unprocessable Entity

🔴500Internal Server Error

Modified at 2026-10-23 10:41:47

Inquire Beneficiary Account

Read Payout Status