Billerix Integration

1) Add Billerix keys in Project Settings

Open:

Project settings -> Payments -> Billerix

Fill both key groups:

• Production keys
  • Public key
  • Secret key
  • Merchant / service code
• Sandbox keys
  • Public key (sandbox)
  • Secret key (sandbox)
  • Merchant / service code (sandbox)

Web2Wave automatically chooses which key group to use by the selected price mode:

• price.plan.livemode = true -> Production
• price.plan.livemode = false -> Sandbox

---

2) Create prices manually and set external_id

Create prices in Web2Wave manually and link them to your Billerix offers.

1. Go to Plans and Prices.
2. Create (or edit) each price you want to sell.
3. Set External code ID to the corresponding Billerix price/offer identifier.
4. Make sure mode is correct:
   • live prices for Production
   • test prices for Sandbox

Important: checkout requests are created for a specific price_id, and Web2Wave uses that price's plan.livemode to decide which Billerix environment/keys to call.

---

3) Configure paywall for Billerix

After keys and prices are ready:

1. Create (or edit) a paywall and set Payment system = Billerix.
2. Add your Billerix prices to this paywall.
3. Add the Billerix form block to the paywall in the place where checkout must be shown.

---

4) Use Billerix test cards

Use Billerix test cards for sandbox validation.

Postal code (required for all cards): SW1A 1AA

Success (non-3DS)

Success (3DS)

Declines

Source: Billerix Test Cards