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.

Parameters

Pay request

Example request

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

Pay response

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_EPS_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

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

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

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

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