Payconiq
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:
User chooses payment method
On your app or website, the user selects Payconiq as the payment method
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.
Return
After payment, the user is returned to the ReturnURL
that you specify in the payment request
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:
Parameter | Description |
---|---|
| The image format. Allowed values: |
| If the format is
Allowed values: |
| The color of the QR code. Default value: Allowed values: |
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.
Related resources
Was this page helpful?