payment-refundslisted
Install: claude install-skill psnwd/getewise
# Payment refunds
Refunds move money out, so they are the highest-abuse path. Facts below come from the gateway skills; where docs are silent, **say so and ask the gateway**, never guess an endpoint.
## Gateway matrix
| Gateway | Refund API | Partial | States / notes |
|---|---|---|---|
| PayHere | `POST /merchant/v1/payment/refund` (OAuth). Body: `payment_id` **or** `authorization_token` (one only) plus `description` | **Docs contradict**: Refund API ships a "For partial refunds" sample with `"amount": "100.50"` (never marked optional), Refund Process says only full refunds. Confirm with support before shipping partials | Retrieval statuses: `RECEIVED`, `REFUND REQUESTED`, `REFUND PROCESSING`, `REFUNDED`, `CHARGEBACKED`. Result `status`: 1 ok, 0 error initiating, -1 failed. Instant refund same day (processed as a void); after payout 5-10 days+. Detail: the payhere skill's merchant-api reference |
| OnePay | `POST /v3/transaction/refund/`, `Authorization: <APP_TOKEN>`. Body: `app_id`, `onepay_transaction_id`, `refund_reason` (`DUPLICATED, FRAUDULENT, OUT_OF_ORDER, REQUESTED_BY_CUSTOMER, OTHER`), `is_partially`, `amount`, `refund_note` | Yes (`is_partially` + `amount`) | Live paid transactions only; **sandbox rejected**. One active refund per transaction. Returns `refund-initiated`. FX refunds use the rate on the refund date. No status lookup or webhook documented. Detail: the onepay skill's refund-payouts reference |
| Genie Business | `POST {base}/public/transactions/{id}/