HomeGuidesAPI ReferenceChangelogPOS PaymentsOnline Payments
Home
API Reference

/paymentmethods/idealqr/v1/transactions

Reusable idealQR transactions only have open and expired statuses.
When a payment for an idealQR transaction is successful, the transaction status successful is updated only for non-reusable idealQR transactions, reusable ones will remain open until they expire.

  • QR_PAYMENT_CREATED webhook is triggered on each payment attempt (whether successful, failed, cancelled or expired).
    This is useful for both reusable and non-reusable idealQR transactions.
  • FINALSTATUS webhook is triggered when the transaction expires, or when the payment is successful (only for non-reusable idealQR transactions).
  • STATUS_CHANGE webhook is triggered when the transaction has any change in status. This is broader than FINALSTATUS
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
returnUrls
object
required
amountChangeable
object | null

Contains the minimum and maximum values for the amount of a QR code that a consumer can set themselves after scanning the code.

string
required
length between 1 and 255

Identifier from client. This value will be sent in the webhook payload alongside the ID you receive as part of the response of a transaction.

integer
required
1 to 99999999

Denomination in the smallest currency subunit, as for example eurocents.

string
length between 3 and 3
Defaults to EUR

ISO 4217 currency code

string
length between 1 and 35

Identification of the transaction within the merchant's system. Letters and numbers only.
Ultimately appears on the payment confirmation (statement and confirmation screen).

string
required
length ≤ 35

Description of the underlying value or reason of the payment.
Ultimately appears on the payment confirmation (statement and confirmation screen).

date-time
required
length ≥ 20

ISO 8601 date and time

boolean
Defaults to false

Indicates the qr code's ability to accept multiple successful payments

integer
required
100 to 2000
string

Preferred language of the user interface

webhooks
array of objects

Webhooks enable receiving a web request once a given event occurs.
We won't do preventive rate-limiting in order to have the highest throughput possible.
However, we will honor 429 (Too-many-requests) responses per callback.
We use the Retry-After header to retry after a certain period. If the header was not set we use our default exponential delay implementation.

webhooks
Responses

Callback
Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json