Create iDEAL Transaction

❗️

Important

iDeal will be deprecated on July 1, 2024.

The Create iDEAL Transaction request performs a transaction using the iDEAL payment method. For implementation details, see the iDEAL guide.


📘

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

Send an altTransaction object, with the following:

PropertyTypeRequirement
amountdecimalrequired
currencystringrequired value must be EUR
productDescriptionstringoptional
idealTransactionobjectrequired (see idealTransaction)
payerInfoobjectrequired for a new shopper (see payerInfo)
vaultedShopperIdintegerrequired for a vaulted shopper

The vaulted shopper's saved country must be nl.
vendorsInfoobjectoptional (see vendorsInfo)
merchantTransactionIdstringoptional
transactionMetaDataobjectoptional (see transactionMetaData)

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:

PropertyNotes
vaultedShopperId
processingInfo(see processingInfo)
fraudResultInfo(see fraudResultInfo)

Back to Top


Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
  "amount": 42,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "nl"
  },
  "idealTransaction": {
    "returnUrl": "http://www.returnURL.com"
  }
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
  "amount": 57,
  "currency": "EUR",
  "vaultedShopperId": 20769005,
  "idealTransaction": {
    "language": "ja",
    "issuerId": "INGBNL2A",
    "returnUrl": "http://www.returnURL.com"
  }
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
  "amount": 50,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "nl"
  },
  "idealTransaction": {
    "returnUrl": "http://www.returnURL.com"
  },
  "vendorsInfo": {
    "vendorInfo": [
      {
        "vendorId": 837389
      }
    ]
  }
}'

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"
  }
}
{
  "amount": 57,
  "currency": "EUR",
  "vaultedShopperId": 20769005,
  "idealTransaction": {
    "issuerId": "INGBNL2A",
    "language": "ja",
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819490000100001&MAC=X0DltkJtDMVsl1thPA%2BsQ3Zx3fXoZ5nrkgP53iRHW2E%3D",
    "orderId": 18981949
  },
  "processingInfo": {
    "processingStatus": "PENDING"
  }
}
{
  "vendorsInfo": {
    "vendorInfo": [
      {
        "vendorId": 837389,
        "commissionPercent": 30
      }
    ]
  },
  "amount": 50,
  "currency": "EUR",
  "payerInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "country": "nl"
  },
  "vaultedShopperId": 28538979,
  "idealTransaction": {
    "idealUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823150000100001&MAC=EjyS8ltyAnMY37AwFA7OjxqDJtjXv6GFZXSzjMEFlM4%3D",
    "orderId": 18982315
  },
  "processingInfo": {
    "processingStatus": "PENDING"
  }
}

Back to Top


API Explorer

BlueSnap provides a sandbox environment so you can test basic requests with this endpoint. You can view the request in the API Explorer console and its response directly below the console.

The console includes a sample request with predefined parameter values. To send a request with custom values, edit the parameter fields below. As you edit the fields, your custom values display in the request in the console.

Click the Try it! button below the request example when you are ready to send your request.

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