Requests

Requests


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.

Base JSON request

Use the base request as instructed on this page

Pay request

Parameters

Service specific parameters

Parameter Type Required Recommended Description
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.
Basic parameters

Example request

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

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.

Parameters

Basic parameters

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

Parameters

Basic parameters

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

Base JSON request

Use the base request as instructed on this page

Refund request

Parameters

Service specific parameters

Parameter Type Required Recommended Description
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.
Basic parameters

Example request

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

Refund response

Parameters

Basic parameters

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

Parameters

Basic parameters

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

Was this article helpful?