Skip to content

Charge Ad-hoc Payment

Overview

Charge an ad-hoc payment using a tokenized card.

Path

/v1/payfast/subscriptions/{token}/adhoc

Path Parameters

  • token (string, required)

HTTP Request

POST /v1/payfast/subscriptions/{token}/adhoc

Request Body Schema

AdhocPaymentRequest

Request Example

{
  "amount": 150.75,
  "item_name": "Additional Service",
  "item_description": "One-off upgrade fee"
}

Success Response (201) Schema

Generic object (implementation specific)

Response Example

{
  "status": "SUCCESS",
  "token": "SUBSCRIPTION_TOKEN",
  "charged_amount": 150.75,
  "currency": "ZAR"
}

Error Responses

  • 400 Validation Exception (Bad Request)