Retrieve iDEAL Transaction

This request retrieves data about a past iDEAL transaction.

Request Content

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

Path Parameters

Path parameters	Type	Required	Description
{merchantTransactionId}	integer	required to retrieve transaction by merchant transaction ID and merchant ID.	Unique identifier that the merchant assigned to the transaction.
{merchantId}	integer	required to retrieve transaction by merchant transaction ID and merchant ID.	Unique identifier that BlueSnap assigned to the merchant.
{orderId}	integer	required to retrieve transaction by order ID.	Unique identifier that BlueSnap assigned to the order.
{transactionId}	integer	required 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 and a response body that contains the following properties:

Property	Notes
`amount`	Value of the transaction in the provided currency.
`currency`	Currency used to process the transaction (`EUR`).
`idealTransaction`	See idealTransaction.
`payerInfo`	Returned when the shopper is a not a vaulted shopper . See payerInfo .
`processingInfo`	Status of the transaction. See processingInfo .
`vaultedShopperId`	Unique identifier for the vaulted shopper .

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": {
    "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",
    "lastName": "Doe",
    "country": "nl"
  },
  "vaultedShopperId": 28557135,
  "idealTransaction": {
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000190142030000100001&MAC=tr3hV6qv1w%2FcylCCErNpAcYztZ95CQ41oN0yT09PwSw%3D",
    "orderId": 19014203
  },
  "transactionApprovalDate": "09/08/2024",
  "transactionApprovalTime": "10:22:44",
  "processingInfo": {
    "processingStatus": "SUCCESS"
  }
}

{
  "merchantTransactionId": "iDEAL-8202020",
  "amount": 42,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "nl"
  },
  "vaultedShopperId": 28538999,
  "idealTransaction": {
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823210000100001&MAC=t4kcRJx7phSCJer6mSz6m2rl4Ok39P36NHhjukdxDDM%3D",
    "orderId": 18982321
  },
  "processingInfo": {
    "processingStatus": "PENDING"
  }
}

API Explorer

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