Quickstart

Collect your first payment into a virtual account.

This takes one API call and one webhook. Use your test key throughout.

1. Create a virtual account

   curl -X POST https://flickopenapi.co/collection/nuban-create-perm \
     -H "Authorization: Bearer sk-..." \
     -H "Content-Type: application/json" \
     -d '{
       "first_name": "Ada",
       "last_name": "Obi",
       "email": "[e-mail]",
       "phone": "08012345678",
       "currency_collected": "NGN"
     }'
   

   The response carries the account number and the bank it was issued by.

   Display the bank_name from the response, not a bank name you hardcoded. Flick issues NGN virtual accounts through more than one partner bank and which one is in use changes over time. A payer shown the wrong bank will abandon the transfer.

2. Have the payer transfer to it

   Any Nigerian bank app will do. With a test key no money moves.

3. Receive the webhook

   Flick posts charge.success to your registered URL. Verify the flick-signature header, deduplicate on data.Id, then credit the order.

   See Verifying webhooks.

4. Confirm independently

   Before releasing anything of value, re-read the transaction rather than trusting the webhook body:

   curl -X POST https://flickopenapi.co/transaction/status \
     -H "Authorization: Bearer sk-..." \
     -H "Content-Type: application/json" \
     -d '{"transactionId": "flick..."}'
   

​

Next

Checkout instead

Hosted checkout for card, transfer and bank.

Pay someone out

NGN transfers with name enquiry.