Skip to content

Create Refund

Overview

Create a refund for a payment.

Path

/v1/payfast/refunds/{payment_id}/create

Path Parameters

  • payment_id (string, required)

HTTP Request

POST /v1/payfast/refunds/{payment_id}/create

Request Body Schema

RefundRequest

Request Example

{
  "amount": 250.00,
  "reason": "Customer returned product"
}

Success Response (201) Schema

Generic object (implementation specific)

Response Example

{
  "status": "REFUND_CREATED",
  "payment_id": "PAY12345",
  "refund_amount": 250.00,
  "currency": "ZAR"
}

Error Responses

  • 400 Validation Exception (Bad Request)