Pay
The Pay action is used to perform a single P24 payment. P24 is possible is both EUR as PLN, and will be paid out "like-for-like". If a transaction is initiated in EUR, but the consumer does not have a EUR bankaccount, he/she will pay for the conversion fee.
Request
JSON gateway request
CustomerEmail
string
|
Required
Email of the customer |
CustomerFirstName
string
|
First name of the customer. If provided, the name will be sent to P24. The name will also be shown in the Buckaroo payment plaza, which can make it easier to find a customer’s transaction, so it is advised to send in this parameter. |
CustomerLastName
string
|
Last name of the customer. If provided, the name will be sent to P24. The name will also be shown in the Buckaroo payment plaza, which can make it easier to find a customer’s transaction, so it is advised to send in this parameter. |
JSON
{
"Currency": "PLN",
"AmountDebit": 10.00,
"Invoice": "Testinvoice 123",
"Services": {
"ServiceList": [
{
"Name": "Przelewy24",
"Action": "Pay",
"Parameters": [
{
"Name": "CustomerEmail",
"Value": "test@test.nl"
},
{
"Name": "CustomerFirstName",
"Value": "John"
},
{
"Name": "CustomerLastName",
"Value": "Smith"
}
]
}
]
}
}
Response 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
JSON gateway response
If the request has a valid structure and a valid signature, a transaction will be created in the Payment Engine and a response will be returned. In this case, an additional action is required before the transaction can be completed. The customer needs to be redirected to the payment environment through the returned redirectURL.
JSON
{
"Key": "BD7C0ADC0C604A28BC1739646AFAXXXX",
"Status": {
"Code": {
"Code": 791,
"Description": "Pending processing"
},
"SubCode": {
"Code": "S002",
"Description": "An additional action is required: TestStatusRedirect"
},
"DateTime": "2018-09-11T11:45:08"
},
"RequiredAction": {
"RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=9F37FD0DBD704043B1A42427AB41XXXX",
"RequestedInformation": null,
"PayRemainderDetails": null,
"Name": "Redirect",
"TypeDeprecated": 0
},
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "Testinvoice 123",
"ServiceCode": "Przelewy24",
"IsTest": true,
"Currency": "PLN",
"AmountDebit": 10,
"TransactionType": "C900",
"MutationType": 1,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": "John Smith",
"PayerHash": null,
"PaymentKey": "F0E1A003B8194CA5A3BDAD39D253XXXX"
}
Push
JSON push response
This response does not have service specific request variables.
JSON
{
"Transaction": {
"Key": "BD7C0ADC0C604A28BC1739646AFAXXXX",
"Invoice": "Testinvoice 123",
"ServiceCode": "Przelewy24",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2018-09-11T11:49:16"
},
"IsTest": true,
"Order": null,
"Currency": "PLN",
"AmountDebit": 10,
"TransactionType": "C900",
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": null,
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": "John Smith",
"PayerHash": null,
"PaymentKey": "F0E1A003B8194CA5A3BDAD39D253XXXX"
}
}
Refund
The Refund action can be used to perform a refund on an earlier P24 transaction. There is no customer interaction needed to do this.
Request
JSON gateway request
OriginalTransactionKey
string
|
Required
Transaction key of the payment that needs to be refunded. Please note: This is a basic parameter, not a service specific parameter. |
JSON
{
"Currency": "PLN",
"AmountCredit": 1.00,
"Invoice": "testinvoice 123",
"OriginalTransactionKey": "BD7C0ADC0C604A28BC1739646AFAXXXX",
"Services": {
"ServiceList": [
{
"Name": "Przelewy24",
"Action": "Refund"
}
]
}
}
Response 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
JSON gateway response
This response does not have service specific request variables
JSON
{
"Key": "CCD81ADE1BCE49C39B7792C9A27EXXXX",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2018-09-11T11:58:51"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "testinvoice 123",
"ServiceCode": "Przelewy24",
"IsTest": true,
"Currency": "PLN",
"AmountCredit": 1,
"TransactionType": "C901",
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "BD7C0ADC0C604A28BC1739646AFAXXXX"
}
],
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "6BF85A8307914CD0A37581D26E52XXXX"
}
Push
JSON push response
This response does not have service specific request variables
JSON
{
"Transaction": {
"Key": "CCD81ADE1BCE49C39B7792C9A27EXXXX",
"Invoice": "testinvoice 123",
"ServiceCode": "Przelewy24",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": null,
"DateTime": "2018-09-11T11:58:51"
},
"IsTest": true,
"Order": null,
"Currency": "PLN",
"AmountCredit": 1,
"TransactionType": "C901",
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "BD7C0ADC0C604A28BC1739646AFAXXXX"
}
],
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": null
}
}