Webhooks

Once your user has used the payment button and paid, it's time listening for webhooks.

Setup your URL

Navigate to your shop and click on the cogwheel bottom left. Click on the developer tab. Type your "Webhook URL" and click setup.

Automatic Retrying

We will continue to send webhook messages until we receive a 200 ok from the endpoint you've setup. Because of that we do recommend that you setup a check for duplicate transactions.

Each retry will be exponentially delayed depending on how many time the message failed, so we don't spam your servers.

Verify Signature

In each request we add a "RDG_WH_SIGNATURE" variable. You can use your secret key (found in the developers tab), to verify the request is from us.

<?php
define('SECRET_KEY', '123test');
$request= json_decode(file_get_contents("php://input"), true);
if (!check_signature($request)) {
header("Status: 401 Unauthorized");
exit;
}
function check_signature($request) {
return $signature === hash_hmac(
'sha256',
$request['order']['transaction_id'] . $request['status'],
SECRET_KEY
);
}

Payment Statuses

Name

Description

completed

The payment is fully completed.

waiting for payment

The order is currently waiting for the customer to pay.

refunded

The order was refunded.

disputed

The order has an open dispute.

dispute canceled

The dispute was canceled / won, it will also change to completed status.

reversed

The dispute was lost, the money has been returned to the customer.

To see the payload the different statuses will send in the webhook, go to the next step below.