Home
HomeGuidesAPI ReferenceChangelogPOS PaymentsOnline Payments
Home
API Reference

Create iDEAL QR payment

post
https://example.com/api/v1/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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
returnUrls
object
required

URLs where the Consumer is redirected to after completing the transaction at its issuing bank or at the chosen payment method.

With this object we can redirect consumer to a dedicated page per payment result status. Either this object or the returnUrl field is mandatory.

string
required
length between 1 and 255

The clients identifier. 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 euro cents.

string
length between 3 and 3
Defaults to EUR

ISO 4217 currency code.

string
length between 2 and 2

Preferred language for the user interface as ISO 639-1 code. Commonly supported languages are Dutch (nl) and English (en).

webhooks
array of objects

Array of webhooks that enables 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
string
required
length ≤ 35

Description of the underlying value or reason of the payment.

Ultimately appears on the payment statement and confirmation screen.

date-time
length ≥ 20

ISO 8601 date and time.

amountChangeable
object

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

string
length between 1 and 35

Unique identification of the order within the Merchant's system. This value
appears on the bank statement of the Consumer.

The purchaseID can only contain letters and numbers.

boolean
Defaults to false

Indicates the QR code's ability to accept multiple successful payments.

integer
required
10 to 100

The number of elements to be returned in the response

Responses

Updated about 1 month ago

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

Updated about 1 month ago