Guides
StatusPlazaCreate Account

Requests

Suggest Edits

Pay

The default action for Blik is Pay. This action has no input except the basic transaction details. Upon receiving this input, the consumer will be redirected to Blik's hosted payment page for verification and confirmation of the payment. After completion at the Blik's site, the customer is redirected back to the merchant site.

Base JSON request

📘

Note

Use the base request as instructed on this page.

Parameters

Basic Parameters:

  • Find basic parameters here.

Pay Request

Parameters

Service-specific parameters

ParameterTypeRequiredDescription
Specin.emailStringOptionalInput

Example request

{
  "Currency": "PLN",
  "AmountDebit": 100.01,
  "AmountCredit": null,
  "Invoice": "Blik Pay 1714571145",
  "Order": null,
  "Description": "Blik Pay",
  "ClientIP": null,
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/Cancel",
  "ReturnURLError": "https://www.buckaroo.nl/Error",
  "ReturnURLReject": "https://www.buckaroo.nl/Reject",
  "OriginalTransactionKey": null,
  "ServicesSelectableByClient": null,
  "ServicesExcludedForClient": null,
  "PushURL": "https://www.google.com",
  "PushURLFailure": "https://www.google.com",
  "ClientUserAgent": null,
  "OriginalTransactionReference": null,
  "Services": {
    "ServiceList": [
      {
        "Name": "Blik",
        "Action": "Pay",
        "Version": 0,
        "Parameters": []
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Pay Response

Example response

{
  "Key": "0AF0C3FB3B4D44C1AFC63B0*********",
  "Status": {
    "Code": {
      "Code": 791,
      "Description": "Pending processing"
    },
    "SubCode": {
      "Code": "S002",
      "Description": "An additional action is required: Redirect to Blik."
    },
    "DateTime": "2024-05-01T15:45:47"
  },
  "RequiredAction": {
    "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=804D595BD20742C7A88BC*********",
    "RequestedInformation": null,
    "PayRemainderDetails": null,
    "Name": "Redirect",
    "TypeDeprecated": 0
  },
  "Services": [
    {
      "Name": "blik",
      "Action": null,
      "Parameters": [
        {
          "Name": "BankStatementId",
          "Value": "65EDCEB"
        }
      ]
    }
  ],
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "Blik Pay 1714571145",
  "ServiceCode": "blik",
  "IsTest": true,
  "Currency": "PLN",
  "AmountDebit": 100.01,
  "TransactionType": "C151",
  "MutationType": 1,
  "RelatedTransactions": null,
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "0EB3E62BB7994D66ABE4**********"
}

Pay Push

Example push

{
  "Transaction": {
    "Key": "0AF0C3FB3B4D44C1AFC63B**********",
    "Invoice": "Blik Pay 1714571145",
    "ServiceCode": "blik",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S990",
        "Description": "The request was successful."
      },
      "DateTime": "2024-05-01T15:46:01"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "PLN",
    "AmountDebit": 100.01,
    "TransactionType": "C151",
    "Services": [
      {
        "Name": "blik",
        "Action": null,
        "Parameters": [
          {
            "Name": "BankStatementId",
            "Value": "65EDCEB"
          },
          {
            "Name": "CustomerIBAN",
            "Value": "NL44RABO0123456789"
          },
          {
            "Name": "J Smith",
            "Value": "RABONL2U"
          }
        ],
        "VersionAsProperty": 1
      }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "J. de Tèster",
    "PayerHash": null,
    "PaymentKey": "0EB3E62BB7994D66ABE494**********",
    "Description": "Blik Pay"
  }
}

Refund

To refund a successful Blik transaction, use the action Refund. A bank transfer is then initiated which transfers the amount of the original transaction back to the consumer. This is only possible once Buckaroo received the money from the original payment. This can take up to two working days after the initial success confirmation of the original payment.

Refund Request

Example request

{
  "originalExternalTransactionId": "0AF0C3FB3B4D44C1AFC************",
  "externalTransactionId": "16656EEB06DE42C9AB08196CE50EA5C1",
  "externalMerchantId": "789E678AC77B4C999C3A0DE*******",
  "merchantContractId": "BUCKAROOTESTCONTRACT",
  "merchantNotificationSecret": "w6J9JpEi*********",
  "currency": "PLN",
  "amount": -100.01,
  "pushUrl": null,
  "consumerStatementOutput": "Blik Pay 1714571145 - Refund:Blik Pay",
  "specificInputParameters": null
}

Refund Response

Example response

{
  "transactionStatus": 2,
  "transactionType": 2,
  "paymentMethod": 279,
  "specificOutputParameters": {
    "PAYMENTPURPOSE": "65EDCEB",
    "SRCCOUNTRY": "PL",
    "SRCIBAN": "NL44RABO0123456789",
    "SRCBIC": "RABONL2U",
    "SRCACCOUNTHOLDER": "J Smith"
  },
  "requestStatus": 1,
  "requestFailReason": 0,
  "errorMessage": "",
  "acquirerRequest": "returnmode=urlencodeext\nlogin=***\npassword=***\ncontractid=BUCKAROOTESTCONTRACT\ntxtype=REFUND\nreftxid=140227173533\ncurrency=PLN\namount=10001\nmerchantrefundid=16656EEB06DE42C9AB08196CE50EA5C1\nspecin.dynamicdescriptor=Blik Pay 1714571145 - Refund:Blik Pay",
  "acquirerResponse": "STATUS=SUCCEEDED\nREFUNDID=1411937477\nMERCHANTREFUNDID=16656EEB06DE42C9AB08196CE50EA5C1\nRAND1883552890=5329cd679004fe480331a18b88ccf8372628c5fe\nERRMSG=",
  "acquirerRequestDateTime": "2024-05-01T15:47:36.4375882+02:00",
  "acquirerResponseDateTime": "2024-05-01T15:47:36.7557951+02:00"
}

Refund Push

Example push

{
  "Transaction": {
    "Key": "16656EEB06DE42C9AB0819*********",
    "Invoice": "Blik Pay 1714571145",
    "ServiceCode": "blik",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S990",
        "Description": "The request was successful."
      },
      "DateTime": "2024-05-01T15:47:36"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "PLN",
    "AmountCredit": 100.01,
    "TransactionType": "C152",
    "Services": [
      {
        "Name": "blik",
        "

Action": null,
        "Parameters": [
          {
            "Name": "BankStatementId",
            "Value": "65EDCEB"
          },
          {
            "Name": "CustomerIBAN",
            "Value": "NL44RABO0123456789"
          },
          {
            "Name": "CustomerBIC",
            "Value": "RABONL2U"
          },
          {
            "Name": "Processed",
            "Value": "Classic"
          }
        ],
        "VersionAsProperty": 1
      }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": [
      {
        "RelationType": "refund",
        "RelatedTransactionKey": "0AF0C3FB3B4D44C1AFC************"
      }
    ],
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "J. de Tèster",
    "PayerHash": null,
    "PaymentKey": "B7175F6BBF694CA284C6E***********",
    "Description": "Refund:Blik Pay"
  }
}

Updated 2 months ago