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

​
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 buyer
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.