Webhook

Webhook

POST/notify

Asynchronous notification sent to the `notifyurl` submitted in the create payout request. The SDK parses `$_POST`, verifies the MD5 signature, and returns a `PayoutWebhookRequest`. Call `webhookRespondOk()` after processing.

SDK methodwebhook()

ParametersRequest body

memberidstring

Merchant ID

out_trade_nostring

SDK property: outTradeNo. Merchant payout order ID

transaction_idstring

SDK property: transactionId. Platform transaction ID

amountstring

Requested payout amount

actualamountstring

Actual transferred amount

original_amountstring

SDK property: originalAmount. Original amount before fees

datetimeint

Transaction timestamp (Unix seconds)

transferMessagestring

Transfer result message

statusstring

`SUCCESS` or `FAIL`

signstringsign

MD5 signature

POST/notify

// payout/notify.php
try {
    $webhook = $client->getPayoutsApi()->webhook();

    if ($webhook->isSuccess()) {
        // Update payout order status
        echo 'Merchant Order Id:' . $webhook->getOutTradeNo();
    }

    $client->getPayoutsApi()->webhookRespondOk();
} catch (\JPayApiLib\Exceptions\SignatureVerificationException $e) {
    http_response_code(400);
    echo 'Invalid signature';
}