Requests

Pay

The Pay action is used to perform a single P24 payment. P24 is possible in both EUR and PLN, and will be paid out "like-for-like". If a transaction is initiated in EUR, but the consumer does not have a EUR bank account, they will pay for the conversion fee.

Base JSON Request

Use the base request as instructed on this page.

Pay Request

Parameters

Parameter	Type	Required	Description
CustomerEmail	string	Required	Email of the customer
CustomerFirstName	string	Required	First name of the customer. If provided, the name will be sent to P24 and shown in the Buckaroo payment plaza.
CustomerLastName	string	Required	Last name of the customer. If provided, the name will be sent to P24 and shown in the Buckaroo payment plaza.

Basic Parameters

Example Request

{
  "Currency": "PLN",
  "AmountDebit": 10.00,
  "Invoice": "Testinvoice 123",
  "Services": {
    "ServiceList": [
      {
        "Name": "Przelewy24",
        "Action": "Pay",
        "Parameters": [
          {
            "Name": "CustomerEmail",
            "Value": "[email protected]"
          },
          {
            "Name": "CustomerFirstName",
            "Value": "John"
          },
          {
            "Name": "CustomerLastName",
            "Value": "Smith"
          }
        ]
      }
    ]
  }
}

Pay 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.

Example Response

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

Pay Push

Example Push

{
   "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 default action for refunding a P24 payment.

Base JSON Request

Use the base request as instructed on this page.

Refund Request

Parameters

Parameter	Type	Required	Description
OriginalTransactionKey	string	Required	Transaction key of the payment that needs to be refunded.

Example Request

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

Refund Response

Example Response

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

Refund Push

Example Push

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

Updated about 1 month ago