About

Payconiq is a popular app-based payment method owned by the Bancontact Payconiq Group.

This guide concerns the Payconiq pay-in flow. See the Bancontact guide for more details about other Bancontact payment flows.

Region

Belgium, Luxembourg

Currencies

EUR

Refunds

Yes

Disputes

Yes

Preauthorization

No

Recurring payments

No

How it works

The Payconiq pay-in flow provides the following checkout experience:

1

User chooses payment method

On your app or website, the user selects Payconiq as the payment method

2

Redirection

On a website, you redirect the user to one of two pages to complete the payment:

  • Via the RedirectURL, to a hosted page showing the QR code and Payconiq by Bancontact branding and instructions.
  • To your payment page displaying the QR code available at the QRCodeURL value. You can lightly customize the color and format of this QR code (see below).

In an app-to-app flow, you redirect the user to their Payconiq by Bancontact app via the DeepLinkURL, where they confirm and authenticate the payment.

3

Return

After payment, the user is returned to the ReturnURL that you specify in the payment request

4

Outcome

The transaction is complete when the pay-in status changes from CREATED to SUCCEEDED or FAILED, indicating the outcome.

Hooks

You should also set up hook notifications for the relevant event types:

  • PAYIN_NORMAL_SUCCEEDED
  • PAYIN_NORMAL_FAILED

QR code customization

You can customize the QR code’s format, size, and color by adding query parameters to the QRCodeURL before redirecting the user.

For example:

r2/girogate.de/payconiq/qrcode?f=PNG?s=XL?cl=Black

The available options are:

ParameterDescription

f

The image format.

Allowed values: SVG, PNG

s

If the format is PNG, the image size in pixels of the QR code to generate:

  • S = 180 x 180
  • M = 250 x 250
  • L = 400 x 400
  • XL = 800 x 800

Allowed values: S, M, L, XL

cl

The color of the QR code.

Default value: magenta

Allowed values: magenta, black

Legacy integrations

Payconiq was previously available from Mangopay at the following endpoint URL:

/payins/payconiq/web

The legacy flow remains available for platforms with no changes required on their side. The new flow is identical to the old one with the exception of the QRCodeURL, which was not previously available.