General

An EPS payment can be initiated by sending the request to a BPE transaction gateway. The gateway processes the request and sends a response to the merchant. If the request is sent to a gateway without a customer redirect, the response will contain a redirect URL to which the customer must be redirected. If in the original request the customer was redirected along to the Buckaroo public gateway, the customer is automatically redirected to payment page at EPS by the transaction gateway. Once the customer reaches this page, he can enter his banking information. Once these have been entered and verified the payment is executed immediately and the customer will be redirected back to the merchant website, along with the result. Additionally, the Payment Engine will also perform a Transaction Push, with the status of the payment.

Servicecodes and actions

The EPS service uses the servicecode: eps

The EPS service supports the following actions: Pay, Refund. Use channel "Web" for action Pay and channel "Backoffice" for action Refund.

Recurring payments

It is also possible to use an EPS transaction as a reference transaction for recurring SEPA Direct Debit transactions. To do this, add the basic parameter "StartRecurrent" with value "True" to your EPS API request. Once successful, you can perform a recurring SEPA direct debit transaction. However, we do not always receive the account information from EPS. If we have not received this information, a SEPA Direct Debit cannot be performed based on the EPS transaction. Therefore, it is advised to make sure you are informed in some way if your SEPA Direct Debit API request fails. Please see the SEPA Direct Debit section for an explanation of the "PayRecurrent" request.

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.

View in playground

Request


JSON gateway request

Besides the service name, this action has no service specific variables.

JSON

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

Response


JSON gateway response

This response contains no service specific variables.

JSON

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

Push


JSON push response

This response contains no service specific variables.

JSON

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

View in playground

Request


JSON gateway request

originaltransaction
Required

Transaction key of the original transaction that needs to be refunded. Please note: This is a basic request variable, not a service specific variable.

JSON

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

Response


JSON gateway response

JSON

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

Push


JSON push response

JSON

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