Inquire Beneficiary Account

POST

/v3/payout-inquiries

Asks the destination bank whether an account is real and able to receive, and returns the name the bank holds for it. On success, returns a reference a later payout may quote.

Request

Header Params

Body Params application/jsonRequired

Examples

Minimal — only what is requiredFull — every field this operation accepts

{
    "beneficiary": {
        "account": {
            "bank_code": "ARBKMYKL",
            "number": "8881234567",
            "name": "Nur Aisyah binti Rahman"
        }
    },
    "amount": {
        "value": 250.75,
        "currency": "MYR"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Minimal — only what is requiredFull — every field this operation accepts

curl --location '/v3/payout-inquiries' \
--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 '{
    "beneficiary": {
        "account": {
            "bank_code": "ARBKMYKL",
            "number": "8881234567",
            "name": "Nur Aisyah binti Rahman"
        }
    },
    "amount": {
        "value": 250.75,
        "currency": "MYR"
    }
}'

Responses

🟢200

application/json

The account was validated. A reference is issued.

Headers

Bodyapplication/json

Examples

The merchant sent a person, so the person is echoedThe merchant sent no person, so none is echoed

{
    "inquiry_id": "I0010200000123",
    "beneficiary": {
        "first_name": "Nur Aisyah",
        "last_name": "binti Rahman",
        "phone_number": "+60123456789",
        "email": "aisyah@example.com",
        "country_code": "MY",
        "account": {
            "bank_code": "ARBKMYKL",
            "bank_name": "AmBank Berhad",
            "number": "8881234567",
            "name": "NUR AISYAH BINTI RAHMAN"
        }
    },
    "amount": {
        "value": 250.75,
        "currency": "MYR"
    },
    "expires_at": "2026-10-13T09:15:22Z"
}

🟠400

🟠401

🟠403

🟠409

🟠422

🔴500

🔴502

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

Overview

Send Payout