Requests
Issuers
The following issuers are currently supported for the Pay By Bank service:
| Bank | BIC code |
|---|---|
| ABN AMRO | ABNANL2A |
| ASN Bank | ASNBNL21 |
| ING | INGBNL2A |
| Knab | KNABNL2H |
| Rabobank | RABONL2U |
| SNS Bank | SNSBNL2A |
| SNS Regio Bank | RBRBNL21 |
| N26 | NTSBDEB1 |
| Belfius | GKCCBEBB |
| BNP Paribas Fortis | GEBABEBB |
| KBC | KREDBEBB100 |
| KBC Brussels | KREDBEBB387 |
| CBC | CREGBEBBNBB |
| ING | BBRUBEBB |
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 | Description |
|---|---|---|
| Issuer | string | The international bankcode identifying the customer's bank. |
| CountryCode | string | The consumer country. This needs to match the Issuer country. Possible values: NL and BE |
Basic parameters can be found Basic Parameters
Example Pay Request
{
"Currency": "EUR",
"AmountDebit": 0.01,
"Invoice": "PayByBank Pay 1687779829",
"Description": "PayByBank Pay",
"ContinueOnIncomplete": 1,
"Services": {
"ServiceList": [
{
"Name": "PayByBank",
"Action": "Pay",
"Parameters": [
{
"Name": "CountryCode",
"Value": "NL"
},
{
"Name": "Issuer",
"Value": "ABNANL2A"
}
]
}
]
}
}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",
"Description": "PayByBank Refund",
"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",
"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",
"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"
}
}Updated about 2 months ago