{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/alt-transactions","auth":"optional","settings":"57ee593a21ceb20e0061959e","results":{"codes":[]},"params":[],"examples":{"codes":[]},"method":"post"},"next":{"description":"","pages":[]},"title":"Create iDEAL Transaction","type":"endpoint","slug":"create-ideal-transaction","excerpt":"","body":"The Create iDEAL Transaction request performs a transaction using the iDEAL payment method. For implementation details, see the [iDEAL guide](/docs/ideal).\n\n<br>\n\n<a class=\"btn btn-success\" href=\"#section-api-explorer\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\nSend an **[altTransaction](doc:alt-transaction)** object, with the following:\n\n `amount` *decimal* <span style=\"color:#F37500\">**required**</span>\n `currency` *string* <span style=\"color:#F37500\">**required**</span> value must be **EUR**\n `idealTransaction` *object* <span style=\"color:#F37500\">**required**</span> (see [idealTransaction](doc:idealtransaction))\n `payerInfo` *object* <span style=\"color:#F37500\">**required**</span> for a new shopper (see [payerInfo](doc:payer-info))\n `vaultedShopperId`* *integer* <span style=\"color:#F37500\">**required**</span> for a vaulted shopper\n `vendorsInfo` *object* optional (see [vendorsInfo](doc:vendorsinfo))\n `merchantTransactionId` *string* optional\n `transactionMetaData` *object* optional (see [transactionMetaData](doc:transaction-meta-data))\n\n*The vaulted shopper's saved country must be **nl**.\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the request properties plus these additions:\n\n `vaultedShopperId`\n `processingInfo` (see [processingInfo](doc:processing-info))\n `fraudResultInfo` (see [fraudResultInfo](doc:fraud-result-info))\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 42,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"country\\\": \\\"nl\\\"\\n },\\n \\\"idealTransaction\\\": {\\n \\\"returnUrl\\\": \\\"http://www.returnURL.com\\\"\\n }\\n}'\",\n \"language\": \"curl\",\n \"name\": \"Create iDEAL Transaction: Basic with new shopper\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 57,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"vaultedShopperId\\\": 20769005,\\n \\\"idealTransaction\\\": {\\n \\\"language\\\": \\\"ja\\\",\\n \\\"issuerId\\\": \\\"INGBNL2A\\\",\\n \\\"returnUrl\\\": \\\"http://www.returnURL.com\\\"\\n }\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with returning shopper, language, & issuer ID\"\n },\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"amount\\\": 50,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"country\\\": \\\"nl\\\"\\n },\\n \\\"idealTransaction\\\": {\\n \\\"returnUrl\\\": \\\"http://www.returnURL.com\\\"\\n },\\n \\\"vendorsInfo\\\": {\\n \\\"vendorInfo\\\": [\\n {\\n \\\"vendorId\\\": 837389\\n }\\n ]\\n }\\n}'\",\n \"language\": \"curl\",\n \"name\": \"with marketplace vendor\"\n }\n ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"amount\\\": 42,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"country\\\": \\\"nl\\\"\\n },\\n \\\"vaultedShopperId\\\": 28538973,\\n \\\"idealTransaction\\\": {\\n \\\"idealUrl\\\": \\\"https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819470000100001&MAC=1mIB9PXVj7r6tDRnFuIcOm31geLvBVGXXPYDubOunDM%3D\\\",\\n \\\"orderId\\\": 18981947\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"PENDING\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Basic with new shopper\"\n },\n {\n \"code\": \"{\\n \\\"amount\\\": 57,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"vaultedShopperId\\\": 20769005,\\n \\\"idealTransaction\\\": {\\n \\\"issuerId\\\": \\\"INGBNL2A\\\",\\n \\\"language\\\": \\\"ja\\\",\\n \\\"idealUrl\\\": \\\"https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189819490000100001&MAC=X0DltkJtDMVsl1thPA%2BsQ3Zx3fXoZ5nrkgP53iRHW2E%3D\\\",\\n \\\"orderId\\\": 18981949\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"PENDING\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Returning shopper, language, & issuer ID\"\n },\n {\n \"code\": \"{\\n \\\"vendorsInfo\\\": {\\n \\\"vendorInfo\\\": [\\n {\\n \\\"vendorId\\\": 837389,\\n \\\"commissionPercent\\\": 30\\n }\\n ]\\n },\\n \\\"amount\\\": 50,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"country\\\": \\\"nl\\\"\\n },\\n \\\"vaultedShopperId\\\": 28538979,\\n \\\"idealTransaction\\\": {\\n \\\"idealUrl\\\": \\\"https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000189823150000100001&MAC=EjyS8ltyAnMY37AwFA7OjxqDJtjXv6GFZXSzjMEFlM4%3D\\\",\\n \\\"orderId\\\": 18982315\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"PENDING\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Marketplace vendor\"\n }\n ]\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Example Descriptions\nFor details about the above examples, see:\n* [Create a basic iDEAL transaction with a new shopper](#section-create-a-basic-ideal-transaction-with-a-new-shopper)\n* [Create an iDEAL transaction with a returning shopper](#section-create-an-ideal-transaction-with-a-returning-shopper)\n* [Create an iDEAL transaction with a Marketplace vendor](#section-create-an-ideal-transaction-with-a-marketplace-vendor)\n\n### Create a basic iDEAL transaction with a new shopper\nThis example shows a basic request with a new shopper whose details are included within `payerInfo`. The `returnUrl` property specifies where the shopper should be redirected after they complete the payment. A successful response will include `idealUrl`, which is the URL you will need to direct the shopper to so they can complete their purchase. \n\n### Create an iDEAL transaction with a returning shopper\nThis example shows a request with a returning shopper whose ID is specified by the `vaultedShopperId` property. Note that the vaulted shopper must have a saved country of **nl**. The request includes `issuerId`, which specifies the shopper's selected bank. This tells BlueSnap that the bank selection step can be skipped later in checkout - the shopper will be directed straight to their bank portal. Additionally, the request includes `language`, which specifies how the pages should be translated. \n\n### Create an iDEAL transaction with a Marketplace vendor\nThis example shows a request with a [Marketplace](/docs/marketplace-overview) vendor whose ID is specified by `vendorId`. Additional vendors can be added to the transaction by including another vendor object within `vendorInfo`. \n\n<br>\n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##API Explorer\nTo test out a call, enter the request content below and then click **Try it!**\n\n**Tip**: Use the JSON code below as a starting point. You can enter different parameters to see how your test scenario would work. *The request headers, including authorization, are already built in for you in this test area, so you should not include them here.*\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"amount\\\": 42,\\n \\\"currency\\\": \\\"EUR\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\"\\n },\\n \\\"idealTransaction\\\": {\\n \\\"returnUrl\\\": \\\"http://www.returnURL.com\\\"\\n }\\n}\",\n \"language\": \"json\"\n }\n ]\n}\n[/block]","updates":[],"order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"628531cd1258c8003f6dd26b","createdAt":"2020-08-25T18:04:22.184Z","user":"5ea72d649148ff00653f6bbc","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"iDEAL Transactions","slug":"ideal-transactions","order":4,"from_sync":false,"reference":false,"_id":"628531cd1258c8003f6dd1d0","createdAt":"2020-08-25T18:02:06.263Z","version":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.42 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628531cd1258c8003f6dd1bf","628531cd1258c8003f6dd1c0","628531cd1258c8003f6dd1c1","628531cd1258c8003f6dd1c2","628531cd1258c8003f6dd1c3","628531cd1258c8003f6dd1c4","628531cd1258c8003f6dd1c5","628531cd1258c8003f6dd1c6","628531cd1258c8003f6dd1c7","628531cd1258c8003f6dd1c8","628531cd1258c8003f6dd1c9","628531cd1258c8003f6dd1ca","628531cd1258c8003f6dd1cb","628531cd1258c8003f6dd1cc","628531cd1258c8003f6dd1cd","628531cd1258c8003f6dd1ce","628531cd1258c8003f6dd1cf","628531cd1258c8003f6dd1d0","628531cd1258c8003f6dd1d1","628531cd1258c8003f6dd1d2"],"_id":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"622783372cd60c003782d77e","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}
postCreate iDEAL Transaction
Definition
Documentation
The Create iDEAL Transaction request performs a transaction using the iDEAL payment method. For implementation details, see the iDEAL guide.
Request Content
Send an altTransaction object, with the following:
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
vendorsInfo
object optional (see vendorsInfo)
merchantTransactionId
string optional
transactionMetaData
object optional (see transactionMetaData)
*The vaulted shopper's saved country must be nl.
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:
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
}
]
}
}'
{
"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"
}
}
Example Descriptions
For details about the above examples, see:
- Create a basic iDEAL transaction with a new shopper
- Create an iDEAL transaction with a returning shopper
- Create an iDEAL transaction with a Marketplace vendor
Create a basic iDEAL transaction with a new shopper
This example shows a basic request with a new shopper whose details are included within payerInfo
. The returnUrl
property specifies where the shopper should be redirected after they complete the payment. A successful response will include idealUrl
, which is the URL you will need to direct the shopper to so they can complete their purchase.
Create an iDEAL transaction with a returning shopper
This example shows a request with a returning shopper whose ID is specified by the vaultedShopperId
property. Note that the vaulted shopper must have a saved country of nl. The request includes issuerId
, which specifies the shopper's selected bank. This tells BlueSnap that the bank selection step can be skipped later in checkout - the shopper will be directed straight to their bank portal. Additionally, the request includes language
, which specifies how the pages should be translated.
Create an iDEAL transaction with a Marketplace vendor
This example shows a request with a Marketplace vendor whose ID is specified by vendorId
. Additional vendors can be added to the transaction by including another vendor object within vendorInfo
.
API Explorer
To test out a call, enter the request content below and then click Try it!
Tip: Use the JSON code below as a starting point. You can enter different parameters to see how your test scenario would work. The request headers, including authorization, are already built in for you in this test area, so you should not include them here.
{
"amount": 42,
"currency": "EUR",
"payerInfo": {
"firstName": "John",
"lastName": "Doe"
},
"idealTransaction": {
"returnUrl": "http://www.returnURL.com"
}
}