You can fetch a custom date range or use daily / weekly / monthly presets. Use these endpoints to fetch historical transactions for your PayFast account.

Base URL

https://api.payfast.co.za

Endpoints

GET /transactions/history?from=:date&to=:date — custom date range
GET /transactions/history/daily?date=:date — single day
GET /transactions/history/weekly?date=:date — ISO week containing the date
GET /transactions/history/monthly?date=:date — calendar month containing the date

Response format: text/csv (comma-separated values).

Authentication & Headers

Include signed headers with every request:

Header	Type	Required	Description
`merchant-id`	integer (8 chars)	Yes	Your PayFast Merchant ID.
`version`	string	Yes	API version (e.g., `v1`).
`timestamp`	ISO-8601 datetime	Yes	Current timestamp, e.g., `YYYY-MM-DDTHH:MM:SS[+HH:MM]`.
`signature`	string (MD5 hex)	Yes	MD5 hash of alphabetised submitted header/body variables + passphrase (lower-case).

Signature errors typically surface as “Merchant authorization failed”—double-check you’re hashing the alphabetised vars with your passphrase and that all four headers above are present.

Query Parameters

These apply across the history endpoints (each endpoint uses the date parameter it needs; range uses from/to).

Name	Type	Required	Used By	Description
`from`	`YYYY-MM-DD`	No	`/transactions/history`	Start date (inclusive). Defaults to current month start if omitted.
`to`	`YYYY-MM-DD`	No	`/transactions/history`	End date (inclusive). Defaults to current date if omitted.
`date`	`YYYY-MM-DD`	Yes	`/daily`, `/weekly`, `/monthly`	Anchor date for the preset period (day / ISO week / calendar month).
`limit`	integer	No	all	Max records to return (default `1000`).
`offset`	integer	No	all	Records to skip (use with `limit` for paging).

Parameter shapes and paging conventions are reflected in public Postman/SDK examples.

Example — Range request

curl -G "https://api.payfast.co.za/transactions/history" \
  --data-urlencode "from=2025-08-01" \
  --data-urlencode "to=2025-08-31" \
  --data-urlencode "limit=1000" \
  --data-urlencode "offset=0" \
  -H "merchant-id: 10029252" \
  -H "version: v1" \
  -H "timestamp: 2025-09-01T08:00:00+02:00" \
  -H "signature: bc38ae22b7f477c770329c6cc7a9a08a"

Sample response (truncated)

Date,Type,Sign,Party,Name,Description,Currency,"Funding Type",Gross,Fee,Net,Balance,"M Payment ID","PF Payment ID","custom str1","custom int1","custom str2","custom int2","custom str3","custom str4","custom str5","custom int3","custom int4","custom int5"
"2025-08-11 10:41:34",FUNDS_RECEIVED,CREDIT,"Test User 01",Testing,,ZAR,WALLET,133.00,-3.06,129.94,,,2736313,,,,,,,,,,
"2025-08-13 07:03:38",FUNDS_RECEIVED,CREDIT,"Test User 01","Support Centre purchase, Invoice ID #3715","Support Centre - Invoice #3715",ZAR,WALLET,16.00,-2.30,13.70,,3715,2739098,PF_WHMCS_8.13._2.3.0,,,,,,,,,
"2025-08-13 07:54:47",FUNDS_RECEIVED,CREDIT,"Test User 01","Support Centre purchase, Invoice ID #3715","Support Centre - Invoice #3715",ZAR,WALLET,16.00,-2.30,13.70,,3715,2739160,PF_WHMCS_8.13._2.3.1,,,,,,,,,
"2025-08-18 16:20:46",FUNDS_RECEIVED,CREDIT,"Test User 01",sd,,ZAR,WALLET,10.00,-2.30,7.70,,,2746643,,,,,,,,,,
"2025-08-27 01:17:47",FUNDS_RECEIVED,CREDIT,"Test User 01",TestItem,,ZAR,WALLET,100.00,-2.30,97.70,,,2758821,,,,,,,,,,
"2025-08-28 06:47:21",FUNDS_RECEIVED,CREDIT,"Test User 01","Monthly Subscription",,ZAR,CC,777.77,-37.18,740.59,,10485ef2-a9cd-460c-bbf8-998992c8d802,2760572,,,,,,,,,,
"2025-08-28 06:50:06",FUNDS_RECEIVED,CREDIT,"Test User 01","Monthly Subscription",,ZAR,CC,777.77,-37.18,740.59,,10485ef2-a9cd-460c-bbf8-998992c8d802,2760573,,,,,,,,,,
"2025-08-28 06:55:20",FUNDS_RECEIVED,CREDIT,"Test User 01","Monthly Subscription",,ZAR,CC,777.77,-37.18,740.59,,10485ef2-a9cd-460c-bbf8-998992c8d802,2760576,,,,,,,,,,
"2025-08-28 06:58:25",FUNDS_RECEIVED,CREDIT,"Test User 01","Monthly Subscription",,ZAR,CC,60.00,-4.99,55.01,,33e10f3b-04d3-4e28-bffc-6550c03a731b,2760580,,,,,,,,,,
"2025-08-28 06:59:03",FUNDS_RECEIVED,CREDIT,"Test User 01","Monthly Subscription",,ZAR,CC,60.00,-4.99,55.01,,33e10f3b-04d3-4e28-bffc-6550c03a731b,2760581,,,,,,,,,,
"2025-08-28 09:22:12",FUNDS_RECEIVED,CREDIT,"Test User 01","Yearly Subscription",,ZAR,CC,600.00,-29.21,570.79,,7a32b264-8930-4280-b99a-8f90d777db72,2760765,,,,,,,,,,
"2025-08-28 09:23:10",FUNDS_RECEIVED,CREDIT,"Test User 01",web_flix,,ZAR,CC,120.00,-7.68,112.32,,102587,2760768,,,,,,,,,,
"2025-08-28 09:27:59",FUNDS_RECEIVED,CREDIT,"Test User 01","Monthly Subscription",,ZAR,CC,60.00,-4.99,55.01,,1f482253-0f2b-44f9-a84a-2c62f6e06a01,2760775,,,,,,,,,,
"2025-08-29 10:03:24",FUNDS_RECEIVED,CREDIT,"Test User 01",Month_01_Installment,,ZAR,CC,120.00,-7.68,112.32,,Demo_001,2762219,,,,,,,,,,

CSV output is intended for reconciliation/reporting (dashboard “Recon reports” export the same format).

Try It

Errors & Gotchas

401 / Auth failed: signature incorrect or header missing—rebuild signature from alphabetised values + passphrase, all lowercase.
Large result sets: use limit + offset to paginate.
CSV parsing: treat the payload as CSV text; don’t assume JSON columns.