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.

Go to Plans and Prices.
Create (or edit) each price you want to sell.
Set External code ID to the corresponding Billerix price/offer identifier.
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:

Create (or edit) a paywall and set Payment system = Billerix.
Add your Billerix prices to this paywall.
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)

Scheme	PAN	CVV	Expiration date	Result
Visa	`4242 4242 4242 4242`	Any	Any	`AUTHORIZED -> CAPTURED`
Visa	`4485 0403 7153 6584`	Any	Any	`SETTLED`

Success (3DS)

Scheme	PAN	CVV	Expiration date	Result
Visa	`4010 0617 0000 0021`	Any	Any	3DS page, `AUTHORIZED -> CAPTURED`

Declines

Scheme	PAN	CVV	Expiration date	Result
MC	`5333 4755 7220 0849`	Any	Any	`Insufficient Funds`
Visa	`4000 1574 5462 7969`	Any	Any	`Lost/Stolen`
Visa	`4556 1041 6038 2032`	Any	Any	`Current BIN was blacklisted`

Source: Billerix Test Cards