Refund Webhook

Refund Notify

POST/webhook/refund

Webhook notification sent when a refund is processed or fails. The SDK parses `$_POST`, verifies the MD5 signature, and returns a `RefundNotifyRequest`. Call `webhookRespondOk()` after processing.

SDK methodrefundNotify()

ParametersRequest body

memberidstring

Merchant ID

orderidstring

Merchant order ID

transaction_idstring

SDK property: transactionId. Platform transaction ID

amountstring

Original order amount

refund_orderidstring

SDK property: refundOrderid. Refund order ID

refund_amountstring

SDK property: refundAmount. Refunded amount

alert_datetimestring

SDK property: alertDatetime. Notification timestamp

alert_contentstring

SDK property: alertContent. Refund reason or failure description

alert_typestring

SDK property: alertType. Alert type

alert_statusstring

SDK property: alertStatus. `00` success; `11` failed

signstringsign

MD5 signature

POST/webhook/refund

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

    // Handle refund notification

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