Quickstart
Go from zero to your first API call in about five minutes.
1. Create an account
Sign up at app.finlogic.com. Once your business is verified you get access to the dashboard where you can manage API keys, monitor transactions and configure webhooks.
2. Get your API keys
In the dashboard, go to Settings → API Keys. You will find two pairs of keys:
| Key | Prefix | Purpose |
|---|---|---|
| Test secret key | sk_test_ | Full API access in the sandbox. No real money moves. |
| Live secret key | sk_live_ | Production access. Real transfers, real settlements. |
Keep secret keys secret. Never expose them in client-side code, mobile apps or public repositories. Use environment variables on your server.
3. Make your first request
Request a cross-border quote to confirm your key works. Replace sk_test_... with your test secret key:
cURL
curl https://api.finlogic.com/v1/quotes \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"source_currency": "USD",
"destination_currency": "NGN",
"amount": 1000,
"amount_type": "source"
}'
PHP
$ch = curl_init('https://api.finlogic.com/v1/quotes');
curl_setopt_array($ch, array(
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer ' . getenv('FINLOGIC_SECRET_KEY'),
'Content-Type: application/json'
),
CURLOPT_POSTFIELDS => json_encode(array(
'source_currency' => 'USD',
'destination_currency' => 'NGN',
'amount' => 1000,
'amount_type' => 'source'
))
));
$quote = json_decode(curl_exec($ch), true);
curl_close($ch);
A successful response returns a locked quote:
Response · 200 OK
{
"id": "qt_8f2k1x9d",
"source_currency": "USD",
"destination_currency": "NGN",
"source_amount": 1000,
"destination_amount": 1534500,
"rate": 1534.50,
"fee": 8.50,
"expires_at": "2026-07-10T15:24:00Z",
"status": "active"
}
4. Go live
- Complete business verification in the dashboard.
- Swap
sk_test_forsk_live_in your environment config. - Configure a production webhook endpoint so you receive transfer updates.
Next: read how authentication works, then dive into the product guide you need.