Refunding a Payment
🚀 Endpoint Overview
| Method | URL |
|---|---|
| POST | https://init-vpay.venlabs.link/merchant/refund-payment |
Use this endpoint to request a refund for a successful transaction.
URL
POST /merchant/refund-payment
Request Body
{
"track_id": "TRACK_7890",
"amount": 50.00
}
Parameters
Parameters
| Field Name | Type | Required | Description |
|---|---|---|---|
track-id | string | ✅ | The payment provider (e.g. '102nhhur-230jnfr-ven43-vernn9) |
amount | float | ❌ | Transaction amount (e.g., 32.2) |
Response Example
{
"success": true,
"refund_id": "REFUND_1234"
}
Error Responses
| Status Code | Description |
|---|---|
| 400 | Invalid payment provider or missing merchant configuration |
| 500 | Internal server error |
⚠️ Only successful transactions can be refunded.