{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/alt-transactions/resolve","auth":"optional","settings":"57ee593a21ceb20e0061959e","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":"5f47d04a73b9340048cd8dcc"}],"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 (`processingStatus` 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 (`processingStatus` 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 `altTransaction` resource (see [altTransaction](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/json' \\\\\\n-H 'Accept: application/json' \\\\ \\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/json' \\\\\\n-H 'Accept: application/json' \\\\ \\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/json' \\\\\\n-H 'Accept: application/json' \\\\ \\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\": \"{\\n  \\\"amount\\\": 42,\\n  \\\"currency\\\": \\\"EUR\\\",\\n  \\\"payerInfo\\\": {\\n    \\\"firstName\\\": \\\"John\\\",\\n    \\\"lastName\\\": \\\"Doe\\\",\\n    \\\"country\\\": \\\"nl\\\"\\n  },\\n  \\\"vaultedShopperId\\\": 28538973,\\n  \\\"idealTransaction\\\": {\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"idealUrl\\\": \\\"https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819470000100001&MAC=1mIB9PXVj7r6tDRnFuIcOm31geLvBVGXXPYDubOunDM%3D\\\",\\n    \\\"orderId\\\": 18981947\\n  },\\n  \\\"processingInfo\\\": {\\n    \\\"processingStatus\\\": \\\"PENDING\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Order ID\"\n    },\n    {\n      \"code\": \"{\\n  \\\"transactionId\\\": \\\"1034522153\\\",\\n  \\\"amount\\\": 42,\\n  \\\"currency\\\": \\\"EUR\\\",\\n  \\\"payerInfo\\\": {\\n    \\\"firstName\\\": \\\"John_APPROVE\\\",\\n    \\\"lastName\\\": \\\"Doe\\\",\\n    \\\"country\\\": \\\"nl\\\"\\n  },\\n  \\\"vaultedShopperId\\\": 28557135,\\n  \\\"idealTransaction\\\": {\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"idealUrl\\\": \\\"https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000190142030000100001&MAC=tr3hV6qv1w%2FcylCCErNpAcYztZ95CQ41oN0yT09PwSw%3D\\\",\\n    \\\"orderId\\\": 19014203\\n  },\\n  \\\"transactionApprovalDate\\\": \\\"09/08/2020\\\",\\n  \\\"transactionApprovalTime\\\": \\\"10:22:44\\\",\\n  \\\"processingInfo\\\": {\\n    \\\"processingStatus\\\": \\\"SUCCESS\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Transaction ID\"\n    },\n    {\n      \"code\": \"{\\n  \\\"merchantTransactionId\\\": \\\"iDEAL-8202020\\\",\\n  \\\"amount\\\": 42,\\n  \\\"currency\\\": \\\"EUR\\\",\\n  \\\"payerInfo\\\": {\\n    \\\"firstName\\\": \\\"John\\\",\\n    \\\"lastName\\\": \\\"Doe\\\",\\n    \\\"country\\\": \\\"nl\\\"\\n  },\\n  \\\"vaultedShopperId\\\": 28538999,\\n  \\\"idealTransaction\\\": {\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"idealUrl\\\": \\\"https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823210000100001&MAC=t4kcRJx7phSCJer6mSz6m2rl4Ok39P36NHhjukdxDDM%3D\\\",\\n    \\\"orderId\\\": 18982321\\n  },\\n  \\\"processingInfo\\\": {\\n    \\\"processingStatus\\\": \\\"PENDING\\\"\\n  }\\n}\",\n      \"language\": \"json\",\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":"5f47d04a73b9340048cd8dcb","createdAt":"2020-08-27T15:24:58.525Z","user":"5ea72d649148ff00653f6bbc","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"iDEAL Transactions","slug":"ideal-transactions","order":5,"from_sync":false,"reference":false,"_id":"5f45521ec5bfe9005a858533","createdAt":"2020-08-25T18:02:06.263Z","version":"5f43d7db37d54d01d8ef0876","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.35 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5f43d7db37d54d01d8ef07cb","5f43d7db37d54d01d8ef07cc","5f43d7db37d54d01d8ef07cd","5f43d7db37d54d01d8ef07ce","5f43d7db37d54d01d8ef07cf","5f43d7db37d54d01d8ef07d0","5f43d7db37d54d01d8ef07d1","5f43d7db37d54d01d8ef07d2","5f43d7db37d54d01d8ef07d3","5f43d7db37d54d01d8ef07d4","5f43d7db37d54d01d8ef07d5","5f43d7db37d54d01d8ef07d6","5f43d7db37d54d01d8ef07d7","5f43d7db37d54d01d8ef07d8","5f43d7db37d54d01d8ef07d9","5f43d7db37d54d01d8ef07da","5f43d7db37d54d01d8ef07db","5f45521ec5bfe9005a858533"],"_id":"5f43d7db37d54d01d8ef0876","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5ed0377101fdb400214dedaa","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":36,"parentDoc":null}

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 (processingStatus 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 (processingStatus 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 altTransaction resource (see altTransaction).


Examples

Request Examples

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

Response Examples

{
  "amount": 42,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "nl"
  },
  "vaultedShopperId": 28538973,
  "idealTransaction": {
    "language": "en",
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819470000100001&MAC=1mIB9PXVj7r6tDRnFuIcOm31geLvBVGXXPYDubOunDM%3D",
    "orderId": 18981947
  },
  "processingInfo": {
    "processingStatus": "PENDING"
  }
}
{
  "transactionId": "1034522153",
  "amount": 42,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John_APPROVE",
    "lastName": "Doe",
    "country": "nl"
  },
  "vaultedShopperId": 28557135,
  "idealTransaction": {
    "language": "en",
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000190142030000100001&MAC=tr3hV6qv1w%2FcylCCErNpAcYztZ95CQ41oN0yT09PwSw%3D",
    "orderId": 19014203
  },
  "transactionApprovalDate": "09/08/2020",
  "transactionApprovalTime": "10:22:44",
  "processingInfo": {
    "processingStatus": "SUCCESS"
  }
}
{
  "merchantTransactionId": "iDEAL-8202020",
  "amount": 42,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "nl"
  },
  "vaultedShopperId": 28538999,
  "idealTransaction": {
    "language": "en",
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823210000100001&MAC=t4kcRJx7phSCJer6mSz6m2rl4Ok39P36NHhjukdxDDM%3D",
    "orderId": 18982321
  },
  "processingInfo": {
    "processingStatus": "PENDING"
  }
}

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 }}