Create iDEAL Transaction

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:

  <th>
    Type
  </th>

  <th>
    Required
  </th>
</tr>

  <td>
    *decimal*
  </td>

  <td>
    <span style="color:#F37500">**required**</span>
  </td>
</tr>

<tr>
  <td>
    `currency`
  </td>

  <td>
    *string*
  </td>

  <td>
    <span style="color:#F37500">**required**</span>, value must be **EUR**
  </td>
</tr>

<tr>
  <td>
    `ideal-transaction`
  </td>

  <td>
    *container*
  </td>

  <td>
    <span style="color:#F37500">**required**</span> (see [ideal-transaction](ref:ideal-transaction))
  </td>
</tr>

<tr>
  <td>
    `merchant-transaction-id`
  </td>

  <td>
    *string*
  </td>

  <td>
    optional
  </td>
</tr>

<tr>
  <td>
    `payer-info`
  </td>

  <td>
    *container*
  </td>

  <td>
    optional for a new shopper (see [payer-info](ref:payer-info))
  </td>
</tr>

<tr>
  <td>
    `product-description`
  </td>

  <td>
    *string*
  </td>

  <td>
    optional
  </td>
</tr>

<tr>
  <td>
    `vaulted-shopper-id`
  </td>

  <td>
    *integer*
  </td>

  <td>
    optional for a vaulted shopper<br />The vaulted shopper's saved country must be **nl**.
  </td>
</tr>

<tr>
  <td>
    `vendors-info`
  </td>

  <td>
    *container*
  </td>

  <td>
    optional (see [vendors-info](ref:vendors-info))
  </td>
</tr>

Property
`amount`

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.