v1

latestOpenAPI 3.1.02026-07-262343124.1 KB
Refunds

Mark a payment as refunded

Request a full refund for a payment. Calling a second time on the same payment returns 409.

post/v1/refunds

Headers

Merchant-Idstring required
Example:acme-store-1

Merchant identifier.

WCP-Versionstring
Example:2026-02-18

Optional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.

Request body

paymentIdstring required

Payment ID to refund

Example request

{
  "paymentId": "pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ"
}

Response

Payment marked as refunded

paymentIdstring required

Payment ID that was marked as refunded