Skip to content
Last updated

Why is this update happening?

This URL update marks the final phase in aligning our branding with the new Bancontact Pro identity.

Following the decommissioning of the Payconiq brand in Belgium, these changes are essential to ensure compliance. Please implement the necessary adaptations promptly to avoid service interruptions and guarantee the continued acceptance of mobile payments via Bancontact Pay and Wero.

For further information about this update or the instructions below, please reach out to our Dev Support Team at devsupport@bancontact.com

What is being updated?

For dynamic payments with single-usage QR codes generated over our API, the changes will be the following:

Impacted URLBeforeAfter
_links.qrcode.hrefhttps://qrcodegenerator.bancontact.net/qrcode? c=https://payconiq.com/pay/2/(transactionID)https://qrcodegenerator.api.bancontact.net/qrcode? c=https://pay.bancontact.net/pay/2/(transactionID)
_links.deeplink.hrefhttps://payconiq.com/pay/2/(transactionID)https://pay.bancontact.net/pay/2/(transactionID)

For static QR, invoice and on a receipt the change will be the following:

BeforeAfter
https://payconiq.com/t/1/(PPID)?D=(Description)&A=(Amount)&R=(Reference)https://pay.bancontact.net/t/1/(PPID)?D=(Description)&A=(Amount)&R=(Reference)

As part of this update, we will similarly be updating our checkout page in order to further improve M-Commerce (app-to-app) flow and reduce redirection errors. The change will be the following:

BeforeAfter
https://checkout.bancontact.net/?(...)https://pay.bancontact.net/?(...)

This update is already available for testing purposes in our pre-production environement, and will be released in production from 11/05/2026

Important note

For the time being the URLs sent by our API in pre-production will all be pay.acc.banconcat.net(...) and not pay.preprod.bancontact.net(...)

What changes for you?

This update does not impact our endpoints or our API version and should hence not require any major API upgrades on your end. Detailed changes by integration type can be found in the document below.

On a Display

If you are using our On a Display integration to generate a unique payment QR code and display on your cash register system or a consumer-facing screen, you will notice a change in the URL received in "_links"."qrcode"."href"

BeforeAfter

https://qrcodegenerator.api.bancontact.net/qrcode? c=https://payconiq.com/pay/2/txxengaql27rk7ct554x1lk6

https://qrcodegenerator.api.bancontact.net/qrcode? c=https://pay.bancontact.net/pay/2/txxengaql27rk7ct554x1lk6


As this change does not impact the generator, but only it's parameters (c=), this update should not have any impact over your integration. However, we recommend to use our pre-production environement to validate the changes on your end.

Online Sales

If you are using our Online Sales integration to propose E-Commerce or M-Commerce payments, you will notice a change in the URLs received in the following links

"_links"."qrcode"."href"

BeforeAfter
https://qrcodegenerator.api.bancontact.net/qrcode? c=https://payconiq.com/pay/2/txxengaql27rk7ct554x1lk6https://qrcodegenerator.api.bancontact.net/qrcode? c=https://pay.bancontact.net/pay/2/txxengaql27rk7ct554x1lk6

"_links"."deeplink"."href"

BeforeAfter
https://payconiq.com/pay/2/(transactionID)https://pay.bancontact.net/pay/2/(transactionID)

"_links"."checkout"."href"

BeforeAfter
https://checkout.bancontact.net/?checkoutApi=https(...)https://pay.bancontact.net/?checkoutApi=https(...)

This update may require you to update your firewall/security settings to ensure your website and/or application allow opening and/or redirection to the new deeplink and checkout URLs. We recommend to use our pre-production environement to validate the changes on your end.

On a Receipt or Top-Up

If you are using On a Receipt or TopUp to print fixed QR codes, you will need to make sure to update your URLs to stop using payconiq.com and instead move to pay.bancontact.net following the steps indicated below

ActivityComment
1. Obtain the pre-requisite information • Format of the QR code.
• Size of the QR code.
• Template URL scheme.
• Product profile ID of the merchant.
• Amount of the QR code.
• Description of the QR code.
• Reference of the QR code.
2. Build the service URL Optional parameters include:
• Image format (PNG or SVG)
• Image size (S, M, L, XL – PNG only)

