Requests

      Requests


        Article summary

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

        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

        ParameterTypeRequiredRecommendedDescription
        OriginalTransactionKeystringYesTransaction 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