Requests

      Requests


        Article Summary

        Pay

        Base JSON request

        Use the base request as instructed on this page

        Parameters

        Basic parameters

        Pay request

        Example request

        {
          "Currency": "EUR",
          "AmountDebit": 10.00,
          "Invoice": "testinvoice 123",
          "ClientIP": {
              "Type": 0,
              "Address": "0.0.0.0"
           },
          "Services": {
            "ServiceList": [
              {
                "Name": "belfius",
                "Action": "Pay"
              }
            ]
          }
        }
        

        Pay response

        Example response:

        {
            "Key": "47C50AD98B7B45918DE69CXXXXXXXXXX",
            "Status": {
                "Code": {
                    "Code": 791,
                    "Description": "Pending processing"
                },
                "SubCode": {
                    "Code": "S002",
                    "Description": "An additional action is required: Redirect to Belfius"
                },
                "DateTime": "2021-05-19T11:52:17"
            },
            "RequiredAction": {
                "RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=6DF0BFAAF4554AEF966296XXXXXXXXXX",
                "RequestedInformation": null,
                "PayRemainderDetails": null,
                "Name": "Redirect",
                "TypeDeprecated": 0
            },
            "Services": null,
            "CustomParameters": null,
            "AdditionalParameters": null,
            "RequestErrors": null,
            "Invoice": "BelfiusTest",
            "ServiceCode": "Belfius",
            "IsTest": false,
            "Currency": "EUR",
            "AmountDebit": 10.00,
            "TransactionType": "C076",
            "MutationType": 1,
            "RelatedTransactions": null,
            "ConsumerMessage": null,
            "Order": null,
            "IssuingCountry": null,
            "StartRecurrent": false,
            "Recurring": false,
            "CustomerName": "Customer Unknown",
            "PayerHash": null,
            "PaymentKey": "440115C934F448FE8BE44BXXXXXXXXXX"
        }
        

        Pay push

        Example push

        {
           "Transaction":{
              "Key":"47C50AD98B7B45918DE69CXXXXXXXXXX",
              "Invoice":"BelfiusTest",
              "ServiceCode":"Belfius",
              "Status":{
                 "Code":{
                    "Code":190,
                    "Description":"Success"
                 },
                 "SubCode":{
                    "Code":"S990",
                    "Description":"The request was successful."
                 },
                 "DateTime":"2021-05-19T11:54:32"
              },
              "IsTest":false,
              "Order":null,
              "Currency":"EUR",
              "AmountDebit":10.00,
              "TransactionType":"C076",
              "Services":null,
              "CustomParameters":null,
              "AdditionalParameters":null,
              "MutationType":1,
              "RelatedTransactions":null,
              "IsCancelable":false,
              "IssuingCountry":null,
              "StartRecurrent":false,
              "Recurring":false,
              "CustomerName":"Customer Unknown",
              "PayerHash":null,
              "PaymentKey":"440115C934F448FE8BE44BXXXXXXXXXX"
           }
        }
        

        Refund

        Parameters

        Basic parameters

        Refund request

        Example request

        {
          "Currency": "EUR",
          "AmountCredit": 10.00,
          "Invoice": "BelfiusTest",
          "OriginalTransactionKey": "47C50AD98B7B45918DE69CXXXXXXXXXX",
          "Services": {
            "ServiceList": [
              {
                "Name": "belfius",
                "Action": "Refund"
              }
            ]
          }
        }
        

        Refund response

        {
            "Key": "F996EE747ECD43CDA8851C5F83XXXXXX",
            "Status": {
                "Code": {
                    "Code": 190,
                    "Description": "Success"
                },
                "SubCode": {
                    "Code": "S001",
                    "Description": "Transaction successfully processed"
                },
                "DateTime": "2021-05-19T12:03:45"
            },
            "RequiredAction": null,
            "Services": [
                {
                    "Name": "belfius",
                    "Action": null,
                    "Parameters": [
                        {
                            "Name": "customeraccountname",
                            "Value": "J. de Tèster"
                        },
                        {
                            "Name": "CustomerIBAN",
                            "Value": "NL44RABO0123456789"
                        },
                        {
                            "Name": "CustomerBIC",
                            "Value": "RABONL2U"
                        }
                    ]
                }
            ],
            "CustomParameters": null,
            "AdditionalParameters": null,
            "RequestErrors": null,
            "Invoice": "BelfiusTest",
            "ServiceCode": "belfius",
            "IsTest": true,
            "Currency": "EUR",
            "AmountCredit": 1,
            "TransactionType": "C077",
            "MutationType": 1,
            "RelatedTransactions": [
                {
                    "RelationType": "refund",
                    "RelatedTransactionKey": "47C50AD98B7B45918DE69CXXXXXXXXXX"
                }
            ],
            "ConsumerMessage": null,
            "Order": null,
            "IssuingCountry": null,
            "StartRecurrent": false,
            "Recurring": false,
            "CustomerName": "J. de Tèster",
            "PayerHash": null,
            "PaymentKey": "AE8B6E18A2684846AAAF06A63FXXXXXX"
        }
        

        Refund push

        {
          "Transaction": {
            "Key": "F996EE747ECD43CDA8851C5F83XXXXXX",
            "Invoice": "BelfiusTest",
            "ServiceCode": "belfius",
            "Status": {
              "Code": {
                "Code": 190,
                "Description": "Success"
              },
              "SubCode": {
                "Code": "S001",
                "Description": "Transaction successfully processed"
              },
              "DateTime": "2021-05-19T12:03:45"
            },
            "IsTest": true,
            "Order": null,
            "Currency": "EUR",
            "AmountCredit": 1,
            "TransactionType": "C077",
            "Services": [
              {
                "Name": "belfius",
                "Action": null,
                "Parameters": [
                  {
                    "Name": "customeraccountname",
                    "Value": "J. de Tèster"
                  },
                  {
                    "Name": "CustomerIBAN",
                    "Value": "NL44RABO0123456789"
                  },
                  {
                    "Name": "CustomerBIC",
                    "Value": "RABONL2U"
                  }
                ],
                "VersionAsProperty": 2
              }
            ],
            "CustomParameters": null,
            "AdditionalParameters": null,
            "MutationType": 1,
            "RelatedTransactions": [
              {
                "RelationType": "refund",
                "RelatedTransactionKey": "4E8BD922192746C3918BF4077CXXXXXX"
              }
            ],
            "IsCancelable": false,
            "IssuingCountry": null,
            "StartRecurrent": false,
            "Recurring": false,
            "CustomerName": "J. de Tèster",
            "PayerHash": null,
            "PaymentKey": "AE8B6E18A2684846AAAF06A63FXXXXXX"
          }
        }
        

        Was this article helpful?

        What's Next