Products

Refunds and disputes

Give money back, and answer customers who dispute a payment.

Refunds

POST/v1/refunds with payment, and amount for part of it (leave out for all), reason and reference. Card and transfer payments can be refunded once they have settled (409 not_settled before); the smallest refund is ₦100. Paygent wallet payments go straight back to the wallet. Events: refund.processed, refund.failed (the money comes back to you).

Disputes

When a customer disputes a payment, we send dispute.created and hold the amount. Answer before the deadline with POST/v1/disputes/:id/respond:

  • response: accepted (the customer gets the money), declined (the payment was right) or partial (with amount).
  • note: why, required unless you accept; evidence: { filename, data } with the file in base64, such as a delivery note.

Unanswered disputes are lost. dispute.closed says how it ended. Keep disputes under 0.5% of your card and transfer payments: above that our partner can hold more of your money.