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.
Use the base request as instructed on this page
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
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. |
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"
}
}