{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/alt-transactions/resolve","auth":"optional","settings":"","results":{"codes":[]},"params":[{"name":"orderId","type":"int","default":"","desc":"Order ID received in the Create iDEAL Transaction response from BlueSnap","required":true,"in":"query","ref":"","_id":"5f47ecaefd4c2f03ad39a308"}],"examples":{"codes":[]},"method":"get"},"next":{"description":"","pages":[]},"title":"Retrieve iDEAL Transaction","type":"endpoint","slug":"retrieve-ideal-transaction","excerpt":"","body":"[block:html]\n{\n  \"html\": \"<script>\\n  // hide body textbox of API Explorer\\n $(document).ready(function() {\\n  $(\\\"textarea[placeholder='Body Content']\\\").hide();  \\n }); \\n</script>\"\n}\n[/block]\nThis request gets details about a past [iDEAL](/docs/ideal) transaction. \n\n<br />\n\n<a class=\"btn btn-success\" href=\"#section-api-explorer-for-request-based-on-transaction-id-\" role=\"button\">Try it in the API Explorer</a>\n\n\n### Request Content  \n\nNo content is required in the request body. Enter the relevant IDs in the request URL, as follows:\n\n**Retrieve based on  Order ID**\nThe order ID can be used to retrieve the transaction at any point. BlueSnap returns the order ID in the [Create iDEAL Transaction](doc:create-ideal-transaction) response. \n\nEnter the `orderId` into the web service URL, in the format:\n`services/2/alt-transactions/resolve?orderId={order ID}`\n\nFor example: `services/2/alt-transactions/resolve?orderId=18981947`\n\n**Retrieve based on  Transaction ID**\nIf the shopper has completed their purchase (`processing-status` is `success`), the transaction will be assigned a transaction ID. BlueSnap provides the transaction ID in your [return URL query string](/docs/ideal#section-return-url-query-string-parameters). \n\nEnter the `transactionId` into the web service URL, in the format:\n`services/2/alt-transactions/{transaction ID}`\n\nFor example: `services/2/alt-transactions/1034522153`\n\n**Note:** If the shopper has not completed their purchase (`processing-status` is `pending`), the transaction will not have a transaction ID yet, so you will need to retrieve based on order ID. \n\n**Retrieve based on Merchant Transaction ID and Merchant ID**\nEnter the `merchantTransactionId` and `merchantId` into the web service URL, in the format:\n`services/2/alt-transactions/{merchantTransactionId},{merchantId}`\n\nFor example: `services/2/alt-transactions/iDEAL-8202020,500605`\n\n### Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `alt-transaction` resource (see [alt-transaction](doc:alt-transaction)). \n\n<hr>\n\n##Examples\n  \n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/resolve?orderId=18981947 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve iDEAL Transaction by order ID\"\n    },\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/1034522153 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n      \"language\": \"curl\",\n      \"name\": \"by Transaction ID\"\n    },\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/iDEAL-8202020,500605 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n      \"language\": \"curl\",\n      \"name\": \"by Merchant Transaction ID and Merchant ID\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <amount>42</amount>\\n  <currency>EUR</currency>\\n  <payer-info>\\n    <first-name>John</first-name>\\n    <last-name>Doe</last-name>\\n    <country>nl</country>\\n  </payer-info>\\n  <vaulted-shopper-id>28538973</vaulted-shopper-id>\\n  <ideal-transaction>\\n    <language>en</language>\\n    <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>\\n    <order-id>18981947</order-id>\\n  </ideal-transaction>\\n  <processing-info>\\n    <processing-status>PENDING</processing-status>\\n  </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"Order ID\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <transaction-id>1034522153</transaction-id>\\n  <amount>42</amount>\\n  <currency>EUR</currency>\\n  <payer-info>\\n    <first-name>John_APPROVE</first-name>\\n    <last-name>Doe</last-name>\\n    <country>nl</country>\\n  </payer-info>\\n  <vaulted-shopper-id>28557135</vaulted-shopper-id>\\n  <ideal-transaction>\\n    <language>en</language>\\n    <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>\\n    <order-id>19014203</order-id>\\n  </ideal-transaction>\\n  <transaction-approval-date>09&#x2f;08&#x2f;2020</transaction-approval-date>\\n  <transaction-approval-time>10&#x3a;22&#x3a;44</transaction-approval-time>\\n  <processing-info>\\n    <processing-status>SUCCESS</processing-status>\\n  </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"Transaction ID\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <merchant-transaction-id>iDEAL-8202020</merchant-transaction-id>\\n  <amount>42</amount>\\n  <currency>EUR</currency>\\n  <payer-info>\\n    <first-name>John</first-name>\\n    <last-name>Doe</last-name>\\n    <country>nl</country>\\n  </payer-info>\\n  <vaulted-shopper-id>28538999</vaulted-shopper-id>\\n  <ideal-transaction>\\n    <language>en</language>\\n    <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>\\n    <order-id>18982321</order-id>\\n  </ideal-transaction>\\n  <processing-info>\\n    <processing-status>PENDING</processing-status>\\n  </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"Merchant Transaction ID and Merchant ID\"\n    }\n  ]\n}\n[/block]\n##API Explorer (for request based on Order ID)\nTo 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!**.","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"603d5be8af8f1a00611381b0","createdAt":"2020-08-27T17:25:22.298Z","user":"5ea72d649148ff00653f6bbc","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"iDEAL Transactions","slug":"ideal-transactions","order":4,"from_sync":false,"reference":false,"_id":"603d5be8af8f1a006113810d","createdAt":"2020-08-27T16:49:20.046Z","version":"603d5be8af8f1a00611381ba","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.37 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["603d5be8af8f1a00611380fb","603d5be8af8f1a00611380fc","603d5be8af8f1a00611380fd","603d5be8af8f1a00611380fe","603d5be8af8f1a00611380ff","603d5be8af8f1a0061138100","603d5be8af8f1a0061138101","603d5be8af8f1a0061138102","603d5be8af8f1a0061138103","603d5be8af8f1a0061138104","603d5be8af8f1a0061138105","603d5be8af8f1a0061138106","603d5be8af8f1a0061138107","603d5be8af8f1a0061138108","603d5be8af8f1a0061138109","603d5be8af8f1a006113810a","603d5be8af8f1a006113810b","603d5be8af8f1a006113810c","603d5be8af8f1a006113810d","603d5be8af8f1a006113810e"],"_id":"603d5be8af8f1a00611381ba","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5ff4b747849e1b03c50684c7","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":24,"parentDoc":null}

Payment API (XML)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

iDEAL Transactions

Local Bank Transfer transactions

SEPA Direct Debit Transactions

Sofort Transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

getRetrieve iDEAL Transaction

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

orderId:
required
integer
Order ID received in the Create iDEAL Transaction response from BlueSnap

Documentation

This request gets details about a past iDEAL transaction.


Try it in the API Explorer

Request Content

No content is required in the request body. Enter the relevant IDs in the request URL, as follows:

Retrieve based on Order ID
The order ID can be used to retrieve the transaction at any point. BlueSnap returns the order ID in the Create iDEAL Transaction response.

Enter the orderId into the web service URL, in the format:
services/2/alt-transactions/resolve?orderId={order ID}

For example: services/2/alt-transactions/resolve?orderId=18981947

Retrieve based on Transaction ID
If the shopper has completed their purchase (processing-status is success), the transaction will be assigned a transaction ID. BlueSnap provides the transaction ID in your return URL query string.

Enter the transactionId into the web service URL, in the format:
services/2/alt-transactions/{transaction ID}

For example: services/2/alt-transactions/1034522153

Note: If the shopper has not completed their purchase (processing-status is pending), the transaction will not have a transaction ID yet, so you will need to retrieve based on order ID.

Retrieve based on Merchant Transaction ID and Merchant ID
Enter the merchantTransactionId and merchantId into the web service URL, in the format:
services/2/alt-transactions/{merchantTransactionId},{merchantId}

For example: services/2/alt-transactions/iDEAL-8202020,500605

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved alt-transaction resource (see alt-transaction).

Examples

Request Examples

Retrieve iDEAL Transaction by order ID
by Transaction ID
by Merchant Transaction ID and Merchant ID
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

Order ID
Transaction ID
Merchant Transaction ID and Merchant ID
<?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>
    <language>en</language>
    <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>
  </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>
    <language>en</language>
    <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>
    <language>en</language>
    <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!.

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}