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
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 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
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"
}
}
Request
JSON Gateway request
JSON
copy
{
"Currency": "EUR",
"AmountCredit": 10.00,
"Invoice": "BelfiusTest",
"OriginalTransactionKey": "47C50AD98B7B45918DE69CXXXXXXXXXX",
"Services": {
"ServiceList": [
{
"Name": "belfius",
"Action": "Refund"
}
]
}
}
Response 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
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"
}
}