Accept payments through external WayForPay buttons

In Kwiga, you can accept payments through payment buttons created directly in your WayForPay account. After a successful payment, the platform automatically registers the order and gives the buyer access to the corresponding offer.

To use external buttons, you first need to connect and set up WayForPay in Kwiga, as described in the separate article on connecting payment systems. You can then create external buttons and link them to offers.

How to connect an external payment button

Step 1. Create a button in Kwiga

1. Go to Settings → Payment systems and open the connected WayForPay account. How to connect the WayForPay payment system is described in this article

2. Find the "External payment buttons".

3. Click "Add button".

4. Enter a name for the button and select the offer the buyer should access after payment.

5. Save the settings.

After you create the button, Kwiga will generate a unique Service URL. Copy it — you'll need it to set up the payment button in WayForPay.

You can create as many external buttons as you need. Each button has its own offer and Service URL.

Step 2. Set up the button in WayForPay

1. Sign in to your WayForPay account.

2. Create a new payment button or open the settings for an existing one (see the Wayforpay).

3. In the Service URL field, enter the URL generated in Kwiga for the corresponding button (this field is highlighted in yellow in the screenshot below)

4. Save the settings.

Important: Service URL must be set separately for each WayForPay payment button. You don't need to change the store's general Service URL .

Step 3. Check the settings

Make sure that:

• the WayForPay account is connected and active in Kwiga;
• the button created in Kwiga is active;
• the correct offer is selected for the button;
• the corresponding WayForPay payment button has its Service URL

Each external WayForPay button must be linked to a separate button created in Kwiga.

How access is granted

After a successful payment, WayForPay sends a notification to the Service URL specified in the payment button settings.

Kwiga identifies the button by the address that received the notification and processes the payment for the linked offer.

When processing the notification, the platform checks the payment signature, amount, and currency. If the details match the offer price, Kwiga records the paid order, grants the buyer access, and sends a welcome email.

Repeated notifications for the same payment do not grant access again.

Please note: WayForPay does not include product information in the notification. Kwiga therefore uses the Service URL that received the notification to determine which offer to grant the buyer access to. Each button must have its own address and be linked to a specific offer.

If payment went through but access was not granted

If WayForPay accepts a payment but the amount is less than the offer price or the payment currency does not match the offer currency, Kwiga does not grant access automatically.

In this case, the school owner receives a notification about the payment issue and can check the payment and resolve it with the buyer.

To avoid this, make sure the amount and currency set in WayForPay match the price of the selected offer in Kwiga.