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

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"
      }
    ]
  }
}

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 2 months ago