Skip to main content

Documentation Index

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

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

Refund endpoints allow merchants to request refunds for payments. Refunds go through a ticket-based review workflow before funds are returned to the consumer.

​
Business Rules

  • One-time product refunds must be requested within 7 days of payment
  • Partial refund amounts cannot exceed the original payment amount
  • Each payment can have multiple refund tickets (for partial refunds)
  • Refund tickets go through a review workflow before funds are returned

​
Refund Ticket Status Values

StatusDescription
pendingRefund request submitted, awaiting review
approvedRefund approved, awaiting processing
rejectedRefund request denied
processingRefund is being processed by PSP
succeededRefund completed, funds returned to consumer
failedRefund processing failed

​
Refund Workflow

Refund request submitted (pending)
    |
    v
Merchant / Admin reviews
    |
    +-- Approve --> processing --> succeeded (funds returned)
    |                         --> failed (retry needed)
    |
    +-- Reject --> rejected

​
Endpoints

Create Refund Ticket

Request a refund for a payment. Supports full and partial refunds.
Use GraphQL to query refund tickets and their current status. Filter by storeId, paymentId, or status to find specific tickets.