Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Refunds are a shared capability across StablePay payment products. Refunds are not a standalone product; they are used after a payment has been completed through Stablecoin Checkout, Invoicing, Payment Links, or supported subscription billing flows.

When to use refunds

  • A customer cancels an order or service.
  • A merchant needs to return part of a payment.
  • A duplicate or incorrect payment needs to be adjusted.
  • A paid invoice or checkout payment requires a post-payment correction.

Full and partial refunds

Refund typeDescription
Full refundReturns the full eligible payment amount.
Partial refundReturns part of the eligible payment amount while leaving the remaining payment captured.
Multiple partial refunds may be available until the refundable amount is exhausted, depending on product and account configuration.

Refund destination rules

Refunds are sent back to an eligible original payment destination. Because of compliance and risk controls, merchants cannot freely choose a different chain, token, or wallet address for the refund.

Product applicability

ProductRefund relationship
Stablecoin CheckoutRefunds apply to completed checkout payments.
Stablecoin SubscriptionsRefunds apply to payments generated by subscription invoices.
InvoicingRefunds apply to payments associated with invoices.
Payment LinksRefunds apply to completed payment link payments.

Invoice relationship

Refunds are based on payments, not directly on invoices. A payment refund does not automatically rewrite the invoice state machine. Merchants should use payment and refund records together when presenting post-payment adjustments to customers.

Important limitations

  • Blockchain transactions cannot be reversed directly; StablePay creates a refund payment flow.
  • Refund timing and availability can depend on network conditions, compliance review, and merchant configuration.
  • StablePay does not provide a card-style chargeback dispute process for on-chain payments.
Last modified on April 22, 2026