Sample format:
https://qrcodegenerator.api.bancontact.net/qrcode?f={imageFormat}&s={ImageSize}&c=

Example Output URL (PNG):
https://qrcodegenerator.api.bancontact.net/qrcode?f=PNG&s=L&c=

Sample URL (SVG):
https://qrcodegenerator.api.bancontact.net/qrcode?f=SVG&c=
3. UTF-8 encode URL parameters Encode the following using UTF-8:
• Description
• Amount
• Reference

Unencoded parameters:
D=Receipt Payment
A=1000
R=sd89sd91?sd9

Encoded parameters:
D=Receipt%20Payment
A=1000
R=sd89sd91%3Fsd9
4. Build the URL payload Format:
https://pay.bancontact.net/t/1/{productProfileId}?D={Enc_description}&A={Enc_amount}&R={Enc_reference}

Example:
https://pay.bancontact.net/t/1/5c18cbd1296e9a26d3278518?D=Receipt%20Payment&A=1000&R=sd89sd91%3Fsd9
5. UTF-8 encode the URL payload Before Encoding:
https://pay.bancontact.net/t/1/5c18cbd1296e9a26d3278518?D=Receipt%20Payment&A=1000&R=sd89sd91%3Fsd9

After Encoding:
https%3A%2F%2Fpay.bancontact.net%2Ft%2F1%2F5c18cbd1296e9a26d3278518%3FD%3DReceipt%2520Payment%26A%3D1000%26R%3Dsd89sd91%253Fsd9
6. Combine service URL and encoded payload Full URL:
https://qrcodegenerator.api.bancontact.net/qrcode?f=PNG&s=XL&c=https%3A%2F%2Fpay.bancontact.net%2Ft%2F1%2F5c18cbd1296e9a26d3278518%3FD%3DReceipt%2520Payment%26A%3D1000%26R%3Dsd89sd91%253Fsd9

You can now execute the URL in a web view to obtain your QR Code and print it on the medium of your choice.

Important

If you have printed QR codes generated using the old www.payconiq.com URLs, the QR codes will remain valid until 15/06/2026. After that date, the QR codes may cease to work.

Static QR

If you are using Static QR and have a QR Code printed next to your cash register, you will need to make sure to update your URLs to stop using payconiq.com and instead move to pay.bancontact.net following the steps indicated below

ActivityComment
1. Obtain the pre-requisite information • Format of the QR code.
• Size of the QR code.
• Location URL scheme.
• Payment profile ID of the merchant.
• POS ID.
2. Build the service URL Sample format:
https://qrcodegenerator.api.bancontact.net/qrcode?f={imageFormat}&s={ImageSize}&c=

Example Output URL (PNG):
https://qrcodegenerator.api.bancontact.net/qrcode?f=PNG&s=L&c=

Sample URL (SVG):
https://qrcodegenerator.api.bancontact.net/qrcode?f=SVG&c=
3. UTF-8 encode URL parameters Encode the following using UTF-8:
• POS ID

Unencoded POS ID:
POS00001

Encoded POS ID:
POS00001
4. Build the URL payload Format:
https://pay.bancontact.net/l/1/{PaymentProfileId}/{POSId}

Example:
https://pay.bancontact.net/l/1/5bb37284e35e2b29e363df22/POS00001
5. UTF-8 encode the URL payload Before Encoding:
https://pay.bancontact.net/l/1/5bb37284e35e2b29e363df22/POS00001

After Encoding:
https%3A%2F%2Fpay.bancontact.net%2Fl%2F1%2F5bb37284e35e2b29e363df22%2FPOS00001
6. Combine service URL and encoded payload Full URL:
https://qrcodegenerator.api.bancontact.net/qrcode?f=PNG&s=XL&c=https%3A%2F%2Fpay.bancontact.net%2Fl%2F1%2F5bb37284e35e2b29e363df22%2FPOS00001

You can now execute the URL in a web view to obtain your Static QR Code and print it on the medium of your choice.

Important

If you have printed QR codes generated using the old www.payconiq.com URLs, the QR codes will remain valid until 15/06/2026. After that date, the QR codes may cease to work.