Retrieve iDEAL Transaction

This request gets details about a past iDEAL transaction.

❗️

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

No content is required in the request body. Enter the relevant IDs in the request URL as path parameters.

Path Parameters

Path parametersTypeRequiredDescription
{merchantransactionId}integerrequired to retrieve transaction by merchant transaction ID and merchant ID.Unique identifier that the merchant assigned to the transaction.
{merchantId}integerrequired to retrieve transaction by merchant transaction ID and merchant ID.Unique identifier that BlueSnap assigned to the merchant.
{orderId}integerrequired to retrieve transaction by order ID.Unique identifier that BlueSnap assigned to the order.
{transactionId}integerrequired to retrieve by transaction.Unique identifier that BlueSnap assigned to the transaction.

By Order ID

BlueSnap returns the order ID in the idealTransaction object returned in the Create iDEAL Transaction response. Enter the orderId in the URL in the following format:

services/2/alt-transactions/resolve?orderId={orderId}

For example:

https://sandbox.bluesnap.com/services/2/alt-transactions/resolve?orderId=18981947

By Transaction ID

After the shopper completes their purchase, the processingStatus is updated to success, and the transation is assigned a transaction ID. BlueSnap provides the transaction ID as a query string parameter in the response URL.

Enter the transactionId in the URL in the following format:

services/2/alt-transactions/{transactionId}

For example:

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

By Merchant Transaction ID and Merchant ID

Enter the merchantTransactionId and merchantId in the URL in the following format:

services/2/alt-transactions/{merchantTransactionId},{merchantId}

For example:

https://sandbox.bluesnap.com/services/2/alt-transactions/iDEAL-8202020,500605

Response Details

Successful requests return the HTTP response status code 200 OK. The response contains the retrieved alt-transaction resource (see alt-transaction).

Examples

Request Examples

curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/resolve?orderId=18981947 \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/1034522153 \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/iDEAL-8202020,500605 \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '

Response Examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
  <amount>42</amount>
  <currency>EUR</currency>
  <payer-info>
    <first-name>John</first-name>
    <last-name>Doe</last-name>
    <country>nl</country>
  </payer-info>
  <vaulted-shopper-id>28538973</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;000000410000189819470000100001&#x26;MAC&#x3d;1mIB9PXVj7r6tDRnFuIcOm31geLvBVGXXPYDubOunDM&#x25;3D</ideal-url>
    <order-id>18981947</order-id>
  </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">
  <transaction-id>1034522153</transaction-id>
  <amount>42</amount>
  <currency>EUR</currency>
  <payer-info>
    <first-name>John_APPROVE</first-name>
    <last-name>Doe</last-name>
    <country>nl</country>
  </payer-info>
  <vaulted-shopper-id>28557135</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;000000410000190142030000100001&#x26;MAC&#x3d;tr3hV6qv1w&#x25;2FcylCCErNpAcYztZ95CQ41oN0yT09PwSw&#x25;3D</ideal-url>
    <order-id>19014203</order-id>
  </ideal-transaction>
  <transaction-approval-date>09&#x2f;08&#x2f;2020</transaction-approval-date>
  <transaction-approval-time>10&#x3a;22&#x3a;44</transaction-approval-time>
  <processing-info>
    <processing-status>SUCCESS</processing-status>
  </processing-info>
</alt-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
  <merchant-transaction-id>iDEAL-8202020</merchant-transaction-id>
  <amount>42</amount>
  <currency>EUR</currency>
  <payer-info>
    <first-name>John</first-name>
    <last-name>Doe</last-name>
    <country>nl</country>
  </payer-info>
  <vaulted-shopper-id>28538999</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;000000410000189823210000100001&#x26;MAC&#x3d;t4kcRJx7phSCJer6mSz6m2rl4Ok39P36NHhjukdxDDM&#x25;3D</ideal-url>
    <order-id>18982321</order-id>
  </ideal-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>

API Explorer (for request based on Order ID)

To test out a call, enter an existing order ID (e.g. 18981947) in the orderId field; this automatically inserts the ID into the request URL. Then, click Try it!.

Language
Credentials
Header
Click Try It! to start a request and see the response here!