Refunds

fype allows you to issue full or partial refunds for any payment that has reached the succeeded status.

Initiating a Refund

You can initiate a refund through the fype API or directly from the Dashboard.

Via Dashboard

Go to the Payments section.
Click on the successful payment you want to refund.
Click the Refund button.
Enter the amount to refund (defaults to the full amount).
Confirm the refund.

Via API

POST /v1/payments/{payment_id}/refund

curl -X POST https://api.fype.dev/v1/payments/PAY_ID/refund \
 -H "Authorization: Bearer <API_KEY>" \
 -H "Content-Type: application/json" \
 -d '{
 "amount": 25000
 }'

Refund Statuses

Status	Description
`pending`	The refund request has been sent to the gateway.
`processed`	The gateway has successfully processed the refund.
`failed`	The refund attempt was rejected by the gateway.

Refund Notifications

fype will send webhooks for refund events:

refund.processed: When the refund is successful.
refund.failed: If the refund cannot be completed.

Limits and Constraints

Amount: You cannot refund more than the original amount of the payment.
Status: Only payments with a status of succeeded can be refunded.
Gateway Support: Refunds are processed by the underlying payment gateway. fype propagates the request and normalizes the response.
Processing Time: While fype processes the request instantly, it may take 5-7 business days for the funds to appear in the customer’s bank account, depending on the gateway and bank.

​Refunds

​Initiating a Refund

​Via Dashboard

​Via API

​Refund Statuses

​Refund Notifications

​Limits and Constraints