Payouts

Automated merchant payout request endpoint.

POST/api/payout

Request Parameters

Field	Type	Required	Description
api_key	String	Required	Your merchant API Key
amount	Number	Required	Payout amount
order_id	String	Required	Unique payout order ID
bank_name	String	Required	Recipient bank name
account_number	String	Required	Recipient account number
account_name	String	Required	Recipient account holder name
ifsc	String	Required	IFSC code
callback	String	Required	Webhook notification URL

Note: The callback URL receives a POST with order_id, status, and amount when payout processing is completed.

Response Format

Field	Type	Description
status	Boolean	true for success
message	String	Success message
order_id	String	Your payout order ID
bank_name	String	Target bank name
acc_number	String	Recipient account number
acc_name	String	Recipient account full name
ifsc	String	IFSC code

Code Example

<?php
$params = [
    'api_key'        => 'YOUR_API_KEY',
    'amount'         => 1000,
    'order_id'       => 'PAYOUT_12345',
    'bank_name'      => 'EXAMPLE BANK',
    'account_number' => '1234567890',
    'account_name'   => 'John Doe',
    'ifsc'           => 'EXMPL0001234',
    'callback'       => 'https://yourwebsite.com/callback',
];

$ch = curl_init("https://mxpay.one/api/payout");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    $result = json_decode($response, true);
    if (isset($result['status']) && $result['status'] === true) {
        echo "Payout initiated! Order ID: " . $result['order_id'];
    } else {
        echo "Error: " . ($result['message'] ?? 'Unknown error');
    }
}
curl_close($ch);
?>