adhoc tokenization agreement(adhoc) charge

post

https://api.payfast.co.za/subscriptions/{adhoc_token}/adhoc

Charge an ad hoc subscription based on token.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

adhoc_token

string

required

Tokenization agreement (adhoc) token.

Query Params

testing

boolean

Defaults to true

Set to true when calling sandbox/testing mode (where supported).

Form Data

amount

string

required

Required. Amount which the buyer must pay, in CENTS (ZAR).

item_name

string

required

Required. Name of the item being charged for.

item_description

string

Optional. Description of the item being charged for.

itn

string

Optional. Specify whether an ITN must be sent for the ad hoc charge (1 by default).

m_payment_id

string

Optional. Unique payment ID on the merchant’s system.

cc_cvv

string

Optional. Credit card cvv number.

setup

string

Optional. Split receiving merchant_id, percentage and/or amount with oiptional min/max values in CENTS (ZAR).

Headers

merchant-id

string

required

Merchant ID issued by PayFast.

version

string

required

API version.

timestamp

date-time

required

Request timestamp. Use ISO-8601 format.

signature

string

required

MD5 signature of the request fields (URL-encoded values) plus passphrase. For API requests, fields are sorted alphabetically by key and the signature must be lowercase.

Responses

400

Bad request.

401

Authentication / signature error.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful response.