{"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://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819470000100001&MAC=1mIB9PXVj7r6tDRnFuIcOm31geLvBVGXXPYDubOunDM%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://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000190142030000100001&MAC=tr3hV6qv1w%2FcylCCErNpAcYztZ95CQ41oN0yT09PwSw%3D</ideal-url>\\n <order-id>19014203</order-id>\\n </ideal-transaction>\\n <transaction-approval-date>09/08/2020</transaction-approval-date>\\n <transaction-approval-time>10:22: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://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823210000100001&MAC=t4kcRJx7phSCJer6mSz6m2rl4Ok39P36NHhjukdxDDM%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":"61a5208deadb750070998f3c","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":"61a5208deadb750070998e99","createdAt":"2020-08-27T16:49:20.046Z","version":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5208deadb750070998e87","61a5208deadb750070998e88","61a5208deadb750070998e89","61a5208deadb750070998e8a","61a5208deadb750070998e8b","61a5208deadb750070998e8c","61a5208deadb750070998e8d","61a5208deadb750070998e8e","61a5208deadb750070998e8f","61a5208deadb750070998e90","61a5208deadb750070998e91","61a5208deadb750070998e92","61a5208deadb750070998e93","61a5208deadb750070998e94","61a5208deadb750070998e95","61a5208deadb750070998e96","61a5208deadb750070998e97","61a5208deadb750070998e98","61a5208deadb750070998e99","61a5208deadb750070998e9a"],"_id":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60fed269718a45001c25b4a0","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":24,"parentDoc":null}
getRetrieve iDEAL Transaction
Definition
Parameters
Query Params
Documentation
This request gets details about a past iDEAL transaction.
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
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 '
<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://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819470000100001&MAC=1mIB9PXVj7r6tDRnFuIcOm31geLvBVGXXPYDubOunDM%3D</ideal-url>
<order-id>18981947</order-id>
</ideal-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>
<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://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000190142030000100001&MAC=tr3hV6qv1w%2FcylCCErNpAcYztZ95CQ41oN0yT09PwSw%3D</ideal-url>
<order-id>19014203</order-id>
</ideal-transaction>
<transaction-approval-date>09/08/2020</transaction-approval-date>
<transaction-approval-time>10:22:44</transaction-approval-time>
<processing-info>
<processing-status>SUCCESS</processing-status>
</processing-info>
</alt-transaction>
<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://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823210000100001&MAC=t4kcRJx7phSCJer6mSz6m2rl4Ok39P36NHhjukdxDDM%3D</ideal-url>
<order-id>18982321</order-id>
</ideal-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>