代付通知

代付 Webhook

POST/notify

代付完成后异步通知发送至创建代付时提交的 `notifyurl`。SDK 解析 `$_POST`、校验 MD5 签名并返回 `PayoutWebhookRequest`。处理完成后调用 `webhookRespondOk()`。

SDK 方法webhook()

参数请求体

memberidstring

平台分配的商户号。

out_trade_nostring

SDK 属性: outTradeNo. 商户代付订单号。

transaction_idstring

SDK 属性: transactionId. 平台交易号。

amountstring

订单提交金额。

actualamountstring

实际到账金额。

original_amountstring

SDK 属性: originalAmount. 扣费前原始金额。

datetimeint

交易时间。

transferMessagestring

转账结果说明。

statusstring

订单状态：`SUCCESS` 或 `FAIL`。

signstringsign

[MD5 签名算法说明](/docs/start#generate-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';
}