异步通知

Webhook 通知

POST/notify

异步通知发送至 `pay_notifyurl`。SDK 自动解析 `$_POST` 参数并**校验 MD5 签名**，验证通过后返回 `PaymentWebhookRequest`。处理完成后调用 `webhookRespondOk()` 响应 `OK`。

SDK 方法webhook()

参数请求体

memberidstringrequired

平台分配的商户号。

orderidstringrequired

商户订单号。

amountstringrequired

订单提交金额。

true_amountstringrequired

SDK 属性: trueAmount. 买家实际付款金额。

transaction_idstringrequired

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

returncodestringrequired

交易状态：`00` 成功；`2` 失败。

datetimestringrequired

交易时间。

signstringrequiredsign

[MD5 签名算法说明](/docs/start#generate-signature)

currencystring

支付币种。

attachstring

附加备注。

POST/notify

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

    if ($webhook->isSuccess()) {
        // Payment succeeded, update the order
        echo 'Order ID:' . $webhook->getOrderid();
    }

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