Webhook

Payout webhook

POST/payout/notify

Base URLhttps://yourdomain.com/payout/notify

Asynchronous notification sent to the `notifyurl` submitted in the create payout request. Verify the signature before updating order status, then respond with `OK`.

Bodyapplication/x-www-form-urlencoded

memberidstringsign

Merchant ID assigned by the platform.

out_trade_nostringsign

Merchant payout order ID.

transaction_idstringsign

Platform transaction ID.

amountstringsign

Requested payout amount.

actualamountstringsign

Actual transferred amount.

original_amountstringsign

Original payout amount before fees.

datetimeintsign

Transaction timestamp (Unix seconds).

transferMessagestringsign

Transfer result message.

statusstringsign

Payout status: SUCCESS or FAIL.

signstring

See MD5 signature algorithm

POST/payout/notify

Request example

Scenario

curl

curl --request POST \
  --url https://yourdomain.com/payout/notify \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'memberid=10010&out_trade_no=O20260601001&transaction_id=257354624363&amount=10.00&actualamount=9.80&original_amount=10.00&datetime=1722318667&transferMessage=Transfer%20successful&status=SUCCESS&sign=YOUR_SIGN'

POST/payout/notify

Handler example

php

<?php
$key = 'your_secret_key';
$params = $_POST;
$sign = $params['sign'] ?? '';
unset($params['sign']);

ksort($params);
$parts = [];
foreach ($params as $name => $value) {
  if ($value !== '' && $value !== null) {
    $parts[] = $name . '=' . $value;
  }
}
$parts[] = 'key=' . $key;
$expected = strtoupper(md5(implode('&', $parts)));

if ($expected !== strtoupper($sign)) {
  http_response_code(400);
  exit('INVALID SIGN');
}

if (($params['status'] ?? '') === 'SUCCESS') {
  // TODO: mark payout as completed
}

echo 'OK';