Payment Methods

Providers

buckaroo

Buckaroo

Przelewy24

Request example

Payments expiry time for Przelewy24 via Buckaroo is 30 minutes. 

                                                            
{
   "id": "7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
   "paymentMethod": "p24",
   "returnUrl": "http://example.com", // URL to return after payment completion.
   "webhookUrl": "https://example.com", // URL to receive webhook notification.
   "transaction":{
      "reference": "test-1111", // Max 20 characters
      "currency": "PLN", // ISO4217 format
      "amount": 2000, // The amount is in cents, 2000 = 20 PLN. Has to be sum of amounts * quantity in lines.
      "description": "test-1444",
      "lines":[
         {
            "name": "Some Voucher - 20 PLN", // Max 100 characters. Name of product.
            "category": "PREPAID-VOUCHER", // Max 100 characters.
            "brand": "alphacomm", // Max 100 characters.
            "quantity": 1, // Number of items
            "amount": 2000 // The amount is in cents, 2000 = 20 PLN
         }
      ]
   },
   "p24": { // Mandatory parameters for P24
        "customerEmail": "some@address.com", // Has to be a valid email address
        "customerFirstName": "Jakub", // First name
        "customerLastName": "Klimatkowski", // Last name
   }
}

Buckaroo Sandbox

In Buckaroo Przelewy24 integration, all needed parameters are set in buckaroo. Just example request is sent
Check with dev team for sandbox setup

Anti-fraud Check

Fraud check (Cynic) is supported for this Provider.

It is required for payer data to be sent along with request. Minimum base payer data and phone or email in billing is needed. Example below.



{
    "id": "7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
    "paymentMethod": "p24", // Payment method of use
    "returnUrl": "https://example.com", // URL to return after payment completion.
    "webhookUrl": "https://example.com", // URL to receive webhook notification.
    "shopCountry": "NL", // Mandatory. ISO 3166-1 alpha-2 country code of the shop.
    "transaction": {
        "reference": "test-1111", // Max 20 characters
        "currency": "PLN", // ISO4217
        "amount": 2000, // Amount in cents, 2000 = 20 PLN. Has to be sum of amounts * quantity in lines.
        "description": "test-1444",
        "lines": [
            {
                "name": "Some Voucher - 20 PLN", // Max 100 characters. Name of product.
                "category": "PREPAID-VOUCHER", // Max 100 characters.
                "brand": "alphacomm", // Max 100 characters.
                "quantity": 1, // Number of items
                "amount": 2000 // Amount in cents, 2000 = 20 PLN. Has to be sum of amounts * quantity in lines.
            }
        ]
    },
    "payer": {
        "id": "1337", // Auto-generated UUID
        "email": "john@alphacomm.nl", // Max 64 characters.
        "deviceId": "a80d683678514df2b3c952f48b095266", // Max 50 characters.
        "billing": {
            "firstName": "John", // Max 128 characters. Set to DECLINE to trigger rejection.
            "lastName": "Doe", // Max 128 characters
            "street": "Scheepmakerspassage 183", // Max 128 characters. Billing street with number.
            "city": "Rotterdam",
            "zip": "3011VH", // Max 50 characters. Customer postal code.
            "phone": "+31612345678", // Phone number with Country code.
            "email": "john@alphacomm.nl", // Max 64 characters.
            "country": "NL" // Country code ISO3166 format
        },
        "shipping": {
            "firstName": "John", // Max 128 characters. Set to DECLINE to trigger rejection.
            "lastName": "Doe", // Max 128 characters
            "street": "Scheepmakerspassage 183", // Max 128 characters. Billing street with number.
            "city": "Rotterdam",
            "zip": "3011VH", // Max 50 characters. Customer postal code.
            "phone": "+31612345678", // Phone number with Country code.
            "email": "john@alphacomm.nl", // Max 64 characters.
            "country": "NL" // Country code ISO3166 format
        },
        "ipAddress": "127.0.0.1", // Support only ipv4
        "language": "nl", // Language code ISO 639-1 format
        "status": "registered", // Can be "guest", "registered", "registered-unconfirmed"
        "verificationStatus": "phone", // Can be "identification", "phone", "trusted", "otherwise"
        "dateRegistration": "2016-01-01T13:56:48+0100", // Date format ISO 8601
        "dateLastUpdated": "2016-01-01T13:56:48+0100", // Date format ISO 8601
        "dateFirstPurchase": "2016-01-01T13:56:48+0100", // Date format ISO 8601
        "channel": "web" // Can be "web" or "app"
    },
    "p24": { // Mandatory parameters for P24
        "customerEmail": "john@alphacomm.nl", // Has to be a valid email address
        "customerFirstName": "John", // First name
        "customerLastName": "Doe" // Last name
    },
    "provider": "buckaroo"
}

Merchant Configuration

  • guid - Buckaroo account (set by devs)
  • key - Buckaroo account (set by devs)
  • secret_key - Buckaroo account (set by devs)
  • store_name - Merchant name set in configuration