| time | status | user agent | |
|---|---|---|---|
Retrieving recent requests… | |||
The Create iDEAL Transaction request performs a transaction using the iDEAL payment method. For implementation details, see the iDEAL guide.
Request Content
Send an alt-transaction container, with the following:
amount decimal required
currency string required value must be EUR
ideal-transaction container required (see ideal-transaction)
payer-info container optional include for a new shopper (see payer-info)
vaulted-shopper-id* integer optional include for a vaulted shopper
vendors-info container optional (see vendorsInfo)
merchant-transaction-id string optional
transaction-meta-data container optional (see transaction-meta-data)
* The vaulted shopper's saved country must be nl.
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:
vaulted-shopper-id
processing-info (see processing-info)
fraudResultInfo (see fraud-result-info)
Examples
Request Examples
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
</payer-info>
<ideal-transaction>
<return-url>http://www.returnURL.com</return-url>
</ideal-transaction>
</alt-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<currency>EUR</currency>
<ideal-transaction>
<language>ja</language>
<issuerid>INGBNL2A</issuerid>
<return-url>http://www.returnURL.com</return-url>
</ideal-transaction>
</alt-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>nl</country>
</payer-info>
<ideal-transaction>
<return-url>http://www.returnURL.com</return-url>
</ideal-transaction>
<vendors-info>
<vendor-info>
<vendor-id>837389</vendor-id>
</vendor-info>
</vendors-info>
</alt-transaction>'
Response Examples
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>nl</country>
</payer-info>
<vaulted-shopper-id>28539053</vaulted-shopper-id>
<ideal-transaction>
<ideal-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819530000100001&MAC=Un7qml6%2BNPSydoS8FAq2ksyDdjhIl0rAWm92dNZK1QI%3D</ideal-url>
<order-id>18981953</order-id>
</ideal-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<ideal-transaction>
<language>ja</language>
<ideal-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819550000100001&MAC=t%2F8AtqOf7FP0z%2By3FvyrL7A2hYpYiJSuClDRddXjnow%3D</ideal-url>
<order-id>18981955</order-id>
</ideal-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>
<alt-transaction xmlns="http://ws.plimus.com">
<vendors-info>
<vendor-info>
<vendor-id>837389</vendor-id>
<commission-percent>30</commission-percent>
</vendor-info>
</vendors-info>
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>nl</country>
</payer-info>
<vaulted-shopper-id>28539055</vaulted-shopper-id>
<ideal-transaction>
<ideal-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189824370000100001&MAC=KCenXRkPJCXKGrHUhwNAYsaKsOF7P22nvDXkcpITtVI%3D</ideal-url>
<order-id>18982437</order-id>
</ideal-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>
Example Descriptions
For details about the above examples, see:
- Create a basic iDEAL transaction with a new shopper
- Create an iDEAL transaction with a returning shopper
- Create an iDEAL transaction with a Marketplace vendor
Create a basic iDEAL transaction with a new shopper
This example shows a basic request with a new shopper whose details are included within payer-info. The return-url property specifies where the shopper should be redirected after they complete the payment. A successful response will include ideal-url, which is the URL you will need to direct the shopper to so they can complete their purchase.
Create an iDEAL transaction with a returning shopper
This example shows a request with a returning shopper whose ID is specified by the vaulted-shopper-id property. Note that the vaulted shopper must have a saved country of nl. The request includes issuer-id, which specifies the shopper's selected bank. This tells BlueSnap that the bank selection step can be skipped later in checkout - the shopper will be directed straight to their bank portal. Additionally, the request includes language, which specifies how the pages should be translated.
Create an iDEAL transaction with a Marketplace vendor
This example shows a request with a Marketplace vendor whose ID is specified by vendor-id. Additional vendors can be added to the transaction by including another vendor-info container within vendors-info.
API Explorer
To test out a call, enter the request content below and then click Try it!
Tip: Use the XML code below as a starting point. You can enter different parameters to see how your test scenario would work. The request headers, including authorization, are already built-in for you in this test area, so you should not include them here.
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
</payer-info>
<ideal-transaction>
<return-url>http://www.returnURL.com</return-url>
</ideal-transaction>
</alt-transaction>