Retrieve iDEAL Transaction

❗️

Important

After September 30, 2024, BlueSnap will temporarily suspend processing iDEAL transactions. BlueSnap support for iDEAL 2.0 is coming soon.

This request gets details about a past iDEAL transaction.


📘

Send a test request

Go to API Explorer to send a test request to our sandbox environment and receive a response in real time.

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",
    "transactionRegion": "UK"
  }
}
{
  "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"
  }
}

Back to Top


API Explorer

Order ID Request

To test out a call, enter an existing order ID in the orderId field. This automatically inserts the ID into the request URL in the right-hand column.

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