Requests

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.

Pay request

Parameters

Service specific parameters

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 succes 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 request

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