​
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.
RegionBelgium, Luxembourg
CurrenciesEUR
RefundsYes, within 365 days
DisputesYes
PreauthorizationNo
Recurring paymentsNo

​
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
fThe image format.Allowed values: SVG, PNG
sIf 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
clThe color of the QR code.Default value: magentaAllowed 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.

Endpoint

The Payconiq PayIn object

Testing

Learn about testing Payconiq