Sign out
Overview
Your developer account and switch network credentials.
API Key
—
Send this as the x-api-key header on requests to /api/* endpoints. Regenerating invalidates the old key immediately.
API Docs
Base URL: https://finsam-api.macksonsamson20.workers.dev
Create Account
POST /api/createAccount
curl -X POST https://finsam-api.macksonsamson20.workers.dev/api/createAccount \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"bankName": "Finsam MFB",
"accountName": "Ada Lovelace",
"accountNumber": "1234567890",
"initialBalance": 5000
}'
Lookup Account
POST /api/lookupAccount
curl -X POST https://finsam-api.macksonsamson20.workers.dev/api/lookupAccount \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "accountNumber": "1234567890" }'
Transfer Funds
POST /api/transferFunds
curl -X POST https://finsam-api.macksonsamson20.workers.dev/api/transferFunds \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"fromAccount": "1234567890",
"toAccount": "0987654321",
"amount": 1000
}'
Debit, credit, and ledger entry happen as a single atomic operation.
Test Console
Run the three switch endpoints against your live API key.
1 · Create two accounts
Not run yet.
2 · Lookup account A
Not run yet.
3 · Transfer ₦1,000 from A → B
Not run yet.
4 · App-user signup (Auth-as-a-Service)
Simulates a bank app's customer signing up through Finsam Tech.
Not run yet.
5 · App-user login
Not run yet.
6 · Verify session (/api/auth/me)
Not run yet.
Usage Logs
Last 50 API requests made with your key.