Manage Refunds

Sangho allows you to initiate full or partial refunds for successful transactions, under certain conditions.

Refund Conditions

The transaction must have “succeeded” status
The refund window depends on the payment method (see table)
The wallet available balance must cover the amount
Sangho fees are not refunded

Full vs. Partial Refund

A full refund returns the entire amount paid by the buyer. A partial refund allows you to refund only part of the amount.

Timelines by Payment Method

Method	Timeline	Notes
Airtel Money	24–48h	Transfer to Mobile Money number
Moov Money	24–72h	Transfer to Mobile Money number
Bank card	5–10 days	Depends on issuing bank
PayPal	3–5 days	To the original PayPal account

Status Tracking

pending→processing→succeeded / failed

Create a Refund (API)

bash

curl -X POST https://api.sangho.ga/v1/refunds/ \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction": "tx_xxxxxxxxxxxx",
    "amount": 2500,
    "reason": "requested_by_customer"
  }'

Response

ResponseResponse

json

{
  "id": "ref_xxxxxxxxxxxx",
  "object": "refund",
  "transaction": "tx_xxxxxxxxxxxx",
  "amount": 2500,
  "currency": "XAF",
  "status": "processing",
  "reason": "requested_by_customer",
  "created_at": "2026-03-15T14:30:00Z"
}