Create transaction

post

https://api.cm.com/idin/v1.0/transaction

Start an authentication or information request

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Start

merchant_token

string

required

a guid string that is unique and private to you as a merchant. Do not share this key, keep it safe. Example 3c01abeb-b031-4fea-9f2d-c55c283cd78e

identity

boolean

Retrieve an identifying token (bin) with the bank for this consumer that is consistent across multiple
sessions. When false returns a transient_id that will differ per transaction.

name

boolean

Retrieve the name information associated with this consumer

gender

boolean

Retrieve the gender of this consumer

address

boolean

Retrieve address information associated with this consumer

date_of_birth

boolean

Retrieve the birthdate of the user

18y_or_older

boolean

Retrieve if this user is known to be 18 years or older.

email_address

boolean

Retrieve the email address associated with this consumer.

telephone_number

boolean

Retrieve the telephone number associated with this consumer.

issuer_id

string

required

An identifier for the bank. Used as the value of the in bank selector dropdowns. The end user selects a value and iDIN will direct the end user to that bank, so that the user can identify himself.

entrance_code

string

required

length between 1 and 40

This is a token that will allow you to rejoin the user to his session when he returns. It can be a maximum of 40 characters and should only contain the characters a-z, A-z and 0-9. It should only be valid once and needs to be random enough (best use a cryptographically secure random generator), to avoid the possibility of replay attacks,.

merchant_return_url

string

required

length ≤ 512

The place where the bank should redirect the user to at the end of the flow. The bank will append two query parameters to this url when returning the user to you, trxid and ec. The latter will contain the value of entrance_code, trxid is the transaction_id that you will receive in this request. When not specified, a default can you be used which you specified with CM.

language

string

enum

length between 2 and 2

The 2 character language code in which to return the results. Can be either 'nl' or 'en' for Dutch or English. This is a preferred language, not all banks support all languages.

Allowed:

transaction_reference

string

length ≤ 255

A custom reference you can provide that we will add to the transaction, making it possible for you to distinguish transactions.

Responses

200Successful transaction

defaultAny non-compliant request will return an error object