General

Belfius is a popular Belgian payment method that allows Belgiun bank account holders to pay online via their familiar banking environment. The consumer is redirected to Belfius, where they can choose to pay with either the mobile banking app or by using their bank card. After completing the payment, the consumer is automatically redirected back to the merchant website.

Servicecode and actions

The servicecode for Belfius is "belfius"

The following actions are allowed for Belfius:

  • Pay
  • Refund

Pay

View in playground

Request


JSON Gateway request

JSON

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

Response


JSON Gateway response

JSON

copy
{
    "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"
}

Push


JSON Push response

JSON

copy
{
   "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

View in playground

Request


JSON Gateway request

JSON

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

Response


JSON Gateway response

JSON

copy
{
    "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"
}

Push


JSON Push response

JSON

copy
{
  "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"
  }
}