Requests
Requests
Article Summary
Share feedback
Thanks for sharing your feedback!
Issuers
The following issuers are currently supported for the Pay By Bank service:
Bank | BIC code | Logo |
---|---|---|
ABN AMRO | ABNANL2A | |
ASN Bank | ASNBNL21 | |
ING | INGBNL2A | |
Knab | KNABNL2H | |
Rabobank | RABONL2U | |
SNS Bank | SNSBNL2A | |
SNS Regio Bank | RBRBNL21 | |
N26 | NTSBDEB1 |
Pay
The Pay action is the default action for the service Pay By Bank. With this action a new transaction will be initiated via Pay By Bank.
Base JSON request
Use the base request as instructed on this page
Pay request
Service specific parameters
Parameter | Type | Required | Recommended | Description |
---|---|---|---|---|
Issuer | string | The international bankcode identifying the customer's bank. This information can be supplied, otherwise the customer has to select their bank at the Buckaroo Checkout | ||
CountryCode | string | The consumer country. This needs to match the Issuer country. Possible values: NL |
Basic parameters
Example Pay Request
{
"Currency": "EUR",
"AmountDebit": 0.01,
"AmountCredit": null,
"Invoice": "PayByBank Pay 1687779829",
"Order": null,
"Description": "PayByBank Pay",
"ClientIP": null,
"ReturnURL": "https://www.buckaroo.nl",
"ReturnURLCancel": "https://www.buckaroo.nl/Cancel",
"ReturnURLError": "https://www.buckaroo.nl/Error",
"ReturnURLReject": "https://www.buckaroo.nl/Reject",
"OriginalTransactionKey": null,
"ContinueOnIncomplete": 1,
"ServicesSelectableByClient": null,
"ServicesExcludedForClient": null,
"ClientUserAgent": null,
"OriginalTransactionReference": null,
"Services": {
"ServiceList": [
{
"Name": "PayByBank",
"Action": "Pay",
"Version": 0,
"Parameters": []
}
]
},
"CustomParameters": null,
"AdditionalParameters": null
}
Pay response
Example Pay response
{
"Key": "55CE921852E64A5D9D11428EC8A619C8",
"Status": {
"Code": {
"Code": 790,
"Description": "Pending input"
},
"SubCode": null,
"DateTime": "2023-06-26T13:43:46"
},
"RequiredAction": {
"RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=50223B2DF23843688F054A9B761D4C06",
"RequestedInformation": null,
"PayRemainderDetails": null,
"Name": "Redirect",
"TypeDeprecated": 0
},
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "PayByBank Pay 1687779829",
"ServiceCode": null,
"IsTest": false,
"Currency": "EUR",
"AmountDebit": 0.01,
"TransactionType": null,
"MutationType": 0,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": null
}
Pay push
Example push
{
"Transaction": {
"Key": "55CE921852E64A5D9D11428EC8A619C8",
"Invoice": "PayByBank Pay 1687779829",
"ServiceCode": "PayByBank",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S060",
"Description": "The consumer returned, confirm was successful."
},
"DateTime": "2023-06-26T13:44:30"
},
"IsTest": false,
"Order": null,
"Currency": "EUR",
"AmountDebit": 0.01,
"TransactionType": "C122",
"Services": [
{
"Name": "PayByBank",
"Action": null,
"Parameters": [
{
"Name": "consumerIssuer",
"Value": "ABN AMRO"
},
{
"Name": "consumerBIC",
"Value": "ABNANL2A"
},
{
"Name": "consumerName",
"Value": "J de Tester"
},
{
"Name": "consumerIBAN",
"Value": "NL21ABNA0123456789"
}
],
"VersionAsProperty": 1
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": null,
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": "77916f9443cbd8d4619425e10bbe3c5007d81059f3f01bef4712ed905011cd98de68a20e0af0b6ab48d00ee85fee809a774db5b0d4d41530258c************",
"PaymentKey": "8935056DFAB942DB8F**************",
"Description": "PayByBank Pay"
}
}
Refund
Base JSON request
Use the base request as instructed on this page
Example Request
{
"Currency": "EUR",
"AmountCredit": 0.01,
"Invoice": "PayByBank Refund {{#buck_timestamp}}",
"Description": "PayByBank Refund",
"ReturnUrl": "https://www.buckaroo.nl",
"ReturnUrlCancel": "https://www.buckaroo.nl/Cancel",
"ReturnUrlError": "https://www.buckaroo.nl/Error",
"ReturnUrlReject": "https://www.buckaroo.nl/Reject",
"OriginalTransactionKey": "77649A0E685A4B068AD*************",
"Services": {
"ServiceList": [
{
"Name": "PayByBank",
"Action": "Refund"
}
]
}
}
Example response
{
"Key": "EBC1131ECB3E4B739C95F042A073122A",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2023-06-26T14:46:22"
},
"RequiredAction": null,
"Services": [
{
"Name": "PayByBank",
"Action": null,
"Parameters": [
{
"Name": "customeraccountname",
"Value": "J de Teser"
},
{
"Name": "CustomerIBAN",
"Value": "NL21ABNA0123456789"
},
{
"Name": "Processed",
"Value": "Classic"
}
]
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "PayByBank Refund 1687783585",
"ServiceCode": "PayByBank",
"IsTest": false,
"Currency": "EUR",
"AmountCredit": 0.01,
"TransactionType": "C123",
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "77649A0E685A4B068ADB************"
}
],
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": "J de Tester",
"PayerHash": null,
"PaymentKey": "0584D89AA7BA4DAABCBD************"
}
Example push
{
"Transaction": {
"Key": "EBC1131ECB3E4B739C95************",
"Invoice": "PayByBank Refund 1687783585",
"ServiceCode": "PayByBank",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2023-06-26T14:46:22"
},
"IsTest": false,
"Order": null,
"Currency": "EUR",
"AmountCredit": 0.01,
"TransactionType": "C123",
"Services": [
{
"Name": "PayByBank",
"Action": null,
"Parameters": [
{
"Name": "customeraccountname",
"Value": "J de Tester"
},
{
"Name": "CustomerIBAN",
"Value": "NL21ABNA0123456789"
},
{
"Name": "Processed",
"Value": "Classic"
}
],
"VersionAsProperty": 1
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "77649A0E685A4B068ADBF************"
}
],
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": "J de Tester",
"PayerHash": null,
"PaymentKey": "0584D89AA7BA4DAABCBD************",
"Description": "PayByBank Refund"
}
}
Was this article helpful?