Guides
StatusPlazaCreate Account

Requests

Suggest Edits

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

📘

Note

Use the base request as instructed on this page.

Parameters

Basic Parameters:

  • Find basic parameters here.

Pay Request

Example Request

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

Pay Response

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

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

Service Specific Parameters

ParameterTypeRequiredRecommendedDescription
OriginalTransactionKeystringYesTransaction key of the original transaction to be refunded

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

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

Example Push

{
   "Transaction": {
      "Key": "8026BC80ABF844AF98BF8CB48F58Axxx",
      "Invoice": "testinvoice 123",
      "ServiceCode": "eps",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transaction successfully processed"
         },
         "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"
   }
}

Updated 2 months ago