Requests

      Requests


        Article Summary

        Issuers

        The following issuers are currently supported for the Pay By Bank service:

        BankBIC codeLogo
        ABN AMROABNANL2A
        ASN BankASNBNL21
        INGINGBNL2A
        KnabKNABNL2H
        RabobankRABONL2U
        SNS BankSNSBNL2A
        SNS Regio BankRBRBNL21
        N26NTSBDEB1

        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

        ParameterTypeRequiredRecommendedDescription
        IssuerstringThe international bankcode identifying the customer's bank. This information can be supplied, otherwise the customer has to select their bank at the Buckaroo Checkout
        CountryCodestringThe consumer country. This needs to match the Issuer country. Possible values: NL and BE
        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"
              }
            ]
          }
        }
        

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

        Was this article helpful?

        What's Next