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

📘
Tip
You can test out a request that hits our sandbox in real-time. Follow the instructions here to use the "Try It!" feature on the right side.

Request Content

Send an altTransaction object, with the following:

Property	Type	Requirement
`amount`	decimal	required
`currency`	string	required value must be EUR
`idealTransaction`	object	required (see idealTransaction)
`payerInfo`	object	required for a new shopper (see payerInfo)
`vaultedShopperId`	integer	required for a vaulted shopper The vaulted shopper's saved country must be nl.
`vendorsInfo`	object	optional (see vendorsInfo)
`merchantTransactionId`	string	optional
`transactionMetaData`	object	optional (see transactionMetaData)

Response Details

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

Property	Notes
`vaultedShopperId`
`processingInfo`	(see processingInfo)
`fraudResultInfo`	(see fraudResultInfo)

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

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

API Explorer

To test out a basic API request, click the "Try It!" button in the right-hand column to test using the default, pre-populated sample values. To test with your own values, edit the parameter fields below. You'll see them populate in the right-hand column and you can click the "Try It!" button to submit your test request and see a response.