General

In Poland 80% of all consumers use the payment method P24. It is an online banking payment method (transfer) that enables consumers to do an online purchase via their online banking service. P24 covers over 35 banks in Poland.

Pay

The Pay action is used to perform a single P24 payment. Important note: a P24 payment can only be done in Polish zloty. Therefore, make sure to provide value "PLN" as the currency in the request.

View in playground

Request


JSON gateway request

CustomerEmail
Required

Email of the customer

CustomerFirstName

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

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

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


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

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

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

View in playground

Request


JSON gateway request

OriginalTransactionKey
Required

Transaction key of the payment that needs to be refunded. Please note: This is a basic parameter, not a service specific parameter.

JSON

copy
{
  "Currency": "PLN",
  "AmountCredit": 1.00,
  "Invoice": "testinvoice 123",
  "OriginalTransactionKey": "BD7C0ADC0C604A28BC1739646AFAXXXX",
  "Services": {
    "ServiceList": [
      {
        "Name": "Przelewy24",
        "Action": "Refund"
      }
    ]
  }
}

Response


JSON gateway response

This response does not have service specific request variables

JSON

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

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