Webhook

Webhook

POST/notify

Asynchronous notification sent to `pay_notifyurl`. The SDK automatically parses parameters from `$_POST` and **verifies the MD5 signature**. After verification succeeds, it returns a `PaymentWebhookRequest`. Once processing is complete, call `webhookRespondOk()` to respond with `OK`.

SDK methodwebhook()

ParametersRequest body

memberidstringrequired

Merchant ID

orderidstringrequired

Merchant order ID

amountstringrequired

Submitted order amount

true_amountstringrequired

SDK property: trueAmount. Amount actually paid

transaction_idstringrequired

SDK property: transactionId. Platform transaction ID

returncodestringrequired

`00` success; `2` failed

datetimestringrequired

Transaction time

signstringrequiredsign

MD5 signature

currencystring

Payment currency

attachstring

Additional notes

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';
}