Skip to main content

Refund Transaction

POST 
/api/v1/pbl/refund

Refund a completed transaction. Supports both full and partial refunds.

Available for: BLIK, BLIK BNPL, Bank Transfers, Cards, MB WAY.

Refund validity: 180 days from payment date for cards, MB WAY, PayPo and Twisto; effectively 179 days for BLIK; no time limit for bank transfers (PBL).

Checksum​

The server verifies the checksum by concatenating the values of all fields sent in the request body, in the order they appear in the JSON (excluding checksum), joined with |, with your Secret Hash appended at the end:

sha256({field1}|{field2}|...|{SecretHash})

Typical cases:

  • Full refund ({service, transaction_id, checksum}): sha256(service|transaction_id|SecretHash)
  • Partial refund ({service, transaction_id, value, checksum}): sha256(service|transaction_id|value|SecretHash)

Warning: every optional field you send (e.g. reason) must also be included in the checksum, in the same order as in the body - otherwise the request is rejected with HTTP 401 Unauthorized request.

Request​

Responses​

Refund processed

Last updated on