Test mode

Test mode lets you build and verify your full integration — payment creation, checkout redirect, and webhooks — without real money or a paired phone.

How it works

• Create a Test key under API Keys in the merchant panel — it starts with fk_test_.
• Payments created with a test key have "livemode": false and show a TEST MODE banner on the checkout page.
• On checkout, the customer (you) can enter any TrxID and sender number — the payment completes immediately, skipping SMS verification.
• Webhooks fire exactly like production, so you can test your payment.completed handler end to end.
• Test payments never count toward your plan's transaction limit and are excluded from dashboard revenue. Filter them with the Mode filter on the Payments page.

Typical workflow

# 1. Create a test payment
curl -X POST https://fastaar.com/api/v1/payments \
  -H "Authorization: Bearer fk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "metadata": {"order_id": "TEST-1"}}'

# 2. Open data.checkout_url in a browser, pick a provider,
#    submit any TrxID (e.g. TEST123456) and number (e.g. 01712345678)

# 3. Watch your webhook receive payment.completed with "livemode": false

Going live

Swap the key for an fk_live_ one. Everything else — endpoints, payloads, signatures — is identical. Live payments require an active subscription, an active MFS account, and a paired phone to verify SMS.