Requests

Requests


Pay

The default action for EPS is Pay. This action has no input except the basic transaction details. Upon receiving this input, the consumer will be redirected to EPS site for verification and confirmation of the payment. After completion at the EPS site, the customer is redirected back to the merchant site.

Base JSON request

Use the base request as instructed on this page

Parameters

Basic parameters

Pay request

Example request

{
   "Currency": "EUR",
   "AmountDebit": 10,
   "Invoice": "testinvoice 123",
   "Services": {
      "ServiceList": [
         {
            "Name": "eps",
            "Action": "Pay"
         }
      ]
   }
}

Pay response

Parameters

Basic parameters

Example response:

{
    "Key": "D09A1A3B96CE4E4BA2907919XXXXXXXX",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: Verify at EPS"
        },
        "DateTime": "2021-11-17T11:38:29"
    },
    "RequiredAction": {
        "RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=0AFC903591A2436380929F62XXXXXXXX",
        "RequestedInformation": null,
        "PayRemainderDetails": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "Automatedtest_Bancontact_0001",
    "ServiceCode": "eps",
    "IsTest": false,
    "Currency": "EUR",
    "AmountDebit": 0.02,
    "TransactionType": "C607",
    "MutationType": 1,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": "FB9BB408CE8348499D2D854CXXXXXXXX"
}

Pay push

Parameters

Basic parameters

Example push:

{
   "Transaction": {
      "Key": "8520E05442194D43A4C1BBD9B6XXXXX",
      "Invoice": "testinvoice 123",
      "ServiceCode": "eps",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transaction successfully processed"
         },
         "DateTime": "2017-07-20T11:55:06"
      },
      "IsTest": true,
      "Order": null,
      "Currency": "EUR",
      "AmountDebit": 10,
      "TransactionType": "C607",
      "Services": null,
      "CustomParameters": null,
      "AdditionalParameters": null,
      "MutationType": 1,
      "RelatedTransactions": null,
      "IsCancelable": false,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": null,
      "PayerHash": null,
      "PaymentKey": "F7CACA3C422F45C0BD50AF500BEXXXX"
   }
}

Refund

To refund a successful EPS transaction, use the action Refund. A bank transfer is then initiated which transfers the amount of the original transaction back to the consumer. Remember to use the channel BackOffice for this action. Only full refunds are supported.

Refund request

Parameters

Service specific parameters

Parameter Type Required Recommended Description
OriginalTransactionKey string Yes Transaction key of the original transaction that needs to be refunded. Please note: this is a basic parameter.
Basic parameters

Example request:

{
   "Currency": "EUR",
   "AmountCredit": 10,
   "Invoice": "testinvoice 123",
   "OriginalTransactionKey": "4048CE0D41404E14BD97A7A8E30A2xxx",
   "Services": {
      "ServiceList": [
         {
            "Name": "eps",
            "Action": "Refund",
            "Parameters": [
               {
                  "Name": "customeraccountname",
                  "Value": "John Smith"
               },
               {
                  "Name": "customeriban",
                  "Value": "NL13TEST0123456789"
               },
               {
                  "Name": "customerbic",
                  "Value": "TESTNL2A"
               }
            ]
         }
      ]
   }
}

Refund response

Parameters

Basic parameters

Example response:

{
   "Key": "8026BC80ABF844AF98BF8CB48F58Axxx",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2017-10-09T10:59:42"
   },
   "RequiredAction": null,
   "Services": null,
   "CustomParameters": null,
   "AdditionalParameters": null,
   "RequestErrors": null,
   "Invoice": "testinvoice 123",
   "ServiceCode": "eps",
   "IsTest": true,
   "Currency": "EUR",
   "AmountCredit": 10,
   "TransactionType": "C608",
   "MutationType": 1,
   "RelatedTransactions": [
      {
         "RelationType": "refund",
         "RelatedTransactionKey": "4048CE0D41404E14BD97A7A8E30A2xxx"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": null,
   "PayerHash": null,
   "PaymentKey": "74B432706BF44553BB997D5329381xxx"
}

Refund push

Parameters

Basic parameters

Example push:

{
   "Transaction": {
      "Key": "8026BC80ABF844AF98BF8CB48F58Axxx",
      "Invoice": "testinvoice 123",
      "ServiceCode": "eps",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Succes"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transactie succesvol uitgevoerd"
         },
         "DateTime": "2017-10-09T10:59:42+02:00"
      },
      "IsTest": true,
      "Order": null,
      "Currency": "EUR",
      "AmountCredit": 10,
      "TransactionType": "C608",
      "Services": null,
      "CustomParameters": null,
      "AdditionalParameters": null,
      "MutationType": 1,
      "RelatedTransactions": [
         {
            "RelationType": "refund",
            "RelatedTransactionKey": "4048CE0D41404E14BD97A7A8E30A2xxx"
         }
      ],
      "IsCancelable": false,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": null,
      "PayerHash": null,
      "PaymentKey": "74B432706BF44553BB997D5329381xxx"
   }
}

Was this article helpful?

What's Next