Integration Guides

Refunds

Process full and partial refunds

Refunds allow you to return funds to customers for successful payments. NjiaPay supports both full and partial refunds through a simple API.

When to Refund

Common scenarios for refunds:

Customer requests cancellation
Product/service not delivered
Duplicate payment
Fraud detection
Quality issues
Order cancellation

Refund Types

Full Refund

Return the entire payment amount to the customer.

Partial Refund

Return only a portion of the payment amount.

Multiple partial refunds are possible (depending on PSP support) as long as the total doesn't exceed the original payment amount.

Creating a Refund

To refund a payment, use the refund endpoint:

Terminal

curl -X POST https://app.infinic.com/api/intents/{intent_id}/refund \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "reason": "customer_request"
  }'

Parameters:

amount (required): Amount to refund in minor units (must be ≤ original amount minus previous refunds)
reason (optional): Reason for refund (fraud, customer_request, return, duplicate, other)

Response:

{
  "id": 789,
  "intent_id": "550e8400-e29b-41d4-a716-446655440000",
  "attempt_id": 456,
  "amount": 5000,
  "status": "initiated",
  "created": "2024-01-15T10:30:00Z",
  "reason": "customer_request"
}

Refund Statuses

Status	Description
`initiated`	Refund created in NjiaPay system
`pending`	Being processed by payment provider
`success`	Refund completed, funds returning to customer
`failed`	Refund attempt failed
`canceled`	Refund was canceled

Refund Webhooks

You'll receive a Refund webhook event when refund status changes:

{
  "type": "Refund",
  "created": "2024-09-01T00:00:00Z",
  "content": {
    "type": "full",
    "intent_id": "550e8400-e29b-41d4-a716-446655440000",
    "reference_id": "order_12345",
    "purchaser_id": "customer_abc",
    "amount": 20000,
    "currency": "ZAR",
    "status": "success"
  }
}