API Reference2026-02-19.previewRefunds
Mark a payment as refunded
POST
header
Api-Key<token>Merchant-Id*stringMerchant identifier.
WCP-Version?stringOptional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.
application/json- body
paymentId*stringPayment ID to refund
Match
^pay_[A-Za-z0-9]+$Length
1 <= length <= 64Payment marked as refunded
application/json- response
paymentId*stringPayment ID that was marked as refunded
curl -X POST 'https://api.pay.walletconnect.com/v1/refunds' \ -H 'Merchant-Id: acme-store-1' \ -H 'Content-Type: application/json' \ -d '{ "paymentId": "pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ"}'{ "paymentId": "pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ"}