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; 13 months 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.
An object field (e.g. webhook) contributes its values in the order sent, nested ones included: sha256(service|transaction_id|value|webhook.url|refund.succeeded|refund.failed|SecretHash).
Request
Responses
- 200
- 400
Refund processed
Refund rejected, e.g. an invalid webhook URL or a missing service webhook secret