REFERENCE

API Reference

Complete list of all Flowwithlit API endpoints. Click any endpoint to expand its request / response details. Base URL: https://api.flowwithlit.com

ℹ️

Endpoints marked 🔑 Secret Key use your API secret key as a Bearer token. Everything else is either public or authenticated with your public key. Get your keys from the Developer API dashboard.

Payments

GET /public/rates Get exchange rates (no auth needed) 🌐 Public ▶

Returns current exchange rates relative to NGN. Used by checkout pages and merchant sites to display currency equivalents. No API key required.

JSON

{"success":true,"data":{"NGN_USD":0.00062,"NGN_GBP":0.00049,"NGN_EUR":0.00057,"USD_NGN":1610.0,"GBP_NGN":2040.0,"EUR_NGN":1750.0}}

GET /public/merchant-info Get merchant name for checkout display 🌐 Public Key (query param) ▶

Query Parameters

Field	Type	Required	Description
`key`	string	required	Your public API key

JSON

{"success":true,"data":{"merchant_name":"Acme Ltd","is_test":true}}

POST /public/charge Process a card payment from the hosted checkout 🌐 Public Key (body) ▶

ℹ️

This endpoint is called by the checkout/index.php iframe — you don't call it directly. Use FlowPay.init() on your frontend instead.

Field	Type	Required	Description
`public_key`	string	required	Your public API key
`amount`	number	required	Amount in kobo (lowest denomination)
`currency`	string	optional	Default: NGN
`email`	string	required	Customer email
`name`	string	optional	Customer name
`ref`	string	optional	Your transaction reference
`meta`	object	optional	Arbitrary metadata passed to webhooks

JSON

{"success":true,"data":{"status":"successful","transaction_ref":"FLW_TXN_ABCD1234","amount":500000,"currency":"NGN","message":"Payment successful"}}

GET /v1/transaction/verify/{ref} Verify a transaction by reference 🔑 Secret Key ▶

Authenticate with Authorization: Bearer flw_sec_test_YOUR_KEY

cURL

curl https://api.flowwithlit.com/v1/transaction/verify/FLW_TXN_ABCD1234 \
  -H "Authorization: Bearer flw_sec_test_YOUR_KEY"

JSON response

{"success":true,"data":{"status":"successful","transaction_ref":"FLW_TXN_ABCD1234","amount":500000,"currency":"NGN","customer":"john@example.com","created_at":"2026-06-15T10:32:44Z"}}

HTTP Status Codes

Code	Meaning	What to do
`200`	OK	Request succeeded
`400`	Bad Request	A required field is missing or invalid — check `message`
`401`	Unauthorized	Missing or invalid token / API key
`402`	Payment Required	Insufficient wallet balance
`403`	Forbidden	Valid token but not allowed (e.g. wrong role)
`404`	Not Found	Resource doesn't exist or doesn't belong to you
`429`	Too Many Requests	Rate limited — back off and retry
`500`	Server Error	Something went wrong on our end — contact support