Create iDEAL Transaction

👍
Coming Soon!

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

❗️
Important
The API Explorer Try It! feature does not currently send XML requests to our sandbox environment.
For request and response examples, refer to the Examples section.

Request Content

Send an alt-transaction container, with the following:

Property	Type	Required
`amount`	decimal	required
`currency`	string	required, value must be EUR
`ideal-transaction`	container	required (see ideal-transaction)
`merchant-transaction-id`	string	optional
`payer-info`	container	optional for a new shopper (see payer-info)
`product-description`	string	optional
`vaulted-shopper-id`	integer	optional for a vaulted shopper The vaulted shopper's saved country must be nl.
`vendors-info`	container	optional (see vendors-info)

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:

Property	Notes
`fraudResultInfo`	(see fraud-result-info)
`processing-info`	(see processing-info)
`vaulted-shopper-id`

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>
    <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>
  </ideal-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
    <transaction-region>UK</transaction-region>
  </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>
    <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>
  </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>
  </ideal-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>

API Explorer

To test out a basic API request, click the "Try It!" button in the right-hand column to test using the default, pre-populated sample values. To test with your own values, edit the parameter fields below. You'll see them populate in the right-hand column and you can click the "Try It!" button to submit your test request and see a response.