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) orpartial(withamount).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.
paygent