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.