What a refund returns
A refund you request returns the full amount the payer sent: the pay-in’samount, not the net amount that reached your wallet. Fees you were charged on the pay-in are yours to carry.
- Refunds are for the whole pay-in. There is no partial refund.
- A pay-in can be refunded once.
- The refund goes back on the same kind of rail the payment came in on.
Refund a pay-in
POST /v1/refunds · needs the payouts:write scope
Response · 201
Refund statuses
Refunds use
succeeded, not successful. Do not reuse your transaction status handling for them.When the destination is known
For a bank transfer, the bank usually tells Payve which account paid. Payve stores it assenderDetails on the pay-in and uses it for the refund. The refund then starts in processing with recipientInfo filled in, and you do nothing more.
When the destination is not known
The refund starts inawaiting_recipient. Supply the destination:
POST /v1/refunds/{id}/process · needs the payouts:write scope
phoneNumber and operator instead of the bank fields.
Automatic refunds from payment links
When a fixed-amount payment link is overpaid or underpaid beyond your tolerances, Payve creates the refund for you with areason of overpayment or underpayment. See Overpayment and underpayment.
These refunds wait in awaiting_approval for Payve’s review, or in awaiting_recipient if the paying account is not known. In that case the hosted checkout asks the payer for the destination.

