Requests

Requests


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