Pay
The default action for iDEAL is Pay. This action requires as input the issuing bank of the consumer. Upon receiving this input, the consumer will be redirected to the issuing bank for verification and confirmation of the payment. An iDEAL payment has a lifetime of 15 minutes; this means that as soon as the consumer is redirected to the issuer, the payment must be completed within 15 minutes or it will expire. In the event that the consumer irregularly ends the payment process (for example by closing the browser window before returning to the webshop), the payment status will be retrieved from the acquirer as soon as the 15 minute lifespan is expired and the merchant webshop is updated via a push response. It is therefore recommended to enable the push response in the Payment Plaza when implementing iDEAL. A successful payment will include the BIC, the IBAN, the beneficiary of the bank account from which the payment was made and the name of the selected issuer.Base JSON request
Use the base request as instructed on this page
Create request
The Create request is a data request and is used to create a new wallet. It is possible to provide customer details but this is not required. Customer details can be added or updated at a later moment by the Update request. The WalletId must be unique, regardless of test or live. It is not possible to delete a wallet, but only to (de)activate it.
Parameters
Service specific parameters
Parameter | Type | Required | Description |
---|
WalletId | string | Yes | Unique identifier of the Buckaroo Wallet for the merchant. Should be provided when performing updates on the wallet. |
ConsumerFirstName | string | | First name of the customer |
ConsumerLastName | string | | Last name of the customer |
ConsumerEmail | string | | Email address of the customer |
ConsumerIban | string | | IBAN number of the customer. |
Example request
{
"Currency": "EUR",
"Services": {
"ServiceList": [
{
"Name": "BuckarooWalletCollecting",
"Action": "Create",
"Parameters": [
{
"Name": "WalletId",
"Value": "SomeMerchantUniqueValue"
},
{
"Name": "ConsumerFirstName",
"Value": "First Name"
},
{
"Name": "ConsumerLastName",
"Value": "Last Name"
},
{
"Name": "ConsumerEmail",
"Value": "test@gmail.com"
},
{
"Name": "ConsumerIban",
"Value": "NL13TEST0123456789"
}
]
}
]
}
}
Create response
Parameters
Service specific parameters
Parameter | Type | Required | Description |
---|
WalletGuid | string | | Unique identifier of the Wallet used by Buckaroo. |
WalletId | string | | Unique identifier of the Buckaroo Wallet for the merchant. Should be provided when performing updates on the wallet. |
Example response
{
"Key": "1757B313E57E4973997DD8C5235A3D48",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S001",
"Description": "Transaction successfully processed"
},
"DateTime": "2021-12-23T11:09:24"
},
"RequiredAction": null,
"Services": [
{
"Name": "BuckarooWalletCollecting",
"Action": null,
"Parameters": [
{
"Name": "WalletGuid",
"Value": "313BC97B38084203A4592A0515044"
},
{
"Name": "WalletId",
"Value": "SomeMerchantUniqueValue"
}
]
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "BuckarooWalletCollecting",
"IsTest": true,
"ConsumerMessage": null
}
Update
The Update request is a data request that can be used to update information of a wallet, with the exception of the WalletId itself. Additionally, the Wallet status can be updated.
Update request
Parameters
Service specific parameters
Parameter | Type | Required | Description |
---|
WalletId | string | Yes | Unique identifier of the Buckaroo Wallet for the merchant. Cannot be updated.. Should be provided to specify the wallet that needs to be updated. |
ConsumerFirstName | string | | First name of the customer |
ConsumerLastName | string | | Last name of the customer |
ConsumerEmail | string | | Email address of the customer |
ConsumerIban | string | | IBAN number of the customer. |
Status | string | | Status of the wallet. Possible values: Active, Disabled |
Example request
{
"Services": {
"ServiceList": [
{
"Name": "BuckarooWalletCollecting",
"Action": "Update",
"Parameters": [
{
"Name": "WalletId",
"Value": "SomeMerchantUniqueValue"
},
{
"Name": "ConsumerFirstName",
"Value": "First Name"
},
{
"Name": "ConsumerLastName",
"Value": "Last Name"
},
{
"Name": "ConsumerEmail",
"Value": "test@gmail.com"
},
{
"Name": "ConsumerIban",
"Value": "NL13TEST0123456789"
},
{
"Name": "Status",
"Value": "Disabled"
}
]
}
]
}
}
Update response
Parameters
Service specific parameters
Parameter | Type | Required | Description |
---|
WalletGuid | string | | Unique identifier of the Wallet used by Buckaroo. |
WalletId | string | | Unique identifier of the Buckaroo Wallet for the merchant. Should be provided when performing updates on the wallet. |
Example response
{
"Key": "1757B313E57E4973997DD8C5235A3D48",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S001",
"Description": "Transaction successfully processed"
},
"DateTime": "2021-12-23T11:09:24"
},
"RequiredAction": null,
"Services": [
{
"Name": "BuckarooWalletCollecting",
"Action": null,
"Parameters": [
{
"Name": "WalletGuid",
"Value": "313BC97B38084203A4592A0515044"
},
{
"Name": "WalletId",
"Value": "SomeMerchantUniqueValue"
}
]
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "BuckarooWalletCollecting",
"IsTest": true,
"ConsumerMessage": null
}
GetInfo
The GetInfo request is a data request that can be used to retrieve information of a Wallet.
GetInfo request
Parameters
Service specific parameters
Parameter | Type | Required | Description |
---|
WalletId | string | Yes | Unique identifier of the Buckaroo Wallet for the merchant. Cannot be updated.. Should be provided to specify the wallet that needs to be updated. |
Example request
{
"Services": {
"ServiceList": [
{
"Name": "BuckarooWalletCollecting",
"Action": "GetInfo",
"Parameters": [
{
"Name": "WalletId",
"Value": "SomeMerchantUniqueValue"
}
]
}
]
}
}
GetInfo response
Parameters
Service specific parameters
Parameter | Type | Required | Description |
---|
WalletGuid | string | | Unique identifier of the Wallet used by Buckaroo. |
WalletId | string | | Unique identifier of the Buckaroo Wallet for the merchant |
ConsumerFirstName | string | | First name of the customer |
ConsumerLastName | string | | Last name of the customer |
ConsumerEmail | string | | Email address of the customer |
ConsumerIban | string | | IBAN number of the customer. |
Status | string | | Status of the wallet |
Currency | string | | Currency of the wallet balance |
CurrentBalance | string | | Currence balance of the Wallet |
CurrentUsableBalance | string | | Balance that is usable for mutations like payments and withdrawals. |
Example response
{
"Key": "1757B313E57E4973997DD8C5235A3D48",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S001",
"Description": "Transaction successfully processed"
},
"DateTime": "2021-12-23T11:09:24"
},
"RequiredAction": null,
"Services": [
{
"Name": "BuckarooWalletCollecting",
"Action": null,
"Parameters": [
{
"Name": "WalletGuid",
"Value": "313BC97B38084203A4592A051504"
},
{
"Name": "WalletId",
"Value": "SomeMerchantUniqueValue"
},
{
"Name": "ConsumerFirstName",
"Value": "First Name"
},
{
"Name": "ConsumerLastName",
"Value": "Last Name"
{
"Name": "ConsumerEmail",
"Value": "test@gmail.com"
},
{
"Name": "ConsumerIban",
"Value": "NL13TEST0123456789"
},
{
"Name": "Status",
"Value": "Disabled"
},
{
"Name": "Currency",
"Value": "EUR"
},
{
"Name": "CurrentBalance",
"Value": "10.00"
},
{
"Name": "CurrentUsableBalance",
"Value": "10.00"
}
]
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "BuckarooWalletCollecting",
"IsTest": true,
"ConsumerMessage": null
}
Thank you for your feedback! Our team will get back to you