Release & dispute (per-customer)
| Route | Method & path | What it does |
|---|---|---|
| Buyer confirm payment | POST /v1/escrow/confirm-payment/{escrowId} | Buyer confirms delivery on a standard escrow; releases the full amount and closes it COMPLETED. customer-id = buyer. |
| Submit dispute | POST /v1/escrow/submit-dispute/{paymentToken} | Open or reply to a dispute (escrow must be OPENED). multipart/form-data with a message and optional evidence file. Only the buyer can open a dispute; the seller can only respond once one is raised. Milestone escrows can’t be disputed. customer-id required. |
| List my disputes | GET /v1/escrow/dispute/get | A customer’s disputes, with optional paymentToken / date filters. customer-id required. |
| Get dispute by escrow ID | GET /v1/escrow/dispute/get/{escrowId} | The dispute thread for one escrow. customer-id required. |
Merchant-wide (no customer-id)
| Route | Method & path | What it does |
|---|---|---|
| List all customers’ disputes | GET /v1/escrow/all-dispute | Every dispute across all your customers, paginated. |
| Get escrow feeds | GET /v1/escrow/feeds | All customers’ escrows, with status / customerId / categoryId / date filters. |
| Resolve dispute | POST /v1/escrow/dispute/resolve/{escrowId} | You settle the dispute. multipart/form-data: resolution text + status (COMPLETED releases to seller, REFUNDED returns to buyer) + optional file. |
Resolution paths
Happy path
Buyer confirms →
COMPLETED.Contested
The buyer opens a dispute
(
DISPUTED); the seller responds (INVESTIGATING). Standard escrows only.Merchant decides
You resolve →
COMPLETED (seller
paid) or REFUNDED (buyer refunded).