BlueSnap.comAPI BasicsPayment APIEmbedded PaymentsReporting & ToolsSupport GuidesTest
API Reference

Create iDEAL Transaction

post https://sandbox.bluesnap.com/services/2/alt-transactions

The Create iDEAL Transaction request performs a transaction using the iDEAL payment method. For implementation details, see the iDEAL guide.


Try it in the API Explorer

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000189819530000100001&#x26;MAC&#x3d;Un7qml6&#x25;2BNPSydoS8FAq2ksyDdjhIl0rAWm92dNZK1QI&#x25;3D</ideal-url>
    <order-id>18981953</order-id>
  </ideal-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000189819550000100001&#x26;MAC&#x3d;t&#x25;2F8AtqOf7FP0z&#x25;2By3FvyrL7A2hYpYiJSuClDRddXjnow&#x25;3D</ideal-url>
    <order-id>18981955</order-id>
  </ideal-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000189824370000100001&#x26;MAC&#x3d;KCenXRkPJCXKGrHUhwNAYsaKsOF7P22nvDXkcpITtVI&#x25;3D</ideal-url>
    <order-id>18982437</order-id>
  </ideal-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>

Back to Top

Example Descriptions

For details about the above examples, see:

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.


Back to Top

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>
Language
Credentials
:
Click Try It! to start a request and see the response here!