Documentation

Welcome to DroppCash

DroppCash is a multi-currency digital wallet. You can hold money in many currencies, send it to other people, pay businesses, get paid, exchange between currencies, hold payments safely in escrow, and turn cash into wallet money (and back) through agents. This guide explains every feature, how to set it up, what it costs, and what to do when something does not go as expected, so you can use the platform without needing to contact anyone.

New on DroppCash

Everything recently added is covered here: your own NGN account number, Pay with Protection, payment links, savings pockets, scheduled payments, Esusu groups, bills & airtime, USSD banking, USD virtual cards, spending insights and notifications, the merchants' online store, cash codes, auto-settlement, webhooks, staff accounts and invoice autopay, plus the agent tools: the agents map, float accounts, sub-tellers and end-of-day sheets, the ₦300 onboarding bounty and the earnings ledger. The newest additions — marked New — are pay-by-bank deposits (Mono and Plaid, plus Rapyd cards), the POS terminal API for agents, and the AI case analyst that prepares every escrow dispute for our support team.

The three account types

DroppCash has three kinds of accounts. Each one has its own sign-up page, its own login and its own dashboard. Pick the one that matches what you want to do.

 UserAgentMerchant
Who it is forIndividuals, freelancers, small sellers, anyone who wants to hold and move moneyShops and individuals who handle cash for customersBusinesses and websites that want to be paid
Main purposeDeposit (gateway, pay by bank, your own account number or an agent), send (plain or protected), save (pockets, Esusu), pay bills and merchants, USD cards, USSD, get paid (links, invoices, account number), withdrawCash In (give customers wallet money for cash), receive Cash Out payments (customers collect cash from you), customer cash-out by SMS code, create and redeem cash vouchers, redeem merchant cash codes, register customers for a bounty, sub-tellers and end-of-day sheets, POS terminal cash-inReceive payments by email, phone, QR code, API or online store, cash codes through agents, cash vouchers, auto-settlement to your bank, then withdraw
Sign updroppcash.app/user/registerdroppcash.app/agent/registerdroppcash.app/merchant/register
Logindroppcash.app/user/logindroppcash.app/agent/logindroppcash.app/merchant/login
Approval needed?No. Verify your email and you are in. Some features need identity verification (KYC).Yes. Our team reviews every agent before they can log in.No for sign-up. Identity verification (KYC) is needed before you can withdraw.
Can send money to people?Yes, by email or verified phone number (even to someone without an account yet, by email)Only through Cash In to customersNo. Merchants receive and withdraw.
Can accept payments?Yes (invoices, escrow, and a user API key)NoYes (by email, QR code, API checkout and escrow checkout)
Good to know

The three account types are completely separate. A User account, an Agent account and a Merchant account that use the same email address are three different accounts with three different wallets and three different passwords. When you send money to someone you must send it to the right account type: a Transfer goes to a User, a Payment goes to a Merchant, and a Cash Out goes to an Agent.

Which one should I choose?

  • I want to save, send money to friends, pay shops, or get paid for freelance work: create a User account.
  • I run a shop, a service or a website and want to accept payments from DroppCash customers: create a Merchant account.
  • I want to earn commission by handling cash for people near me: apply as an Agent.

Key ideas you will see everywhere

Wallets

Every account holds a separate wallet for each currency. You get one wallet when you sign up and new ones appear automatically when you receive, deposit or exchange into another currency.

Fees

Each action has a small, clearly shown fee. You always see the fee and the total on the form before you confirm.

Limits

Every action has a minimum and maximum, and sending and cash-out also have daily and monthly caps. They are shown on the form.

KYC

Identity verification. Some actions stay locked until your documents are approved. It is a one-time process.

Protection

Payments where the money is held until the buyer approves the delivery. Used for strangers, big deals and store checkouts (see Pay with Protection).

Pockets

Ring-fenced savings spaces inside your wallet, with optional time locks (see Savings pockets).

Transaction reference

Every movement of money has a unique reference. Quote it if you ever need help, and use it to search your history.

Security

Email verification, optional SMS two-step login, and a record of every login to your account.

Verified phone number

Confirm your phone number with an SMS code to log in with it and to let people send you money by phone. See Phone number and verification.

Refer & Earn

Invite people with your personal link and earn a share of the fees they pay. See Refer & Earn.

Quick start in 5 minutes

  1. Sign up. Choose your account type above and fill in the form. Use your real name, because it is used for identity checks and bank withdrawals.
  2. Verify your email. A 6-digit code is sent to your email. Enter it to unlock your dashboard.
  3. Verify your identity (KYC). Upload an ID once, from the banner at the top of your dashboard. This unlocks sending, paying, exchanging, cashing out and withdrawing.
  4. Turn on two-step security. Optional but strongly recommended. See Two-step security.
  5. Start using it. Customers: add money with Deposit, by pay-by-bank or with your own account number. Agents: wait for approval, then open your float account. Merchants: finish KYC, then share your email or QR code, set up the store or connect the API.

Creating an account

Open the sign-up page for your account type, complete the form, and submit. Registration must be open (if registration is ever paused you will see a message saying so).

FieldUserAgentMerchant
Full nameRequiredRequiredRequired
Business name-RequiredRequired
Business address-Required-
National ID number and photo of the ID-Required (photo as JPG or PNG)-
EmailRequired, must be uniqueRequired, must be uniqueRequired, must be unique
Phone numberRequired (choose your country dial code)RequiredRequired
CountryRequiredRequiredRequired
AddressRequiredRequiredRequired
Password and confirmationRequiredRequiredRequired
  • Your country decides your first wallet. A wallet in your country's currency is created for you automatically (for example, a Nigerian account starts with an NGN wallet).
  • Your phone number matters. It is used to send your two-step security code and your phone verification code by SMS, so enter it correctly with the right country dial code. Right after you sign up you are offered to verify it (you can skip and do it later). See Phone number and verification.
  • If the number is already used. When you sign up with a phone number that another DroppCash account already uses, you see a notice. You can still use your account with your email. Only one account can verify a given number, and the first to verify it keeps it, so you may need to change yours.
  • Referral code (optional). If someone invited you, their code is filled in automatically when you use their link, or you can type it in on the sign-up form. See Refer & Earn.
  • Choose a strong password. Use a long, unique password. Never reuse a password from another site.

Verifying your email

Right after you register, a 6-digit verification code is emailed to you and you are asked to enter it. Until you do, the rest of your dashboard stays locked.

  • Did not get the email? Check spam or promotions, then use Resend code on the verification page.
  • Typed the wrong email at sign-up? Contact support from the contact page so the email can be corrected.

Logging in and resetting your password

Log in with your email or your verified phone number and your password at the login page for your account type. The first box is labelled "Email or phone number". A phone number only works for login once you have verified it; until then use your email. If a number does not work, you get the same "credentials don't match" message as for a wrong password, so nobody can use the form to find out which numbers are registered. If you try too many wrong passwords in a short time, login is briefly slowed down, so wait a minute and try again.

Forgot your password?

  1. Click Forgot password on the login page and enter your account email.
  2. Enter the reset code that is emailed to you.
  3. Choose a new password and confirm it. Then log in with it.

Changing your password while logged in

Users: Profile Setting in the account menu (top right). Agents and Merchants: Setting > Change Password in the sidebar. Enter your old password, then the new one twice.

New sign-in alerts

Every time your account is signed in, we email you a security alert with the time, the device, the location and the IP address. If it was you, ignore it. If it was not you, use the reset link in that email to change your password at once, turn on two-step security, and open a support ticket.

Agent accounts

If you see "your agent request is still pending", your agent application has not been approved yet. See Agent approval.

Two-step security (SMS code at login)

Two-step security adds a one-time code, sent by SMS to the phone number on your account, to the login process. Even if someone learns your password they cannot get into your account without your phone.

Turn it on

  1. Open Two Step Security: in the account menu (Users) or under Setting in the sidebar (Agents, Merchants).
  2. Enter your account password and confirm it.
  3. We send a code by SMS to your phone. Enter it on the next page.
  4. Two-step security is now active. You can turn it off the same way (password, then SMS code).

What happens at login once it is on

After you log out and sign in again, you are asked for a fresh SMS code before you reach your dashboard. If a code does not arrive, check that your phone number (with country code) in your profile is correct and that your phone can receive SMS, then use Resend code.

Keep your phone number current

If you lose access to the number on your account while two-step security is on, you will not be able to log in. Contact support to recover your account before you change SIM cards or numbers.

Identity verification (KYC)

KYC ("know your customer") confirms that you are who you say you are. It protects you and everyone else on the platform. You submit your details once. Our team reviews them and your account is unlocked when they are approved.

What KYC unlocks

AccountNeeds KYCWorks without KYC
UserTransfer money, exchange, pay a merchant, create a cash voucher, make an escrow, cash out to an agent, withdraw to a bank or walletDeposit, request money, create invoices, redeem cash vouchers, view history, profile settings
MerchantWithdrawReceiving payments, API key, viewing transactions
AgentAgents do not fill the KYC form. Your ID number and ID photo are taken at sign-up and reviewed as part of agent approval.

How to submit KYC

  1. Log in. A banner at the top of the dashboard says "Please submit your KYC information to enjoy full access". Click Take me there. (Trying to use a locked feature also takes you to the KYC form.)
  2. Users: fill in the ID number that matches the document you will upload. You can give any of: National Identification Number (NIN), Passport ID number, Driving License ID number, National ID Number Slip (NINS), or Voters Card. Then upload a clear photo of the ID under Upload Proof of Selected ID (required).
    Merchants: enter your Business Name (required), one ID number (NIN, Passport or Driving License), and upload the Proof of Selected ID (required).
  3. Uploaded images must be PNG, JPG or JPEG and up to 5 MB each. Make sure the photo is sharp, uncropped and fully readable.
  4. Submit. Your status changes to under review.

KYC statuses

StatusWhat you seeWhat to do
Not submittedBanner asking you to submit KYC; locked features send you to the KYC formSubmit the form
Under review"Your KYC data is currently under review."Wait. You cannot submit again while it is being reviewed.
VerifiedNo banner. All features unlocked.Nothing
Rejected"Your KYC data was rejected. Please re-submit." A See Reasons link shows why.Read the reasons, fix them (usually a blurry or mismatched document), and re-submit.
Get approved first time

Use an unexpired government ID. Make sure the name on your DroppCash profile matches the name on the ID exactly. Photograph the original document in good light, not a screenshot of a screenshot.

Wallets and currencies

Your dashboard shows one wallet card for each currency you hold. Money in one currency is completely separate from money in another until you exchange it.

How wallets are created

  • One wallet is created at sign-up, in your country's currency.
  • A new wallet is created automatically the first time money arrives in a new currency (a transfer, a deposit, a cash voucher you redeem, an exchange, a cash-in) so you never need to "add a wallet" manually.
  • Forms that move money out of your wallet (transfer, payment, cash out, withdraw and so on) only list wallets that currently have a balance.

Supported currencies

Fiat: NGN (default, Nigerian naira), USD, EUR, GBP, GHS, KES, UGX, TZS, RWF, ZMW, ZAR, EGP, XOF, XAF, AED, CAD, AUD, NZD, SGD, HKD, JPY, CNY, INR, BDT, MYR, THB, TRY, ILS, UAH, BRL, MXN, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN.

Crypto: BTC, ETH, USDT, BNB, SOL, ADA, TRX, LTC, DOGE, KCS.

The currencies available at any time are the ones shown in the currency pickers inside your dashboard. Which currencies you can deposit or withdraw depends on the methods enabled for each currency.

Exchange rates

Rates between currencies are kept up to date automatically — refreshed every 6 hours for fiat currencies and every 15 minutes for crypto — and are shown on the exchange form before you confirm. Each currency can carry separate buy and sell prices with a small margin, so the rate going one way can differ from the rate going back. Fixed fees (for example "NGN 10") are expressed in the default currency (NGN) and are converted into the currency of the wallet you are using, so a fee in a USD wallet is the equivalent amount in USD.

Limits are counted in naira

Minimum, maximum, daily and monthly limits are set in the default currency (NGN). When you use another currency, the platform converts your amount at the current rate to check the limit. For example, a limit of NGN 100 to NGN 1,000,000 is converted into the equivalent range in your wallet currency.

Your personal account number New

Every customer can have a permanent Nigerian bank account number in their own name. Any transfer from any Nigerian bank — or from an agent's shop account — lands straight in your DroppCash wallet, with no approval step. This is the cheapest and most reliable way to fund your wallet, and the first thing to try.

How to get your account number

  1. Go to Receive > Account Number.
  2. Fill in your first name and last name exactly as they are on your BVN, your 11-digit BVN, and tick the consent box. Your BVN goes to our licensed payment partner to issue the account — it is never stored on DroppCash servers.
  3. Press Get my account number. While it is being prepared the page says "Your account number is being set up…". It is usually ready in seconds to a few minutes.
  4. Once it is active, the page shows the bank name and your permanent account number, with your recent automatic deposits listed underneath.

From then on, just give anyone that account number like any bank account. Transfers into it appear in your wallet automatically as deposits, with an email receipt.

  • One account number per user. The names you enter must match your BVN record, otherwise the partner refuses the request.
  • Requests are limited to 5 per minute to keep the partner happy — if you just created one, wait a moment before trying again.
  • There is no extra fee for receiving through your account number. Standard deposit rules apply.
  • Like every feature, the account number can be switched off by the platform for maintenance; the menu simply says so when it is.
Trainer's tip

For anyone who has a bank account, teach this first: "Transfer to your own DroppCash account number like you would to any bank account." Cash-in at an agent remains the option for people who deal in cash. Agents get the same kind of account for their shop — see Float account.

Transactions and receipts

Every movement of money is saved with a unique transaction reference. Open Transactions in your dashboard to see your history.

  • Search by transaction reference to find one payment fast.
  • Filter by type (Users can filter by Transfer Money, Request Money, Money Exchange, Invoice Payment, Merchant Payment, Merchant API Payment, Make Escrow, Escrow Return, Withdraw Money, Withdraw Reject, Create Cash Voucher, Redeem Cash Voucher, Deposit, Cash In and Cash Out). Agents and Merchants can also filter by type.
  • Open a transaction to see its details: amount, fee, currency, date, description and balance effect.
  • You also receive an email receipt for important actions such as transfers, payments, cash-ins, cash-outs, escrows and withdrawals.
Reading the sign

A + transaction adds money to your wallet; a - transaction removes it. The fee column shows the fee that was charged on that transaction.

Your QR code

Every account has a personal QR code. Instead of typing your email, a sender or customer scans it and your details are filled in for them.

  1. Users: open the account menu and choose QR Code. Agents and Merchants: choose QR Code in the sidebar.
  2. Click download to save the QR code as an image. Print it for your shop counter or share it on your social pages.
  3. Merchants and Agents: for a ready-made shop sign, open Payment Banner in the sidebar. It draws a printable "DroppCash accepted here" (merchants) or "Cash out here" (agents) poster with your QR code in the middle.
Your email stays private

Your QR code does not contain your email address any more. It holds an encrypted token that only DroppCash can read: someone who scans it with an ordinary camera or QR app sees only an unreadable code, and no one can work out your email from it or forge a code for a different account. When a customer scans it inside DroppCash (the app or the website), we decode the token and show them your name to confirm. Old QR codes you printed before still work: they are accepted everywhere a new one is.

Customers should always check that the name that appears after scanning is the right person or business before they confirm a payment.

Profile settings

  • Users can update their name, phone number, city, ZIP/postal code, address and photo. If you change your phone number to a different number, it has to be verified again.
  • Agents and Merchants can update their business name, contact name, city, ZIP/postal code, address and photo (the photo is cropped to a square).
Use your real full name

For instant bank withdrawals in naira, the name on the receiving bank account must match the name on your profile (at least two parts of the name must match). Make sure your profile has your first and last name as they appear on your bank account.

Your phone number and phone verification

Your phone number can be used to log in and to receive money, but only after you have proved it is yours with an SMS code. This applies to User, Agent and Merchant accounts. Your email always works whether or not you verify.

What verifying gives you

 Number not verifiedNumber verified
Log in with your phone numberNo (use your email)Yes
Be found by phone number when someone sends you money, requests money from you, creates an escrow for you, pays you (merchants) or serves you at an agentNo (they must use your email)Yes
Everything else (receiving by email, using the app, two-step security codes)WorksWorks

How to verify your number

  1. Log in with your email. After you sign up you are taken to the verification page straight away; later, use the Verify now button in the yellow banner at the top of your dashboard.
  2. Check that the number shown is correct. If it is wrong, choose Change it in your profile, fix it, and come back.
  3. Press Send code. A 6-digit code is sent by SMS to your number.
  4. Type the code and press Verify. The banner disappears and your number is verified.
  • The code works for 10 minutes and allows 5 wrong tries. After that, ask for a new code.
  • You can ask for a new code once a minute, up to 5 times an hour.
  • Use Skip for now to verify later. Nothing else is blocked while the number is unverified.

One number, one account

Only one account of each type (User, Agent, Merchant) can hold a verified number. The first account to verify a number keeps it. If another account has already verified your number you see a message asking you to change your phone number in your profile, and you can use your email in the meantime.

Changing your number

If you change your phone number to a different one, verification is cleared and you verify the new number the same way. Writing the same number in a different style (for example 0803... instead of +234803...) does not clear it.

Never share the code

The code proves you own the number. DroppCash will never ask you for it, and nobody who needs your money should either. Do not read it out to anyone.

The SMS did not arrive?

Wait a minute or two (SMS can be slow on some networks), check that the number has the right country code and can receive SMS, and ask for a new code. If it still does not arrive, open a support ticket. After we confirm the number is yours, our team can verify it for you.

Refer & Earn

Invite people to DroppCash with your personal link. When they join and use the platform, you earn a share of the fees DroppCash charges them. It costs the person you invite nothing extra. Users, Agents and Merchants can all refer people.

How to start

  1. Open Refer & Earn. Users find it in the account menu (top right); Agents and Merchants find it in the sidebar.
  2. Copy your personal link (or your code) or press the share button to send it on WhatsApp.
  3. When someone signs up using your link, they are attached to you. A link is remembered for 30 days on the visitor's device, and the person can also type your code in on the sign-up form (web and mobile app). Inviting by sending money counts too: if you send money to someone who has no account yet and they join through the link in that email, they are linked to you as your referral.
  4. Follow your invitations and earnings on the same page: people who joined, who is active, and each earning with its status.

What you earn

If you are a User1% of the fee
If you are a Merchant15% of the fee
If you are an Agent2% of the fee
How long a person keeps earning for you12 months from when they joined
Earnings are held for7 days, then paid into your wallet
  • You earn on the fee DroppCash charges on the invited person's paid transactions, not on the amount. If a transaction has no fee, nothing is earned. The transactions that count at the moment are: escrow, merchant payment, api payment, cash out, currency exchange, cash voucher, invoice payment, request money.
  • Earnings are paid in the same currency as the fee.
  • For escrow, the earning is only released once the escrow is released. If an escrow is returned to the buyer, that earning is cancelled.
  • Suspicious sign-up patterns are held for review; referral earnings whose hold has ended are paid automatically every 15 minutes.

Fair play

Sign-ups that look suspicious (for example the same phone number or the same internet connection as the person who invited them, or an unusually large number of sign-ups in a day) are held for review and earn nothing until DroppCash approves them. Do not refer yourself or create accounts only to collect rewards.

Help Assistant (AI)

The chat bubble in the bottom-right corner of the website and of every dashboard is DroppCash's built-in help assistant. Ask it anything about using DroppCash, in any language you like, and it answers in seconds with exact menu names and current fees and limits.

How to use it

  1. Click the chat bubble at the bottom-right corner. It is available on the public website and inside the User, Agent and Merchant dashboards.
  2. Type your question, or tap one of the suggested questions shown when you open it. They change with who you are: a visitor sees "Which account type should I choose?", an agent sees "How do I get float?", a merchant sees "How do I connect my website?", and so on.
  3. Keep the conversation going: you can ask follow-up questions in the same chat, and the assistant remembers the last few messages.

What it is good at

  • Step-by-step help for every feature in this guide, answered from this guide and from live figures: the current fees, limits, currencies and withdrawal methods, so an answer never goes out of date.
  • It knows a little about your account status when you are logged in (for example that your KYC is under review or your agent application is pending) and tailors the answer to it.
  • It replies in the language you write in, including Nigerian languages.

What it cannot do (on purpose)

  • It cannot see your balance or transactions, cannot move, reverse, refund or approve money, and cannot look up other people's accounts. For a problem with a specific payment, open a Support Ticket with the transaction reference.
  • It is not a financial, legal or tax adviser and will not recommend investments or ways around fees, limits or KYC.
  • If it is not sure, it says so and points you to a support ticket or hello@droppcash.app, instead of guessing.
Never type secrets anywhere

The assistant will never ask for your password, your two-step SMS code, an email verification code, a cash voucher code, your card number or your API key. If you paste one by mistake, the assistant tells you to remove it and, for a key or code, to regenerate or change it. DroppCash staff will never ask for these either.

There is a fair-use limit per day (about 30 questions when you are logged in, 10 when you are a visitor) so the assistant stays fast for everyone. When you reach it, you can still open a support ticket or email us.

Getting help

  • Help Assistant. The chat bubble in the bottom-right corner (see above) answers questions about using DroppCash instantly.
  • Support tickets. Open Support Ticket in your dashboard, write a subject and a message, and attach a PDF, JPG or PNG if it helps (for example a screenshot). You can reply on the same ticket and our team answers there. This keeps a full record of the conversation. A ticket is always the right choice for anything about a specific payment, your balance or your documents.
  • Email: hello@droppcash.app, or use the contact page.

What to include in a support request

  1. Your account type (User, Agent or Merchant) and the email on the account.
  2. The transaction reference, if the question is about a payment.
  3. What you expected to happen, what actually happened, and any message you saw (a screenshot is ideal).

Staying safe

DroppCash will never ask for these

We will never ask you for your password, a two-step SMS code, an email verification code, or your cash voucher codes, by phone, chat, email or social media. Anyone who asks is a scammer.

  • Only log in at droppcash.app. Check the address bar before you type your password.
  • Turn on two-step security.
  • Always check the recipient email on a transfer or cash out before you confirm. Transfers are instant and cannot be reversed by you.
  • Treat cash voucher codes like cash. Anyone who has the code can redeem it.
  • For escrow: do not release funds until you have what you paid for.
  • Never share your API access key. If it leaks, generate a new one at once.
  • Log out on shared computers. Every sign-in to your account is recorded with its IP address and location, and we email you a new sign-in alert each time, so you always know when someone gets in.
  • If the Help Assistant or anyone claiming to be DroppCash asks you for a password, SMS code or voucher code, refuse and report it.

For Users User account

A User account is your personal DroppCash wallet. This part of the guide covers everything you can do with it, step by step, including the fees and limits that apply.

What you get with a User account

Deposit

Add money by card, bank transfer, mobile money, pay-by-bank or crypto.

Transfer money

Send to any DroppCash user by email or verified phone number, instantly. Even if they do not have an account yet, you can send to their email and the money is held for them.

Saved recipients

Save the people you pay often, so you pick a name instead of typing an email or phone number.

Request money

Ask another user to pay you.

Exchange

Convert between 50 fiat and crypto currencies, at live buy and sell prices.

Account number

A personal NGN bank account number in your name. Transfers from any Nigerian bank land straight in your wallet.

Pay with Protection

Pay strangers safely: the money is held until you approve the delivery, with milestones, a chat and disputes.

Payment links

A link and QR that collect money for you — fixed amount or payer's choice, with optional protection.

Savings pockets

Ring-fenced pockets for goals, with optional locks from 30 to 365 days.

Scheduled payments

Standing orders and savings auto-funds that move money on a calendar.

Esusu

Rotating savings circles for 5–25 people, with a transparent ledger and automatic collection.

Bills & airtime

Airtime, data, TV and electricity, paid from the wallet.

USSD banking

Balance, transfers and airtime on any phone, no internet needed.

USD virtual cards

Dollar cards for online payments, funded from your naira wallet.

Insights

Spending analytics, a monthly review email and an in-app notification inbox.

Pay merchants

Pay any DroppCash business from your wallet.

Cash vouchers

A one-time code worth real money. Share it privately, and whoever redeems it gets the cash in their wallet.

Invoices

Bill customers and get paid to your wallet — with due dates, reminders and autopay.

Escrow

Hold a payment safely until you are happy, and chat privately with the other person while it is held.

Cash out to agent

Turn wallet money into cash near you.

Withdraw

Send money to a bank account, PayPal, Payoneer or crypto address.

API key

Developers can accept payments, create escrows and invoices from their own app.

Security tools

Two-step login, phone verification, QR code, login history, support tickets.

Refer & Earn

Invite friends and earn a share of the fees they pay.

Setting up your User account

  1. Register at droppcash.app/user/register (name, email, phone with dial code, country, address and password). See Creating an account.
  2. Verify your email with the 6-digit code we send you.
  3. Complete your profile. Open the account menu (top right) > Profile Setting. Add your city, address and photo. Make sure your name matches your bank account name if you plan to withdraw to a bank.
  4. Submit KYC (how). Without it you can still deposit, request money, create invoices and redeem cash vouchers, but you cannot send, pay, exchange, cash out or withdraw.
  5. Turn on two-step security (how).
  6. Verify your phone number with an SMS code so you can log in with it and be found by it (how). Optional.
  7. Get your account number (how) so bank transfers land in your wallet instantly.
  8. Explore the rest when you are ready: Pay with Protection, pockets, bills, virtual cards and the other tools in the Customer guide below.
  9. Add money with Deposit and you are ready.

Your dashboard and menu

The top menu groups everything by purpose:

MenuWhat is inside
DashboardYour wallets and balances, and your recent activity
Transfer & RequestTransfer Money, Request Money, Sent Requests, Received Requests
ExchangeConvert one currency to another
PaymentPay a merchant, and see your payment history
Cash voucherMy cash vouchers, Create cash voucher, Redeem cash voucher, Redeemed History
DepositDeposit, Deposit history
WithdrawCash out to Agent, Withdraw Money, Withdraw history
InvoiceInvoices, Create Invoice
EscrowMake Escrow, My Escrow, Pending Escrows
Pockets & Scheduled & LifestyleSavings pockets, Scheduled payments, Bills & Airtime, USSD Code, Virtual Cards, My Spending, Notifications
TransactionsFull history with search and filters
ApiYour API access key and test/live mode
Account menu (top right)Profile Setting, QR Code, Two Step Security, Refer & Earn, My recipients, Pending transfers, Support Ticket, Logout
If a feature says it is switched off

Each feature can be switched off by the platform (for example during maintenance or for a partner review). If you open one and see a notice that it is currently unavailable, try again later or open a support ticket.

Deposit: add money to your wallet

You can add money in many currencies. The methods you see depend on the currency you choose, because each method supports specific currencies. KYC is not required to deposit.

Two more ways to fund your wallet

Pay by bank New: in supported countries you can pay straight from your internet or mobile banking — Mono (instant, Nigeria) and Plaid (UK and Europe) appear in the gateway list where they are enabled, and the payment is confirmed automatically. Rapyd New adds card and local payment methods in more markets. You never leave the normal deposit flow: pick the method, approve it in your banking app or card page, and the wallet is credited. If a pay-by-bank method is not configured for your account you will simply not see it in the list.

Fund by bank transfer to your own account number

Get a permanent NGN account number in your own name under Receive > Account Number and send to it from any Nigerian bank — the money lands in your wallet instantly, with no approval step. See Your personal account number.

How to deposit

  1. Go to Deposit > Deposit.
  2. Type the amount first.
  3. Choose the wallet currency you want to fund. The list of gateways (payment methods) for that currency then appears. (If you see "No payment method found associated with this currency", that currency cannot be funded right now.)
  4. Pick a gateway. Any fee for that method and the total you pay are shown.
  5. Click Confirm and complete the payment.

Two kinds of deposit methods

 Automatic methodsManual methods
ExamplesCard, bank transfer, USSD and mobile money through our payment partners (for example Paystack, Flutterwave and Fincra) for currencies such as NGN, USD, KES, GHS, UGX, XOF, XAF and TZS; pay-by-bank with Mono (Nigeria, instant) and Plaid (UK and Europe); card and local methods with RapydInternational bank transfer in many currencies (for example GBP, EUR, USD, CAD, AUD, SGD and others) and crypto deposits (BTC, ETH, USDT, SOL, TRX, ADA, LTC, DOGE)
How it worksYou are sent to a secure payment page (or, for pay-by-bank, approve the payment in your own banking app). When the payment succeeds your wallet is credited automatically.You are shown our account (or wallet address). You pay it from your own bank or crypto wallet, then submit your transaction details. Our team confirms the payment and credits your wallet.
SpeedUsually within moments of a successful paymentEach method shows an estimated time (for example 1-2 days for bank transfers). Your deposit shows as pending until it is confirmed.
Crypto deposits: send the right coin to the right address

Only send the exact coin shown (for example Bitcoin to a BTC address) and use the network named in the instructions. Coins sent to the wrong address or the wrong network cannot be recovered.

Bank transfers: use the right reference

Pay the exact amount, from an account in your own name, and keep your bank receipt. Add the transaction details the form asks for (such as the transaction ID or reference) so our team can match your payment quickly.

Check the status of a deposit

Open Deposit > Deposit history. Each deposit shows amount, fee, method and status: completed (credited) or pending (awaiting confirmation). A completed deposit also appears in your Transactions as Deposit.

Deposit fees

Any fee for a method is displayed on the deposit form before you confirm. Manual methods add their fee on top of the amount you deposit.

Transfer money to another user

Send money from your wallet to another DroppCash User using their email address or their verified phone number. It arrives instantly and the receiver gets the full amount you send. Requires KYC. If the person does not have an account yet, see Send to someone without an account. Paying someone you do not know? Tick Pay with protection on the form — the money is held until the delivery is approved. See Pay with Protection.

How to transfer

  1. Go to Transfer & Request > Transfer Money.
  2. Enter the receiver's email or phone number, or pick them from My recipients. We check that it belongs to a DroppCash user and show who it is. To protect their privacy we only show a short form of the name, such as "Ada O.", so check it is the person you mean.
  3. A phone number only finds someone who has verified it. If we cannot find the number, ask for their email address instead. If it is an email with no account, you are offered to hold the money for them (see below).
  4. Choose the wallet to send from and enter the amount.
  5. Check the fee and total shown, then confirm.

What happens

  • Your wallet is reduced by the amount plus the fee.
  • The receiver's wallet is increased by the full amount. If they have no wallet in that currency, one is created for them.
  • You both get an email with the transaction reference, and the transfer appears in Transactions and in the transfer history (where you can search by reference).

Fees and limits

Transfer fee (paid by the sender)Free
Minimum per transferNGN 100
Maximum per transferNGN 1,000,000
Daily sending limitNGN 2,000,000
Monthly sending limitNGN 50,000,000

Limits are counted in the default currency. Your daily total resets at midnight and your monthly total resets on the 1st of each month. Only money you send counts; money you receive does not.

Double-check the email or number

Transfers are instant and cannot be reversed by you. If you send to the wrong (but valid) user, only that person can send it back. You cannot send money to your own account.

Pay with Protection New

The same transfer you already know, with escrow switched on underneath: instead of landing in the receiver's pocket, the money is held by DroppCash until the buyer approves the delivery. Before anything is delivered, the buyer can cancel for a full refund, fee included. Use it whenever you are paying a stranger or paying for goods — it is the safest way to send money on DroppCash.

Protection appears in three places, and they all create exactly the same protected payment:

  • Transfer Money — tick Pay with protection on the transfer form.
  • Payment links — tick Protect this payment when you create the link (see Payment links).
  • The online store — buyers can check out with protection on merchant storefronts (see My Store).

How a protected payment works (as the buyer)

  1. Open Transfer & Request > Transfer Money and fill it in as usual (email or verified phone, wallet, amount).
  2. Tick Pay with protection. The fee preview now shows the protection charge: 1% + NGN 100. You can choose to pay it on top, or let it come off the seller's payout.
  3. Confirm. Your money leaves your wallet and is held by DroppCash. The seller is told the money is secured, and you both see the Protected badge.
  4. When the delivery reaches you and you are happy, open Escrow > My Escrow and press Release. The money moves to the seller.
  5. Changed your mind before anything is delivered? Press Cancel on the protected payment — you get a full refund including the fee. Cancelling is only possible before the seller starts delivering.

Milestones: pay a big job in stages

For phased work (a project, a renovation, a contract) you can split a protected payment into milestones when you create it: at least two stages whose amounts add up to the total. The seller marks each stage delivered with a note and an optional photo (up to 5 MB), you review it, and you release that stage's money. Nobody has to bet the whole amount at once.

Delivery windows and auto-release

When you create the protected payment you choose an auto-release window: 7, 14 (default) or 30 days. If you do nothing, the money releases to the seller automatically when the window ends — so funds cannot sit hostage forever and sellers do not chase buyers. Opening a dispute freezes the countdown. The platform checks the windows every hour and emails both sides before anything auto-releases.

Chat and disputes

  • The Escrow chat opens the moment money is held: 1,000-character messages, images up to 3 MB, live updates. Keep the deal talk inside it — it is what support reads if something goes wrong.
  • Not happy? Press Dispute and pick a category (not delivered / not as described / partial delivery / other), tell the story, choose the outcome you want (refund / release / let support decide) and attach evidence. The case reaches the DroppCash team instantly and the money stays locked until it is decided.
  • Big cases — deals of ₦200,000 or more — are automatically flagged as priority in the support queue.
  • Guardrail: at most 5 protected payments per sender per day — it routes unusual activity to review instead of blocking money.
  • A protected payment can only ever complete once — released, refunded or closed. There are no double payouts.
  • Our public droppcash.app/protection page shows how the protection system performs: deals protected, median dispute resolution time and release share.
  • Everything above also applies to escrow created from the Escrow page — one protection system, several entrances.
For sellers

"A protected payment is money you already have. You deliver with confidence, and the buyer cannot reverse it once they release." For buyers: "You never send first and hope."

Send money to someone who is not on DroppCash yet

You can send money to an email address that has no DroppCash account. We hold the money safely, email the person, and pay it into their new wallet as soon as they open an account with that email and verify it. If they do not, the money comes back to you. It is a good way to invite someone and pay them at the same time. Requires KYC (as for any transfer).

How to send

  1. Go to Transfer & Request > Transfer Money and type the person's email. (This works with an email only, not a phone number.)
  2. If there is no DroppCash account for it, the form tells you the money will be held for 14 days and that they will be emailed to open an account. Choose the wallet and amount and confirm.
  3. The amount plus the normal transfer fee leaves your wallet at once and is held. You get an email with the reference.
  4. The person receives an email with a link. They sign up with the same email address and verify it. The money is then added to their wallet automatically.

Following, cancelling and refunds

  • See all your held transfers in the account menu under Pending transfers. Each shows who it was sent to, the amount, its status and when it expires.
  • You can cancel a held transfer at any time before it is claimed. The full amount and the fee go straight back to your wallet.
  • If nobody claims it within 14 days it expires and the full amount and fee are returned to you automatically (the platform checks every 15 minutes).

Limits

FeeThe normal transfer fee (Free), returned to you if the transfer is cancelled or expires
Holding time14 days
Maximum per held transferNGN 100,000
Held transfers you can start per day5
If you are the person receiving it

Open the link in the email, create your account with that exact email address and verify the email with the 6-digit code. The money appears in your wallet. Before you can withdraw or cash out money that reached you this way you must complete identity verification (KYC); it stays safely in your wallet meanwhile.

Saved recipients

Save the people you send money to often. Next time you pick their name instead of typing an email address or phone number.

  1. Open the account menu (top right) > My recipients.
  2. Add a person with a nickname and their email or verified phone number. We check that it belongs to a DroppCash User and keep the short name we found (such as "Ada O.") so you can see who it is.
  3. When you use Transfer Money, Request Money or Make Escrow, open the recipient list on the form and choose a person. Their email or phone number is filled in for you.
  • You can save up to 100 recipients and delete one at any time.
  • Only you can see your list.

Request money from another user

Ask another user to pay you. They get a request they can accept or reject. KYC is not required to request money.

Send a request

  1. Go to Transfer & Request > Request Money.
  2. Enter the payer's email or verified phone number (a DroppCash User), or pick them from My recipients. Choose the wallet that should receive the money and enter the amount.
  3. Submit. The payer sees it under Received Requests. You can follow it under Sent Requests.

Answer a request you received

  1. Go to Transfer & Request > Received Requests.
  2. Choose Accept to pay or Reject to decline.
  3. When you accept, the full requested amount is taken from your wallet in that currency (so you need a wallet in that currency with enough balance). The requester receives the amount minus the request fee.

Fees and limits

Request fee (taken from what the requester receives)0.5% + NGN 10
Minimum requestNGN 500
Maximum requestNGN 1,000,000

The person who accepts pays exactly the amount requested, with no extra fee.

Exchange one currency for another

Convert money between any of the supported currencies (fiat and crypto). Requires KYC.

  1. Go to Exchange.
  2. Choose the wallet you are exchanging from and enter the amount to convert.
  3. Choose the currency you want to exchange to. The amount you will receive is calculated using the current rate and shown to you.
  4. Check the fee, then confirm. A wallet in the new currency is created if you do not have one.
Exchange fee (added to the amount you convert)0.5% + NGN 20
Minimum / maximum per exchangeNGN 1,000 / NGN 10,000,000
How the numbers work

You pay the amount you typed plus the fee from the "from" wallet, so keep a little extra balance for the fee. The "to" wallet receives the converted amount. Each currency can have two prices: one used when you exchange it into NGN and a different one when you exchange NGN into it, so the rate going one way can differ from the rate going back. Between two foreign currencies both prices are used. Rates refresh automatically (every 6 hours for fiat, every 15 minutes for crypto), so the form always shows the exact amount you will receive at the moment you confirm — what you see is what you get. Your exchanges appear under Exchange > History.

Pay a merchant

Pay any DroppCash Merchant (shop, service, website) straight from your wallet using their email or QR code. No card details to type. Requires KYC.

  1. Go to Payment.
  2. Enter the merchant's email (or scan their QR code). We check that it belongs to a merchant account.
  3. Choose the wallet and enter the amount.
  4. Confirm. The merchant is credited in the same currency and the payment is saved in your payment history.
Merchant payment fee (taken from what the merchant receives)0.5% + NGN 10
  • You pay exactly the amount you enter. The fee is deducted on the merchant's side.
  • Payments can only go to merchant accounts. To send money to a person use Transfer Money.
  • Paying a website? When a shop uses DroppCash checkout, you are sent to a DroppCash page where you log in with your User account and confirm. If your balance is too low, the page offers to add money by card or bank transfer; then go back to the shop and start the payment again.

Savings pockets New

Pockets are ring-fenced sub-accounts inside your wallet — money put aside for a goal, with optional time locks. Pockets are about discipline, not yield: no interest is paid, but the money is separated from your spending balance, so it is there when the goal comes due.

Create a pocket

  1. Go to Pockets > New Pocket.
  2. Name the pocket (for example "Rent December"), choose the currency, and optionally set a Goal amount, a Target date and a Lock period (0 / 30 / 90 / 180 / 365 days).
  3. Press Create pocket. Move money in with Deposit — "Money moved to your pocket." Reaching the goal shows a "Goal reached!" moment.
  4. Withdraw moves money back to your wallet any time; Close removes an empty pocket.
  • A locked pocket refuses withdrawals until the unlock date: "This pocket is locked until {date}. Funds cannot be withdrawn before then." Locked pockets mature automatically at 06:00 on their unlock day.
  • Maximum 10 pockets per user, and there are no fees on any pocket movement.
  • Pocket statuses: active / locked / matured / closed / broken.
  • A pocket can be filled automatically by a Scheduled payment (choose "savings auto-fund" when creating the schedule).

Scheduled payments New

Money that moves itself on a calendar. A standing order pays a person automatically; a savings auto-fund fills a pocket automatically. Perfect for rent, allowances, tithe and weekly saving.

Create a schedule

  1. Go to Scheduled > New Schedule.
  2. Choose the kind: standing order to a person, or savings auto-fund to one of your pockets.
  3. Choose the wallet, the recipient or pocket, and the amount.
  4. Set How often (daily / weekly / monthly / quarterly) and the day of month — the 31st safely runs on the last day of short months.
  5. Set Stop when: never, after N runs (up to 120), or on a date. Press Create schedule — "Scheduled payment created. The first run is tomorrow at 09:00."

The schedule's detail page lists every run with its outcome and offers Pause / Resume / Cancel / Skip.

  • Runs happen at 09:00. The normal transfer fee applies per run (currently free).
  • A failed run retries at +6h, +24h and +72h. After 3 failed periods in a row the schedule auto-pauses and emails you; resuming resets the counter.
  • Recipients are re-resolved at run time, so a changed phone number still works. Payees who have been frozen from the platform are refused safely.
  • Statuses: active / paused / auto_paused / cancelled / expired. Run outcomes: success / failed / skipped.

Esusu groups New

Esusu is the digital version of ajo / adashe: a group of 5–25 people contribute a fixed amount on a fixed schedule, and each member takes the whole pot home once per cycle, in a fixed, transparent order. The platform never lends and charges no interest — just a flat fee per payout (currently NGN 100, set in Admin > Charges as "Esusu payout fee").

KYC is required to organise, join or start a group.

Start or join a group

  1. Go to Esusu > My Esusu Groups and press Create a group. Set the name, the contribution per round and currency, how often (daily / weekly / monthly), the number of members (5–25 — the member count is the number of rounds in the cycle), and the missed-payment rule: Wait (the payout waits until every contribution is resolved — safest) or Skip (the round pays out what settled; a member who did not pay moves to the back of the rotation but still owes).
  2. Share the invite code with your people. Members join by entering it, and everyone can see their payout position from day one.
  3. When the group is full, press Start. From every round on, contributions are pulled from members' wallets automatically.
  4. When the pot is complete, the round's beneficiary is paid, minus the flat payout fee, and the cycle rotates to the next position.

During a cycle

  • The group page shows a public ledger of each member's standing this round, plus a Pay early / catch up button.
  • A missed auto-debit gets a 24-hour grace window with reminders, retrying at 6h / 24h / 72h. After 3 failed attempts the member is marked defaulted for that round.
  • A member who misses 3 rounds is auto-paused and sits out until the organiser resumes them.
  • The organiser can Waive a struggling member's round, Resume a paused member, or issue a New invite code.
  • Groups can only be cancelled while still in draft.
  • Statuses — group: draft / active / completed / cancelled; round: pending / collecting / paid / skipped; contribution: pending / grace / paid / failed / waived; member standing: good / grace / defaulted / paused.
Trainer's tip

Esusu sells itself to community leaders — market women, unions, church groups. Demo the ledger screen: it answers the trust question "who has paid?" better than any notebook.

Bills & airtime New

One hub for the services Nigerians pay every week: airtime, data bundles, TV subscriptions and electricity, paid straight from your naira wallet.

Pay a bill

  1. Go to Lifestyle > Bills & Airtime and choose the category: Airtime (MTN, Airtel, Glo, 9mobile), Data bundles, TV (DStv, GOtv, Startimes), Electricity (all DISCOs) or Other bill payments. The network is detected automatically for airtime and data.
  2. Enter the customer reference — phone number, meter number or smartcard number — and press Validate. For TV and electricity the customer's name is confirmed before any money moves, so a wrong meter number cannot eat your money.
  3. Pick the plan (data and TV prices come from the provider's own plan list — never typed by hand) or enter an amount, then press Pay bill.
  4. The order page confirms: "Bill payment sent." Delivered orders show any token (for prepaid electricity) right on the page; pending ones say "We will let you know the moment it completes."
  • Naira wallet only. The platform fee is ₦0 at launch (configurable); a per-order cap applies.
  • If a provider fails, the wallet is reversed automatically — the money comes back as a bill_reversal entry without you asking. Stuck orders are re-checked after 60 seconds and reversed after 30 minutes.
  • Order statuses: initiated / processing / delivered / failed / reversed. History lives under Bills & Airtime > History.

USSD banking New

Banking without internet: a short code that works on any phone. Check your balance, send money, buy airtime or get a cash-out code for an agent, all from the dial pad. The exact code is shown on your USSD Code page once the network partner is live (it looks like *384*123#).

Set up and use USSD

  1. Open Lifestyle > USSD Code to see the service code and manage your PIN.
  2. Dial the code on any phone. The first dial asks you to set your PIN (4–6 digits). Dial again to use the menu.
  3. The main menu: 1. Check balance — 2. Send money — 3. Buy airtime — 4. Agent cash-out code — 5. Last transactions — 0. Help. Balance and transactions are PIN-gated.
  4. Sending money asks for the recipient, the amount and your PIN, then shows a confirmation with the recipient's masked name before anything moves.
  • Per-session cap ₦50,000. The telco charges its usual small session fee (about ₦6.98), shown on screen.
  • Night shield: USSD money movement pauses 00:00–05:00 every night — "For your safety, USSD transfers pause 00:00–05:00."
  • 3 wrong PINs lock USSD for 24 hours; sessions expire after 120 seconds of silence.
  • Your PIN is stored only as a hash. Nobody at DroppCash can see it.

USD virtual cards New

Dollar cards for online spending — Netflix, ads, subscriptions — funded instantly from your naira wallet and issued through our licensed partner. Requires verified KYC.

Create and use a card

  1. Go to Lifestyle > Virtual Cards and press Create card (the pilot issues USD cards). You can hold up to 2 cards.
  2. Open the card and press Fund to convert naira into the card: minimum ₦2,000, maximum ₦500,000 per load, no funding fee at launch.
  3. Use Reveal (it asks for your account password) to see the card details, then pay anywhere online like a normal card.
  4. Freeze / Unfreeze pauses a card instantly; Terminate closes it for good.
  • Only active cards can be funded. Your wallet stays the source of truth: if the issuer fails to charge, the wallet is refunded automatically.
  • Card statuses: pending / active / frozen / terminated. Card transactions: approved / declined / reversed, with a "Spent this month" summary on the card page.
  • While the issuing partner is being activated, the page says so explicitly and charges nothing.

Spending insights & notifications New

The money diary. My Spending shows where your money goes, and Notifications is the in-app inbox where every money movement lands. Both screens are read-only — they can never move money.

My Spending

  • This month's money in and out, a category donut with shares, a six-month trend and your Top payees.
  • Re-categorise any transaction (within 90 days) to keep the charts honest.
  • Downloadable monthly reports, plus a month-in-review email on the 1st of every month at 07:00.
  • Where: Insights > My Spending. The rollup refreshes nightly at 00:10.

Notifications

  • Every money-in and money-out lands there automatically, plus bill reversals, pocket moves, protected-payment events, Esusu updates and referral earnings.
  • A bell on every page shows the latest 10 at a glance.
  • Where: Insights > Notifications.

Cash vouchers

A cash voucher is a one-time code worth real money. It turns part of your balance into a code you can share privately, and whoever redeems it gets the cash in their DroppCash wallet. It works a bit like a gift card, but the value is cash, not store credit, and the code works for whoever holds it. People often just say “voucher”; it is the same thing.

Create a cash voucher needs KYC

  1. Go to Cash voucher > Create cash voucher.
  2. Choose the wallet and enter the amount.
  3. Check the fee and total, then confirm. The amount plus the fee is taken from your wallet.
  4. Your cash voucher code is created (two groups of 10 digits, like 1234567890-0987654321). Find it in Cash voucher > My cash vouchers and share it with the person you want to give it to.

Redeem a cash voucher

  1. Go to Cash voucher > Redeem cash voucher and enter the code.
  2. The amount left on the cash voucher (normally the full amount) is added to your wallet in the voucher's currency. A wallet is created if you do not have one in that currency.
  3. Find it later under Redeemed History.
Cash voucher creation fee (paid by the creator)Free
Minimum cash voucherNGN 1,000
Maximum cash voucherNGN 1,000,000
  • When you redeem a cash voucher you receive everything that is left on it, and it is then used up. My cash vouchers shows it as used.
  • A merchant can take only part of it. If you pay a shop with a cash voucher, the merchant enters the price and only that amount is taken. The rest stays on the voucher for you to use later. In My cash vouchers it then shows as partly used, with the amount left and the original face value. See Redeeming cash vouchers.
  • You cannot redeem a cash voucher you created yourself.
  • Redeeming does not require KYC and costs nothing.
Treat the code like cash

Whoever has the code can redeem it first. Share it only with the person it is meant for, through a private channel.

Invoices

Create an itemised invoice, send your customer a payment link, and receive the money in your wallet. KYC is not required to create invoices.

Create and send an invoice

  1. Go to Invoice > Create Invoice.
  2. Enter Invoice To (customer name), the customer's email, their address, and the currency.
  3. Add the items: a name and an amount for each. Use Add for more lines. The total is the sum of all items.
  4. Choose your options:
    • Allow Escrow: lets the customer pay through escrow for extra safety.
    • Pay for Charge? (If Escrow): if the customer pays through escrow, tick this if the escrow fee should be added on top of the invoice total for the customer. Leave it unticked if the fee should come out of your payout.
    • Due date New: set when the invoice should be paid. Overdue invoices get a reminder email every morning at 09:00, and you can send one any time with the remind action on the invoice list.
    • Offer autopay New: lets the customer switch on autopay — their wallet is charged automatically on the due date. See Invoice autopay.
  5. Save. The invoice is created as a draft. Go to Invoice > Invoices and switch Publish Status to Published. A customer can only pay a published invoice.
  6. Click the mail action to send the invoice by email again, or Copy Invoice URL to share the link yourself.

Managing invoices

ActionWhat it does
EditChange the details and items. Only possible before the invoice is published. Once published, cancel it and create a new one.
Publish StatusPublish (customer can pay) or unpublish an invoice
Pay StatusShows whether it is paid. You can also mark it paid or unpaid yourself, for example if a customer paid you outside DroppCash.
Send mailEmails the payment link to the customer again
CancelCancels the invoice. A cancelled invoice can no longer be paid.
Print / viewOpens the invoice page which can be printed

How your customer pays

  1. They open the link in the email (or the link you shared). They must log in to their DroppCash User account (or create one).
  2. They choose how to pay: Pay with system wallet (their DroppCash balance), Pay with gateways (card, bank transfer or other methods available for the invoice currency), or Escrow Payment (only if you allowed escrow).
  3. When paid, the invoice is marked paid and you are credited (see fees below). You get a transaction in your history.
Invoice fee (taken from the amount you receive)0.5% + NGN 10
Escrow fee (if the customer pays through escrow)1% + NGN 100
  • The customer pays the full invoice total. The invoice fee is worked out from that total and taken from what you receive.
  • You cannot pay your own invoice.
  • Only invoices in an active currency can be created.

Escrow: pay safely when you do not know the seller

With escrow, DroppCash holds your payment. The seller is told the money is secured, delivers what you bought, and the money only reaches them when you release it. If something goes wrong, either side can open a dispute and our team decides. Creating an escrow requires KYC.

Create an escrow (as the buyer)

  1. Go to Escrow > Make Escrow.
  2. Enter the seller's email or verified phone number (a DroppCash User), or pick them from My recipients. Choose your wallet, enter the amount, and describe what you are buying.
  3. Decide who pays the fee with the pay charge option:
    • Ticked: the fee is added to what you pay now, and the seller receives the full amount when you release it.
    • Unticked: you pay only the amount, and the fee is taken out of the seller's payout when you release.
  4. Confirm. The money leaves your wallet immediately and is held. You and the seller get an email.

Release the money

When you have received what you paid for, open Escrow > My Escrow, find the escrow and press Release. The seller's wallet is credited and the escrow is closed. Only the buyer can release, and a release cannot be undone, so release only when you are satisfied.

If you are the seller

Open Escrow > Pending Escrows to see escrows made out to you. Deliver the goods or service, then ask the buyer to release. You are paid when they do (or if our team decides in your favour after a dispute).

Chat with the other person

Every escrow between two Users has a private chat, so you can agree the details, share progress and sort out problems without leaving DroppCash. Open Escrow > My Escrow (buyer) or Escrow > Pending Escrows (seller) and press Chat next to the escrow.

  • You can send text and a PNG or JPG picture. Messages appear automatically within a few seconds, and the other person can be emailed when they have a new message.
  • The chat is open while the money is held or the escrow is disputed. It closes by itself once the escrow is released or closed, and the conversation can still be read afterwards.
  • Chat is not available for payments sent to business (merchant) accounts.
  • Sending a message never releases the money. Only the buyer pressing Release does.

Milestones, delivery windows and auto-release New

Escrow created from this page and protected payments created from Transfer Money or payment links are the same object, so these upgrades apply everywhere:

  • Milestones: split the escrow into at least two stages whose amounts add up to the total. The seller marks each stage delivered (note + photo up to 5 MB) and you release stage by stage. Milestone chips appear on the escrow for both sides.
  • Auto-release window: when creating, choose 7 / 14 (default) / 30 days. If you do not approve or dispute in time, the money releases automatically when the window ends — the platform checks hourly and emails both sides before anything auto-releases. Opening a dispute freezes the countdown.
  • Priority disputes: disputes on escrows of ₦200,000 or more are automatically flagged as priority in the support queue.
  • Public stats: droppcash.app/protection shows deals protected, median dispute resolution time and release share.
  • A full event trail: every step of an escrow — created, funded, milestone delivered, released, disputed, closed — is recorded, so the history you see (and support sees) is complete and in order.

Disputes

  1. Open the escrow and choose Dispute (available to the buyer and the seller while the money is still held).
  2. Write your message. You can attach a PNG or JPG screenshot (up to 5 MB) as evidence.
  3. Both sides can reply in the dispute thread. DroppCash support reviews the evidence and either releases the money to the seller or returns it to the buyer. You are notified, and the dispute thread is closed.
Behind the scenes: the AI case analyst New

The moment a dispute opens, an automated "case analyst" reads the escrow facts, the escrow chat and your dispute thread, checks the evidence against the timeline, and prepares a structured report with a recommended outcome for the support team. It only advises: a person always makes the decision, the money is never moved automatically, and the analyst has no ability to release, refund or change an escrow. What it means for you: disputes are picked up faster, and the team already has the full story when they read your case.

Escrow statusMeaning
Pending (held)The money is held. The buyer can release it or either side can dispute.
ReleasedThe buyer released the money to the seller. Finished.
DisputedA dispute is open and under review by DroppCash support.
ClosedSupport has resolved the case (paid to the seller or returned to the buyer).
Escrow fee1% + NGN 100
Good practice

Agree the exact deliverable and deadline with the seller in writing before you create the escrow, and keep screenshots of the conversation. If a dispute is needed, clear evidence is what lets us decide quickly.

Cash in and cash out with agents

DroppCash agents are people and shops who swap cash and wallet money. You do not need a bank branch.

Cash in: turn cash into wallet money

  1. Find an agent (the agent will give you their account email, or you can scan their QR code — agents near you are on the public agents map).
  2. Give the agent the cash and tell them your DroppCash User email (or show your QR code).
  3. The agent enters your email and the amount. The money is added to your wallet instantly and you get an email. There is no DroppCash fee for you on a cash-in.
Cash-in amount per transactionNGN 500 to NGN 1,000,000

Cash out: turn wallet money into cash needs KYC

  1. Go to Withdraw > Cash out to Agent.
  2. Enter the agent's email or verified phone number. We check that it belongs to an agent and show their name.
  3. Choose the wallet and amount. Check the fee and total.
  4. Only confirm when you are standing with the agent. The moment you confirm, the amount moves to the agent's wallet. The agent then hands you the cash.
Cash-out fee (paid by you, on top of the amount)0.5% + NGN 10
Minimum per cash-outNGN 500
Maximum per cash-outNGN 200,000
Daily cash-out limitNGN 2,000,000
Monthly cash-out limitNGN 50,000,000

No internet? Cash out with an SMS code

If you do not have internet or the app with you, an agent can start the cash-out for you. You only need your phone to receive an SMS. Needs KYC.

  1. Go to the agent and tell them the amount you want. Give them your phone number or email.
  2. The agent starts a Customer Cash-Out and we send a code by SMS to the phone number on your account.
  3. Check that the amount in the SMS is right and that you are with the agent, then tell the agent the code. It works for 30 minutes and allows 3 wrong tries.
  4. While you wait you also see a yellow banner in your app — "Cash-out waiting for your approval" — with the agent's name, the amount, a countdown and a QR code. Show the QR to the agent and they can approve without any code typing. Not you? Press Decline and the agent is told immediately.
  5. The agent confirms, the money moves from your wallet to the agent, and the agent hands you the cash. The same cash-out fee and limits apply.

Never give the code to anyone who is not standing with you ready to pay you cash. If you did not ask for a cash-out, ignore the SMS.

Safety

Never confirm a cash-out unless the agent is in front of you and has agreed the amount. Always check the agent's name on the confirmation screen. If a cash-out is confirmed by mistake, contact the agent straight away and open a support ticket with the transaction reference.

Withdraw money

Send money from your wallet to a bank account, PayPal, Payoneer or a crypto address. Requires KYC. Go to Withdraw > Withdraw Money.

Standard withdrawal (reviewed by our team)

  1. Choose the wallet you are withdrawing from. The available withdrawal methods for that currency appear.
  2. Choose a method and read its instructions. Each method tells you exactly which details to provide (for example bank name, account number and account name, or a PayPal email, or a crypto address).
  3. Enter the amount and fill in your account details. The fee and total are shown.
  4. Submit. The total (amount + fee) is taken from your wallet immediately and the request is pending while our team reviews and pays it.
  • Approved: the money is sent and the request shows as accepted. You get an email.
  • Rejected: the full amount, including the fee, is returned to your wallet and the reason is shown in your withdrawal history (the transaction appears as "Withdraw Reject").

Instant bank withdrawal (NGN)

For Nigerian naira you can choose Instant Bank Transfer (NGN). Your money is sent to your bank account within minutes, normally with no waiting for manual approval.

  1. Choose your NGN wallet and the instant method, then enter the amount.
  2. Pick your bank from the list and enter your 10-digit account number.
  3. We look up the account and show the account name. We also show the transfer fee and your total before you confirm. The bank's transfer fee is passed on to you; DroppCash adds no extra charge of its own on this method.
  4. Confirm. The transfer is sent. You get an email when it completes.
The account name must match your profile name

For safety, the name on the bank account must match your DroppCash profile name (at least two parts of the name must match, in any order). If it does not match, or if your profile has only one name, the request is not sent automatically: it is held for manual review by our team and you will be emailed. If an instant transfer fails, the money is returned to your wallet.

Status of a withdrawal

Open Withdraw > Withdraw history. Instant withdrawals show a live status (processing, in review, completed or failed). Our system rechecks pending instant transfers automatically every few minutes.

Methods, fees and limits

MethodCurrencyMinimumMaximumFee
Bank Transfer (NGN)NGN500500,000Free
Instant Bank Transfer (NGN)NGN500500,000The bank's transfer fee, shown before you confirm
Bank Transfer (USD / EUR / GBP)USD, EUR, GBP1010,0001%
PayPalUSD1010,0001%
PayoneerUSD101,0001%
Bank Transfer (CAD, AUD, SGD, NZD, TRY, RON, HUF)Matching currency10100,0001%
Crypto Transfer (BTC, LTC, DOGE)Matching coin0.000036 BTC / 0.018 LTC / 0.018 DOGE0.036 BTC / 18.45 LTC / 18,131.49 DOGE1%

Minimum and maximum are in the currency of the method. Methods and limits can change; the withdraw form always shows what is available to you right now.

User API key (for developers)

If you build a website, app or marketplace, the Api menu gives you an API access key for your User account. With it your own software can start and confirm payments (money is paid into your user wallet), create escrows from your wallet, and create invoices.

  • Open Api to see your key. Use Generate new key to replace it; the old key stops working immediately.
  • Switch between Test mode (no money moves, perfect for building) and Active mode (live money).
  • Full technical reference, examples and error codes are in the API documentation.
Running a business?

Use a Merchant account instead. Merchant keys show your business name at checkout and pay into your merchant wallet.

User FAQ and troubleshooting

I typed a phone number and it says no account was found.

A phone number only finds people who have verified it, and only one account can hold a verified number. Ask the person for their email address, or ask them to verify their number. Check the country code too.

My phone verification code did not arrive.

SMS can be slow. Wait a couple of minutes, check the number and country code, then ask for a new code (once a minute). You can keep using your email in the meantime. If it never arrives, open a support ticket.

It says another account already verified my phone number.

Only one account can hold a verified number, and the first one to verify keeps it. Change the phone number in your profile to your own number and verify that, or contact support if the number is yours.

I sent money to someone who has no account. Where is it?

It is held. Open the account menu > Pending transfers to see it. If the person does not claim it in time, or you cancel, the full amount and fee come back to your wallet. See Send to someone without an account.

I received money from someone before I had an account, but I cannot withdraw it.

Money that reached you this way can be spent inside DroppCash, but you need to complete identity verification (KYC) before you can withdraw or cash out.

Part of my cash voucher is still there after I paid a shop.

Merchants can take only the price of your purchase. The rest stays on the voucher and shows as partly used in My cash vouchers with the amount left.

I do not see the Chat button on my escrow.

Chat is for escrows between two Users while the money is held or disputed. It is not available for payments to merchants, and it closes once the escrow is released or closed.

The Refer & Earn page says it is not available.

The programme is switched on and off by DroppCash. Check again later. When it is on you will see your personal link and your earnings. See Refer & Earn.

I cannot see my wallet in the list when I try to send money.

Forms that spend money only list wallets with a balance above zero. Add money first with Deposit, or choose another wallet.

It says "Insufficient balance" but I have enough for the amount.

Remember that the fee is added on top for transfers, exchanges, cash vouchers, cash-outs and withdrawals. You need the amount plus the fee in the same wallet.

I see "Please follow the limit".

The amount is below the minimum or above the maximum for that action. The limits are shown on the form and in the fees table.

It says I went over my daily or monthly limit.

Daily and monthly totals for transfers and cash-outs include everything you already sent that day or month. Try a smaller amount or wait until the limit resets (midnight for daily, the 1st for monthly).

I get sent to the KYC page when I try to send or pay.

That action requires verified identity. Complete KYC. If it is "under review", wait for approval. If it was rejected, open the reasons, fix them and re-submit.

"Receiver not found" when I send money.

The email you typed does not belong to a User account. Check the spelling. Remember that Merchants and Agents are different account types: pay a merchant through Payment and an agent through Cash out to Agent.

I sent money to the wrong person.

Transfers are instant and cannot be reversed by you. Contact the person and ask them to send it back. If they refuse or cannot be reached, open a support ticket with the transaction reference and we will look into it.

My deposit is still pending.

Manual deposits (bank transfer and crypto) wait for confirmation by our team. Make sure you used the exact details shown and submitted your transaction details. Automatic deposits normally credit within moments; if yours does not, open a ticket with the transaction reference from your payment provider.

I picked a pay-by-bank method but my bank is not listed.

Pay-by-bank (Mono, Plaid) covers the banks our partner supports in each country. If your bank is missing, use another automatic method for your currency, or a manual bank transfer. The list inside the payment page is always the current one.

My withdrawal was rejected.

Open Withdraw history to read the reason. Your money (including the fee) has been returned to your wallet. Correct the issue (for example wrong account details) and submit a new withdrawal.

My instant withdrawal is "in review".

The bank account name did not match your profile name (or your profile has only one name), or a check needs a person to look at it. Our team reviews it and you are emailed the outcome. To avoid this, put your full legal name on your profile exactly as on your bank account.

The invoice link says the invoice is not published.

Drafts cannot be paid. In Invoice > Invoices, switch the invoice's Publish Status to Published, then send the link again.

I cannot pay an invoice.

You cannot pay your own invoice, a cancelled invoice, or one that is already paid. You must be logged in to a User account (not a Merchant or Agent account).

I did not receive my two-step SMS code.

Check that the phone number on your profile includes the country code and can receive SMS. Request the code again after a minute. If you still cannot log in, open a support ticket from another account or use the contact page.

Can I use the same email as a Merchant or Agent?

Yes. They are separate accounts with separate passwords and wallets. Money in one is not automatically in another.

For Agents Agent account

Agents are DroppCash's cash points. You help people in your area turn cash into wallet money (Cash In) and turn wallet money into cash (Cash Out), and you earn a commission on cash-ins. This part of the guide explains how to join, how the money flows, and how to run your agent business safely.

How the agent business works

1. You hold float

You keep money in your agent wallet (called float). You get it by requesting funds from DroppCash or by bank transfer to your float account.

2. Cash In

A customer gives you cash. You send the same amount from your wallet to theirs — from the web counter or a POS terminal — and earn commission.

3. Cash Out

A customer sends you wallet money. You see it in your wallet and hand them the same amount in cash.

4. Withdraw

When your wallet grows, withdraw to your bank account.

What you get with an Agent account

  • A dedicated agent dashboard with your wallets, recent transactions and recent withdrawals
  • Fund Requests to top up your float
  • User Cash-In to credit customers who hand you cash, with commission paid straight to your wallet
  • Automatic credit when customers cash out to you
  • Withdraw to bank (including instant naira transfers), PayPal, Payoneer or crypto
  • A personal QR code so customers can find you by scanning, two-step security and support tickets
  • Location & Hours New: your shop on the public agents map with opening hours and an honest "has cash" badge (see the agents map)
  • A Float Account New: the shop's own NGN account number for instant float top-ups (see Float account)
  • POS terminals New: cash in customers and redeem merchant cash codes from a POS device over the agent API (see POS terminals)
  • Sub-Tellers New: up to 5 till logins plus a printable End-of-Day sheet (see Sub-tellers & End-of-Day)
  • Merchant Cash Codes New: customers pay merchants in cash at your counter and you keep half the fee (see Merchant cash codes)
  • Register a Customer New: counter onboarding with the ₦300 bounty (see the bounty)
  • The Earnings ledger New: every naira you earn, with daily statements and weekly volume bonuses (see Earnings)

Becoming an agent: sign up

  1. Open droppcash.app/agent/register.
  2. Fill in: business name, business address, your National ID number, a clear photo of the ID (JPG or PNG), your full name, email, phone number (with country code), country, address and a password.
  3. Submit, then verify your email with the 6-digit code that is sent to you.
  4. Your application is now pending. You cannot log in to the agent dashboard until it is approved.
Tips for a fast approval

Use the real name and address of the business, make sure the ID photo is sharp and readable, and use a phone number you can always answer, because the team may call to confirm your details.

The form screens itself New

Applications from disposable email domains and obvious scam names ("money doubling", "cash flip") are rejected on the spot with a clear message. Free-mail addresses like Gmail are accepted but marked for review. A hidden honeypot field and a small maths check keep bots out. A verified phone number is required before approval — see Agent approval.

Agent approval

Every new agent is reviewed by the DroppCash team before they can start. This protects customers who trust you with their cash.

Before approval New

A verified phone number is required before an application can be approved — right after applying you see a banner: "One more step: verify your phone number… so we can approve your agent application." Applications that stay unverified for 14 days are auto-rejected nightly, with an email.

StatusWhat it means
PendingYour application is being reviewed. If you try to log in you see "your agent request is still pending". Nothing is wrong. Please wait.
ActiveYou are approved. You can log in and use every agent feature.
Banned / rejectedYour agent account is not active. Open a support ticket from the contact page or email hello@droppcash.app to find out why.
Agent programme switched off

If the agent programme is ever paused, agent pages show a notice that the feature is currently unavailable. Your account and balances are not affected.

Your agent dashboard

After you log in at droppcash.app/agent/login you land on the dashboard. The sidebar contains:

MenuUse it to
DashboardSee your wallet balances (one card per currency), your recent transactions and your recent withdrawals
TransactionsFull history of cash-ins, cash-outs, commissions, fund credits and withdrawals. Search by reference and filter by type.
QR CodeShow or download your QR code so customers can scan it
Fund RequestsAsk DroppCash to credit your wallet so you have float to work with
Location & HoursManage your listing on the public agents map (see the agents map)
Float AccountOpen and view your shop's own bank account number (see Float account)
User Cash-InCredit a customer's wallet when they hand you cash
Customer Cash-Out (SMS code)Pay cash to a customer who confirms the cash-out with an SMS code on their phone
Sub-Tellers and End-of-day sheetTill logins for your attendants and the daily reconciliation (see Sub-tellers)
Create Voucher and Redeem VoucherTurn a customer's cash into a cash voucher, or pay a customer cash for their voucher
Merchant Cash CodesRedeem 8-digit codes that carry merchant payments (see Merchant cash codes)
Register a CustomerCounter onboarding with the ₦300 bounty (see the bounty)
EarningsYour earnings ledger, weekly tier and daily statement (see Earnings)
Payment BannerA printable banner with your QR code for your shop
Refer & EarnYour referral link and earnings (see Refer & Earn)
WithdrawWithdraw Money and Withdraw History
SettingProfile Setting, Change Password and Two Step Security
Support TicketContact the DroppCash team and follow your conversations

Set up your profile first: Setting > Profile Setting. Make sure your business name, address and photo are correct because customers see them.

Then turn on Two Step Security (how). As an agent you handle other people's money, so this is strongly recommended.

Location & Hours: the agents map New

Every approved agent is published on the public agents map at droppcash.app/agents with its distance from the searcher, opening hours and a live has cash badge. This listing is how new customers find your shop — keep it honest and it becomes the best marketing you never paid for.

Set up your listing

  1. Open Location & Hours in your agent panel.
  2. Fill in your shop address and city, and pick your opening hours for each day (leave both fields blank = closed that day). Saving places the pin on the map automatically from the address.
  3. Wrong spot? Drag the pin on the map, tick Use pin and save again. The listing badge shows how the pin was placed: address matched / city centre / set by hand / not placed yet.
  4. Use the "I have cash today" card as your honesty switch: press I have cash today and the badge shows on the map until closing time; press Switch off to hide it. Outside your published hours the platform refuses the toggle — the map would hide the shop anyway.
  • A check that runs every 15 minutes clears the cash badge automatically after closing time, so the badge never lies overnight. The map also checks your opening hours live when a customer views it.
  • Customers who travel to a "has cash" shop that has no cash stop trusting the map — and the platform. Treat the badge as a promise.

Float account & fund requests Float account is new

To serve customers you need money in your agent wallet — that is your float. Two ways to fund it: your shop's own bank account number (instant, the modern way) and fund requests (the manual fallback).

Float account: the shop's own bank account

Every agent gets a personal NGN account number for the shop. Bank transfers into it land in your agent wallet instantly, with no deposit approval.

  1. Open Float Account in your agent panel and press Open my float account (it uses the ID number on your agent record; usually ready in seconds).
  2. Once active, the page shows the bank, the account number in large type, the account name, a Copy account number button, and Recent float credits.
  3. Top up by transferring from any Nigerian bank into that account number. The money is in your float straight away.
  • Any credit whose sender name does not match gets a "name check" badge on the recent-credits list, so you can spot third-party transfers.
  • Money in the wallet is the float: cash-in pays out of it, cash-out pays into it.
Trainer's tip

Open the float account on day one — no more waiting for a manual top-up before the first customer of the day.

Fund requests (the manual fallback)

Use this when the float account cannot be provisioned, or when you want a record of a request to the DroppCash team.

  1. Open Fund Requests, choose the currency and enter the amount you need, then submit. Each request gets a unique code you can use to search for it later.
  2. The DroppCash team reviews the request.
    • Accepted: the amount is credited to your agent wallet immediately and you get an email with the transaction reference.
    • Rejected: nothing is credited and you are emailed.
  3. Settle the funds with DroppCash as agreed when your request is approved. Always quote your request's unique code when you pay or ask about it.
  • You can only send fund requests while your account is active.
  • Request in the currency your customers use. You hold a separate wallet for each currency.

Cash In: a customer hands you cash

When a customer wants to add cash to their DroppCash wallet, you credit their wallet from your float, and keep the cash.

  1. Take the cash from the customer and count it.
  2. Open User Cash-In.
  3. Choose your wallet (the currency you are paying out in). Only wallets with a balance are listed.
  4. Enter the customer's DroppCash User email or verified phone number. (They can show you their QR code.) We check that the user exists and show their name. Confirm that it is the right person.
  5. Enter the amount that matches the cash you received.
  6. Confirm. Your wallet is reduced by the amount; the customer's wallet is increased by the same amount instantly (a wallet is created for them in that currency if needed). You both get an email.
  7. Your commission is credited to your wallet straight away as a separate "Cash In Commission" transaction.
Minimum per cash-inNGN 500
Maximum per cash-inNGN 1,000,000
Your commission on each cash-in0.5% of the amount
Fee charged to the customerNone

The customer must have a User account. You need enough balance in your wallet to cover the amount. The commission rate is set by DroppCash and is shown on the Cash-In page.

Cash In is instant and final

Always count the cash before you press confirm and check the customer's name on screen. You cannot cancel a cash-in once it is confirmed.

Cash Out: a customer collects cash from you

When a customer wants to turn wallet money into cash, they send a Cash Out payment to your agent email, and you give them the cash.

  1. The customer tells you the amount they want and enters your agent email (or scans your QR code) on their Cash out to Agent page.
  2. They confirm. The full amount they entered is credited to your agent wallet instantly. You get an email and a "Cash Out" transaction.
  3. Check your wallet or the email, and confirm the credit has arrived in the right amount.
  4. Only then, hand the customer the cash for that amount.
  • The customer pays the cash-out fee; you receive the full amount they send you.
  • A customer can cash out up to NGN 200,000 at a time, subject to their daily and monthly limits.
  • You also earn 30% of the cash-out fee as commission on every cash-out you serve (see Earnings).
Never hand over cash before you see the money

Always confirm the credit in your own dashboard or on the email you receive from DroppCash. Do not trust a screenshot or a "payment sent" message shown on the customer's phone.

Customer Cash-Out by SMS code

For customers who have no internet or cannot use the app. You start the cash-out, the customer confirms it with a code sent by SMS to their own phone, and then you pay them cash. The money is only moved after the right code is entered.

  1. Open Customer Cash-Out (SMS code) in your sidebar.
  2. Enter the customer's phone number or email, choose the currency and enter the amount they want in cash.
  3. Press the button to send the code. The customer receives an SMS with the amount, your name and a code. It is valid for 30 minutes.
  4. Customer has the app open? They see a yellow banner — "Cash-out waiting for your approval" — with your name, the amount, a countdown and a QR code. Scan it with the POS app or approve it from the screen: no code typing at all. The customer is notified the moment the request arrives, and can decline it from the banner.
  5. Ask the customer for the code (they must be standing with you) and enter it on the next page.
  6. When the code is right, the amount is moved from the customer's wallet to yours. Then hand over the cash. The page tells you the exact amount.
  • The customer must have a User account that has passed KYC and enough balance for the amount plus the cash-out fee. The same cash-out fee and limits apply as for a normal cash-out.
  • After 3 wrong codes the cash-out is stopped and you start a new one. A code that is not used in 30 minutes expires. Press Re-send the SMS code up to twice on the same request (the clock resets). You can cancel a waiting cash-out at any time.
  • You are credited the full amount, as with any cash-out. The customer pays the fee.
  • You can start only a limited number of these per hour, and one new request replaces an older waiting request for the same customer.
Do not pay cash before the code is accepted

Only pay when the page says the cash-out is done. If the customer says the SMS did not arrive, ask them to check the number on their account and wait, or start again. Never ask a customer to read out a code if they are not with you.

POS terminals (API) New

Serve customers from a counter terminal: a point-of-sale device or kiosk app that talks to DroppCash over the agent API can do what your web counter does — look up the customer, perform a Cash In, and redeem merchant cash codes — with the same limits, the same commission and the same audit trail as the web.

How a POS terminal works

  1. Your terminal or kiosk app signs in with POS credentials linked to your agent account (email + password), and confirms your two-step security code when it is switched on — the terminal cannot act before that check passes.
  2. For a Cash In, the terminal looks up the customer by their DroppCash email, verified phone number or QR token and shows their name to confirm, exactly like the web form.
  3. The terminal submits the cash-in (currency, amount). The customer's wallet is credited instantly, your float is debited, and your commission is paid to your shop wallet exactly as on the web.
  4. For a merchant cash code, the terminal loads the code form, checks the 8-digit code (amount, merchant, expiry) and redeems it — the merchant is credited from your float and you keep 50% of the fee, the same as counter redemptions.
  • Everything a POS terminal does is recorded like any other agent transaction: same references, same ledger, same earnings and End-of-Day sheet.
  • The API is rate-limited (lookups and redemptions per minute) and every call is authenticated — a terminal is a till, not a second account.
  • Technical reference, including the exact endpoints and responses for terminal builders, is in the API documentation (Agent / POS section).
Who is this for?

Shops and super-agents that already own POS hardware or want a counter kiosk with big buttons and a barcode scanner. If you only need extra logins for staff, Sub-Tellers is the simpler answer — the POS API is for devices and apps.

Sub-tellers and the End-of-Day sheet New

Run the shop like a business: a kiosk with several attendants still settles as one shop. Create up to 5 till logins, let each teller serve the counter with their own session, and close every day with a printable reconciliation sheet.

Sub-tellers

  1. Open Sub-Tellers and press Add a sub-teller: name, email (their login), phone, role (Teller or Manager), a till name like "Counter 1", and a password.
  2. Share the email and password with them. They sign in at the same web address as you, on the staff login page (droppcash.app/agent/staff/login).
  3. A signed-in teller sees only the Tiller Counter: the cash-in form (customer phone/email or QR scan, shop float, amount, Credit the customer) plus My till today — cash-ins, total received and commission credited to the shop.
  4. The team table shows each teller's role, status and last sign-in. Remove stops their login immediately.
  • Every payment is recorded against the till that served the customer, but commission always lands on the shop's wallet.
  • Maximum 5 sub-tellers. Disabled staff cannot sign in.
  • Any shop transaction can be re-printed from the printable receipt page by its reference — thermal-printer friendly, with a QR the customer can verify publicly at droppcash.app/verify/REF123.

The End-of-Day sheet

Till reconciliation done properly: count the drawer, compare with the ledger, record the difference, close the day and file a printable sheet. One sheet per shop (or per till) per currency per day. Find it in the staff menu under End-of-day sheet; the owner closing with no staff session closes the whole shop.

The sheet computes and displays: Opening (last close) — yesterday's counted cash; Cash received today; Cash paid out today; Vouchers issued and vouchers cashed out; the highlighted Expected in drawer (opening + cash-in − cash-out); wallet balance now; and commission credited. Enter the counted cash in drawer and a note explaining any difference, then press Close the day & print.

The printable, thermal-friendly sheet files the day with a reference like EOD-123 and a difference box — green "Difference: 0.00 — balanced" or the discrepancy with your note. The previous close's counted cash becomes the next day's opening. Train staff to never close with an unexplained gap.

Cash vouchers for agents

Agents can turn cash into a cash voucher for a customer, and pay a customer cash for a voucher they hold. A cash voucher is a one-time code worth real money (see Cash vouchers).

Create a voucher for a customer

  1. Open Create Voucher.
  2. Choose your wallet and enter the voucher amount. If you charge the customer a fee, it is collected in cash by you; it is only recorded in the system.
  3. The customer gives you the cash (the voucher amount plus your fee). You confirm, and a voucher code is created for them to keep or give to someone. The amount plus DroppCash's charge leaves your wallet.
  4. The page shows a ticket with the code that you can print or show.

Redeem a voucher for cash

  1. Open Redeem Voucher and enter the customer's voucher code.
  2. You see the amount and the largest fee you may keep. Confirm.
  3. The voucher amount goes into your wallet. You pay the customer the amount in cash, minus any fee you keep.
DroppCash charge to create a voucherFree (min NGN 100, max NGN 1,000,000)
DroppCash charge to redeem a voucherFree; you also earn 30% of any voucher fee share

An agent redeems the whole amount left on a voucher. If a voucher was partly used by a merchant, you receive what is left.

Merchant cash codes New

A customer who cannot pay digitally shows you an 8-digit code (created by a merchant or a storefront checkout). You key it in, collect the cash, and the merchant is credited from your float — while you keep 50% of the fee as commission. This makes every agent shop a payment point for every DroppCash merchant.

Redeem a cash code at the counter

  1. Open Merchant Cash Codes in your agent panel.
  2. Type the 8-digit code and press Check code. Invalid, already-paid or expired codes are refused with one clear message.
  3. The confirm screen shows the merchant / biller, the amount to collect, the note and the expiry. Collect the cash from the customer first.
  4. Press Cash collected — confirm payment. The merchant is credited from your agent wallet and your commission is added back automatically: "Done. You received {amount} cash for {merchant} — commission {c} was added to your wallet."
  • Codes expire 24 hours after creation; 3 wrong attempts lock a code.
  • Rate caps: 30 codes per hour per agent, 5 per hour for the same customer — they exist to stop money mule behaviour, not honest shops.
  • Fee: 1.5% + NGN 50 (min NGN 100, max NGN 500,000; current values live in Admin > Charges as "Merchant Cash Code"). You keep 50% of it. The invoice version carries the invoice's own charge instead — no double fee.
  • Your float must cover the full amount: the merchant is paid from your wallet, the customer's cash replaces it.

Register a Customer — the ₦300 bounty New

Counter onboarding: name and phone are enough. The customer walks out with a working wallet, you become their agent of record, and you earn ₦300 when they make their first cash-in.

Register someone from the counter

  1. Open Register a Customer in your agent panel (it is also in the POS app).
  2. Enter the customer's full name, country (Nigeria is preselected) and phone number (without the country code); email is optional. Press Register the customer.
  3. The account opens pre-verified and the credentials go out by SMS: "Hello {name}, your DroppCash wallet is ready. Login with {email} and password {temp}. Change the password after first login."
  4. If the SMS fails, the screen shows the temporary password once — write it down and hand it over now.
  • Bounty: ₦300, once per customer ever, paid when their first cash-in clears. Only approved and phone-verified agents earn it, and the weekly cap is 5 bounties (resets Monday).
  • The page tracks Bounty progress this week (x/5) and Customers you brought in with status badges.
  • An existing phone number is refused politely — that person already has a wallet and can cash in at your shop with it.

Earnings, tiers & the daily statement Earnings engine is new

One permanent page answers "what did I earn this week?": Earnings lists every naira the platform ever paid you, with source labels and filters — and every earning is paid to your wallet immediately, so the ledger is a statement, not a queue.

What agents earn

EarningHow much
Cash-in commission0.5% of every cash-in you make, credited at once
Cash-out fee share30% of the cash-out fee (configurable in the agent settings)
Voucher fee share30% of the DroppCash fee on voucher create / redeem at your counter
Merchant cash codes50% of the fee on every merchant cash code you redeem (see Merchant cash codes)
Onboarding bounty₦300 per registered customer's first cash-in, capped at 5 per week (see Register a Customer)
Weekly volume bonus0.10% / 0.15% / 0.25% of the week's cash-in + cash-out volume (see tiers below)

The earnings ledger

The left cards show your volume this week (7 days), your current volume bonus tier with the amount still needed for the next tier, and all-time totals per source. The Earnings ledger filters by All / Cash-in commission / Cash-out fee share / Voucher fee share / Onboarding bounty / Weekly volume bonus, listing date, type, reference and amount. Each row is idempotent — one earning per source per transaction reference, so retries never double-pay.

The daily statement

Every day at 21:00 you get a statement (email and in-app) recapping yesterday's counts and commission per rail, including a "reach N to earn the next volume bonus" nudge.

Weekly volume tiers

Every Monday at 07:00, on the previous rolling 7 days:

Weekly volume (cash-in + cash-out)Bonus
₦1,000,000 and up0.10% of the week's volume
₦3,000,000 and up0.15% of the week's volume
₦5,000,000 and up0.25% of the week's volume
Rates can change

Shares, bounties and tier thresholds are set by DroppCash and may be updated. The Earnings page always shows the current numbers, and the fee table at the bottom of this guide reads its values live.

Withdrawing your balance

You can withdraw agent balance to your bank account or other supported methods. Go to Withdraw > Withdraw Money. The steps, fees, limits and statuses are the same as for users, including Instant Bank Transfer (NGN); see Withdraw money for the complete walkthrough and the methods table.

  • Pick the wallet, then the method, enter the amount and the account details, and submit.
  • Standard withdrawals are reviewed by the team. Rejected ones are refunded in full with the reason shown in Withdraw History.
  • For instant naira transfers, the bank account name must match the name on your agent profile (at least two name parts).

Agent safety and good practice

  • Verify before you pay out. For a Cash Out, wait for the credit in your own dashboard or an email from DroppCash.
  • Verify before you press confirm. For a Cash In, count the cash and check the customer's name on the screen.
  • Keep float in the right currency. If you serve customers in several currencies, keep a wallet balance in each.
  • Protect your login. Use two-step security, never share your password, and log out on shared devices — including on any POS terminal you use.
  • Display your QR code in your shop so customers can find the right agent account quickly.
  • Keep records. Every transaction has a reference. Note it for disputes, and close every day with the End-of-Day sheet.
  • Be wary of fraud. If someone asks you to "reverse" a cash-in or to pay out before the money arrives, refuse. DroppCash staff never ask agents for passwords or codes.

Agent FAQ and troubleshooting

The customer says the cash-out SMS code did not arrive.

Check that the phone number on the customer's account is right and can receive SMS, then wait a minute or two. If it does not arrive, cancel and start again. Never pay cash until the code has been accepted.

"This customer must complete identity verification (KYC)" on a customer cash-out.

Cash-out needs a User account that has passed KYC. Ask the customer to complete KYC first.

I cannot find a customer by phone number.

A phone number only works if the customer has verified it. Use their email address instead, or ask them to verify their number.

"Your agent request is still pending" when I log in.

Your application has not been approved yet. You will be able to log in once the team approves it. If it has been a long time, email hello@droppcash.app from the email you registered with.

"You are not eligible to perform this action" on a fund request.

Fund requests are only available to active agents. Your account is still pending or has been deactivated.

"Sorry! User not found" on Cash In.

The email does not belong to a User account. Ask the customer to check their email, or to register a User account first. Cash-ins cannot go to merchant or agent accounts.

"Insufficient balance" on Cash In.

Your wallet in that currency does not cover the amount. Request more funds or choose a different wallet.

"Please follow the limit" on Cash In.

The amount is below the minimum or above the maximum per cash-in. See the limits in Cash In.

My POS terminal says the customer lookup failed.

The terminal talks to DroppCash over the internet — check the device's connection, then retry. Lookups fail when the email or phone number does not belong to a User, or the number is not verified. The web counter always works as a fallback.

A customer says they cashed out to me but I do not see the money.

Check Transactions and your email. Ask the customer for the transaction reference. Do not hand over cash until the credit is there. If they sent it to the wrong email, they must contact the other account holder or support.

Can I cancel or reverse a cash-in?

No. Cash-ins are final once confirmed. If a mistake was made, open a support ticket straight away with the transaction reference.

Do I need KYC as an agent?

You do not fill in the KYC form. Your ID number and photo are collected at sign-up and checked during approval.

For Merchants Merchant account

A Merchant account lets your business get paid by DroppCash customers: in person with your email or QR code, or online with the DroppCash checkout and API. This part of the guide shows how to set up, start receiving money, connect your website, and withdraw your earnings.

What you get with a Merchant account

Get paid by email or QR

Customers pay you from their DroppCash wallet by entering your merchant email or scanning your QR code.

Online checkout API

Add DroppCash payments to your website or app with a simple API and an access key.

Escrow checkout

Offer buyers the safety of escrow. You are paid when they release the money.

Test and live modes

Build and test your whole integration without moving real money, then switch to live.

Multi-currency wallets

Receive in the currency the customer pays in. A wallet appears for each currency.

Withdraw

Cash out to your bank (including instant naira transfers), PayPal, Payoneer or crypto.

Transactions and reports

Search and filter every payment by reference or type.

My Store

A public online shop with products, stock alerts, discount codes and pickup tickets.

Cash Codes

Customers who only have cash pay you through any DroppCash agent with an 8-digit code.

Staff & Counter

Cashier logins with their own counter QR; every sale is attributed to who took it.

Auto-settlement

Your USD and EUR balance converts to naira and lands in your Nigerian bank every night.

Webhooks

Signed, automatic notifications for payments, orders and settlements.

Insights

Sales charts, top products, low-stock alerts and a monthly report email.

Security

Two-step login, API key rotation and signed webhooks.

Merchants receive; they do not pay out

A Merchant account is built for receiving payments. It does not send transfers or pay other merchants. To spend your earnings, withdraw them. (A Merchant account also cannot pay a checkout; the buyer must be a DroppCash User.)

Setting up your Merchant account

  1. Register at droppcash.app/merchant/register. You need your business name, your full name, email, phone (with country code), country, address and a password.
  2. Verify your email with the 6-digit code we send.
  3. Set up your business profile. Go to Setting > Profile Setting and check your business name, city, ZIP/postal code, address and photo. Your business name is what customers see at checkout, so make sure it is the name they know. (If it is empty, your account name is shown instead.)
  4. Submit KYC so you can withdraw (how).
  5. Turn on two-step security (how).
  6. Start receiving: share your email or QR code, or connect the API.

Your merchant sidebar

MenuUse it to
DashboardSee wallet balances (one card per currency), recent transactions and recent withdrawals
QR CodeShow or download your payment QR code
Payment BannerA printable banner with your QR code for your shop
Redeem VoucherTake a customer's cash voucher as payment for a purchase (see Redeeming cash vouchers)
My StoreOpen and manage your online storefront (see My Store)
Cash CodesTake cash payments through any agent (see Cash Codes)
WebhooksRegister your endpoint and see deliveries (see Webhooks)
Staff Accounts and CSV ExportsCashier logins and bookkeeping exports (see Staff & Counter)
Auto-settlementConvert USD/EUR to naira and pay your bank nightly (see Auto-settlement)
InsightsSales, stock alerts and monthly reports (see Insights)
Refer & EarnYour referral link and earnings (see Refer & Earn)
API Access KeyGet or regenerate your key and switch between Test and Active mode
TransactionsEvery payment you received and every withdrawal, with search and filters
WithdrawWithdraw Money and Withdraw History
SettingProfile Setting, Change Password, Two Step Security
Support TicketTalk to the DroppCash team

Merchant identity verification (KYC)

You can start receiving payments straight after email verification, but withdrawing requires approved KYC. Do it early so you can withdraw as soon as money arrives.

  1. Click the KYC banner on your dashboard (or open the KYC form when a locked feature sends you there).
  2. Enter your Business Name (required).
  3. Enter one ID number: National Identification Number (NIN), Passport ID number or Driving License ID number.
  4. Upload a clear photo of that ID under Upload Proof of Selected ID (required, PNG/JPG, up to 5 MB).
  5. Submit. Status becomes under review; once approved the Withdraw menu works. If rejected, use See Reasons and re-submit.

The full status table is in Identity verification (KYC).

Receiving payments

There are four ways your customers can pay you. All of them credit your merchant wallet in the currency the customer paid in.

1. In person or by link: your email and QR code

  1. Share your merchant email, or display your QR code (download it from QR Code, or print the ready-made sign from Payment Banner).
  2. The customer, logged in to their User account, opens Payment, enters your email or your verified phone number or scans your QR code, picks a wallet and enters the amount.
  3. They confirm. You are credited immediately (minus the fee) and receive an email. It shows in Transactions as Merchant Payment.
Which QR, when New

Counter QR: your permanent QR — print it once and keep it at the counter; the customer types any amount; it can be attributed to a cashier (see Staff & Counter). Show QR: a one-time QR for a single sale, with an optional locked amount — expires after 2 hours, attributed to whoever created it. Storefront QR: opens your public online store (see My Store). Download all three from the QR pages; Create Banner prints a wall sign.

2. In person: a customer's cash voucher

A customer can pay with a cash voucher instead. See Redeeming cash vouchers. The part of the voucher you take is credited to your wallet.

3. Cash: an 8-digit code paid at any agent

A customer who cannot pay digitally gets an 8-digit cash code from you (or from your storefront checkout), pays cash at any DroppCash agent, and your wallet is credited automatically. See Cash Codes.

4. Online: the DroppCash checkout (API)

Your website or app asks DroppCash to create a payment, sends the buyer to a DroppCash checkout page, then confirms the result. This is covered step by step in Connect your website. Credited payments appear as Merchant API Payment.

4. Online with escrow

Buyers pay into DroppCash escrow and you are paid when they release it. See Escrow checkout.

Fees on money you receive

How you were paidFee (taken from what you receive)
Customer paid by email / phone / QR code0.5% + NGN 10
Customer paid with a cash voucherFree
Customer paid through the API checkout0.5% + NGN 10
Customer paid through escrow1% + NGN 100 (taken from your payout unless the buyer chose to pay the fee)
  • The customer always pays the exact amount. The fee is deducted from what is credited to you.
  • The fee is shown on each transaction.
  • Fixed fees are converted into the currency of the payment.

My Store: your online shop New

A complete little e-commerce system inside the merchant panel: a public storefront page, a product catalogue with stock and low-stock alerts, discount codes, order management with pickup tickets, and full refunds. Buyers pay from their wallet, or with protection, or with cash through an agent.

Open your storefront

  1. Go to My Store and open Storefront settings. Set the store link (the unique public address, like droppcash.app/store/your-shop), category, opening hours, description, logo and cover image.
  2. Tick Storefront is live and press Save storefront — "Storefront saved. It is live at /store/your-shop." Share the Storefront QR; scanning it opens the catalogue.
  3. Add products: name, price, category, stock, image and the alert threshold — "When stock reaches it you get an email — leave empty for no alerts." Products toggle Active/Hidden and show a low badge when stock runs down.
  4. Create discount codes: a code with a % off or a fixed amount, an optional minimum order, a max-uses cap and an expiry. Percentages above 100 are refused, and usage is counted so a code can never be over-used.

Shoppers see category filter chips, a discount-code box at checkout and a pick up in shop checkbox. Unpaid orders expire after 48 hours (unless a cash code is still open for them).

Managing orders

  • Orders show badges Paid / Fulfilled / Refunded / Cancelled / Protected with actions Fulfill, Refund, Mark collected (pickup orders) and Ticket — a printable Pickup order ticket with items, discount, total and a signature line. It turns a WhatsApp order into a controlled hand-over.
  • Refunds are full only, within 30 days of payment, blocked while an escrow on the order is open ("use the dispute flow"), and need enough wallet balance — the money moves back to the buyer atomically.
  • Storefront orders paid from a wallet carry no platform fee. Protected orders run under escrow with a 14-day auto-release (see Pay with Protection).
  • Buyer carts hold up to 20 lines with quantities up to 100; stock is checked and held per line.
  • When stock reaches the alert level you get one email and one notification per product per day. See Insights for the low-stock table.

Cash Codes: get paid in cash through any agent New

The bridge to the cash economy: for phone or counter sales, create an 8-digit code, the customer pays cash at any DroppCash agent, and your merchant wallet is credited automatically. No customer DroppCash account needed on the spot.

Create a cash code

  1. Go to Cash Codes in your merchant panel. Enter the amount, currency and a short note (what the customer bought), then press Create code. Only one code can be open at a time — creating a new one cancels the previous open code.
  2. The show-once page displays the code and its QR exactly once: "Show it to your customer now — it is displayed only once." Give the code to the customer (when it is created from a storefront checkout, the customer also gets it by SMS). It lives 24 hours.
  3. At the agent's shop the cash is collected (see Merchant cash codes), your wallet is credited amount − fee, and an order behind the code (if any) flips to paid automatically.
  • Fee: 1.5% + NGN 50 (min NGN 100, max NGN 500,000), taken off your credit; the agent keeps 50% of it as commission. Values are editable in Admin > Charges ("Merchant Cash Code").
  • Code statuses: open / paid / expired / cancelled / locked — three wrong attempts lock a code.
  • Every redemption fires the payment.succeeded webhook, so your systems stay in sync (see Webhooks).

Redeeming customers' cash vouchers

A customer can pay you with a DroppCash cash voucher (see Cash vouchers). You enter the price of the purchase and only that amount is taken from the voucher. The rest stays on the voucher for the customer. For example, a customer pays a NGN 1,200 purchase with a NGN 2,000 voucher: you receive NGN 1,200 (minus the fee) and NGN 800 stays on their voucher.

  1. Open Redeem Voucher in your sidebar.
  2. Enter the customer's voucher code and the price of the purchase. (If you leave the price empty, the whole amount left on the voucher is taken.)
  3. Check the summary: the price, DroppCash's charge, the amount credited to you and the amount left on the voucher. Then confirm.
  4. The price, minus the charge, is credited to your wallet in the voucher's currency, and the voucher's creator is informed by SMS. The page shows what is left on the voucher.
DroppCash charge (taken from what you receive)Free
Minimum per redemptionNGN 100
Maximum per redemptionNGN 1,000,000
  • The price cannot be more than what is left on the voucher.
  • Your history of redeemed vouchers is shown on the same page, with the amount taken each time.
  • Only take a voucher in person from the customer. Treat the code like cash.

Connect your website: accepting payments with the API

If you sell online, you can add DroppCash as a payment option. A developer can do this in under an hour. This section explains the flow in plain language; the complete reference, with code in cURL, PHP, Node.js and Python, is in the API documentation.

Step 1: Get your API access key

  1. Log in and open API Access Key.
  2. Your key is shown (it is created the first time you open the page). Copy it and store it on your server only.
  3. If the key is ever exposed, click Generate new key. The old key stops working at once.

Step 2: Choose Test or Active mode

ModeWhat happens
Test mode (default for a new key)No money moves and no wallet balance is needed. Checkout, webhooks and redirects behave exactly like live mode, so you can test your whole integration.
Active mode (live)The buyer's wallet is charged and your merchant wallet is credited for real.

Use the mode switch on the API Access Key page. In both modes the buyer signs in with a DroppCash User account during checkout, so create a second test User account to play the buyer.

Step 3: How a payment flows

  1. Your server sends the amount, currency, your own order reference, the buyer's email and three URLs (webhook, success, cancel) to DroppCash. You get back a payment ID and a checkout link.
  2. You send the buyer to that link. They log in with their DroppCash User account and confirm the payment from their wallet in the chosen currency. If their balance is too low, the page offers to add money by card or bank transfer.
  3. DroppCash tells you the result by calling your webhook URL and by sending the buyer back to your success URL.
  4. Your server confirms the payment with DroppCash (a "check validity" call) before delivering the goods. This step is essential. The webhook and redirect are not signed, so anyone could fake them.
Always confirm before you deliver

Never ship an order just because your success page was opened. Confirm with the check-validity call, match your own order reference and amount, and fulfil each order only once.

Who can pay you through the checkout?

  • The buyer must have a DroppCash User account with a wallet in the payment currency.
  • Merchant accounts cannot pay.
  • The currency must be one DroppCash supports (see Wallets and currencies).

Key points developers ask about

ItemDetail
AuthenticationAuthorization: Bearer YOUR_ACCESS_KEY on every request
Start a paymentPOST /payment/process
Confirm a paymentGET /payment/check-validity?payment_id=.... Escrow payments answer 409 with "use the escrow status call instead" — track escrows through /payment/escrow/status and webhooks, not check-validity.
Required fields to startcurrency_code, amount, custom (your order reference, up to 20 characters), details, customer_email, web_hook, success_url, cancel_url
Response codesRead the code field in the JSON body. The HTTP status is 200 even when a request fails. 200 is success, 401 wrong key, 404 not found, 422 validation failed.
WebhookSent once, not retried. Always also run check-validity when the buyer lands on your success URL.
Not a developer?

Send the API documentation link to whoever builds your website. They only need your access key and a few lines of code.

If your site runs WooCommerce, Shopify or another shop platform, a plugin can link it to DroppCash in a few minutes — see Plugins in the API documentation.

Webhooks New

A standing URL you register once; DroppCash pushes events to it with a cryptographic signature and automatic retries. No more polling your Transactions page to find out whether something was paid.

Register a webhook

  1. Go to Webhooks in your merchant panel.
  2. Paste a public https:// URL, tick the events (all three are pre-checked) and press Register webhook.
  3. Copy the signing secret (whsec_…) from the one-time banner — it is shown exactly once.

Events and verification

EventFired when
payment.succeededA cash-code payment reaches your wallet
order.paidA storefront order is paid
settlement.completedAn auto-settlement pays out to your bank

Verify each delivery by computing HMAC-SHA256 of the raw request body with your signing secret and comparing it to the X-DroppCash-Signature header (sha256=…). The X-DroppCash-Event header names the event, and payloads carry a test flag outside production.

  • A delivery counts as failed when your server does not answer within 10 seconds or answers with anything other than a 2xx status (200, 201, 202 or 204). Failed deliveries retry automatically after 6, 24 and 72 hours (4 attempts total) and then give up. Recent deliveries shows the last 15 with the HTTP status your server returned, the tries and errors, plus a Send now manual retry.
  • Subscriptions can be Paused / Activated, get a New secret, or be deleted. Duplicate URLs per merchant are refused; deliveries time out after 10 seconds — acknowledge fast and process asynchronously.

Staff & Counter New

Your tills as sub-accounts: cashiers sign in at their own URL and see only the counter, managers also see exports, and every counter payment is attributed to the cashier who took it — so the day reconciles per person, not just per shop.

Create staff accounts

  1. Open Staff Accounts (owner management) and press Create staff account: full name, staff email (their login), counter & till name, role (Cashier or Manager) and a password.
  2. Share the email and password. Staff sign in at droppcash.app/merchant/staff/login — never through the normal merchant login.
  3. A signed-in cashier sees Signed in as, Store takings today, the Counter payments attributed to them, and today's paid orders.
  4. Their Counter page issues the cashier's own My counter QR (permanent, per cashier) with Print / fullscreen, plus a one-off Show-QR form for fixed-amount sales.
  5. Pause or remove a staff member and their login — and their permanent QR — stop working immediately.

CSV exports

Managers and the owner can run CSV exports for a date range: transactions (Date, Reference, Direction, Amount, Charge, Currency, Type, Details, Staff) and orders (Date paid, Order code, Status, Channel, Coupon, Discount, Total, Pickup, Collected at, Items). That Staff column is what makes cash-up per cashier possible.

  • Cashier sees: dashboard + counter. Manager adds: exports + staff view. Only the owner manages staff accounts.
  • Payments made on a cashier's QR are recorded on that cashier's name; the money always lands in the merchant wallet.

Auto-settlement: dollars to naira overnight New

Collecting USD or EUR? Every night at 23:00 your foreign balance is converted to naira and paid into your Nigerian bank account automatically. You set it once; the machine does the rest.

Switch it on

  1. Go to Auto-settlement in your merchant panel.
  2. In Settlement settings: tick Auto-settlement is on, choose Settle this currency (USD or EUR), and set Only settle when balance is at least (below that, conversion fees would eat your money).
  3. Fill in your naira bank details: bank name, bank code (NUBAN sort), 10-digit account number and the account holder name exactly as the bank has it. Press Save settlement settings — ON confirms: "Every night your collected USD converts to naira and is paid into your bank."
  4. Need the money now? Run a settlement now pays out immediately (it asks you to tick "I understand money will move now" first).

Settlement history

Each night is listed with the converted amount, the rate, the naira paid out and a status badge: Paid / Paying out… / Starting… / In review / Bank payout failed / Failed — returned. Every completed settlement emails you a report.

  • Minimum: your threshold or the platform floor, whichever is bigger. One settlement in flight at a time.
  • The platform's earnings on settlement is the FX spread built into the conversion rate — there is no separate percent or fixed fee, and the margin is never negative.
  • Failure is safe by design: if a quote fails the balance is untouched; if a conversion result is unknown it goes to In review for a human; if a bank payout fails after conversion, the naira stays in your wallet and is retried. Nothing is silently lost.
  • Completed settlements fire the settlement.completed webhook (see Webhooks).

Insights, monthly reports & stock alerts New

The sales intelligence layer for your shop: what sold, what settled, what is running out — on screen every day and in your inbox every month.

What you see

  • Four cards: Sales this month, Settled to bank this month, Open cash codes and Low stock now.
  • A sales-by-month chart, your top products, and a Restock soon table of products at or below their alert level.
  • Where: Insights in the merchant sidebar. The rollup refreshes nightly at 00:10.

What lands in your inbox

  • A daily sales digest at 20:00.
  • A monthly report email on the 1st at 08:00 — "Your month at {store}" with orders, sales, refunds, cash-at-agent payments, settlements and top products.
  • One low-stock alert per product per day when stock reaches the threshold you set on the product.

Invoice autopay New

Turn any invoice into a collection that pays itself: mark an invoice "Offer autopay", the customer opts in once, and on the due date their wallet is charged automatically — rent, tuition, retainers, subscriptions, without chasing anyone.

Offer autopay on an invoice

  1. Create (or edit an unpublished) invoice as usual and tick Offer autopay. Also set the invoice's due date — autopay runs on it.
  2. Send the invoice. On the payment page the customer presses Enable autopay: "Autopay is on. We will pay this invoice from your wallet on {date}."
  3. On the due date at 09:00 the customer's wallet is charged and the invoice is marked paid. You are credited like any other invoice payment.
  • If the charge fails it retries at +6h, +24h and +72h, then auto-pauses after 3 tries — nobody is charged twice and nothing is silently dropped.
  • The customer can cancel autopay on the same payment page any time before it runs.
  • Due-date reminders are separate: overdue invoices get a reminder email every morning at 09:00, and you can press remind on any invoice to send one immediately.
  • The customer-facing side is described in Invoices — how your customer pays.

Escrow checkout: let buyers pay safely

Escrow checkout works like the normal checkout, except that the buyer pays into DroppCash escrow instead of paying you directly. The money is held until the buyer releases it. This is ideal for high-value items, services and marketplaces where trust matters. You are the seller, and you are paid into your merchant wallet when the buyer releases.

How it flows

  1. Your server starts an escrow payment (same fields as a normal payment, plus an optional choice of who pays the fee) and sends the buyer to the checkout link.
  2. The buyer funds the escrow. You are told by webhook (escrow.funded) and the status becomes held. This is your signal to ship or deliver.
  3. The buyer releases the money when happy (escrow.released) and you are credited. If there is a problem, a dispute is opened (escrow.disputed) and DroppCash support decides who receives the money.
StatusMeaning
awaiting_paymentThe buyer has not funded the escrow yet
heldFunded and held. You can deliver.
releasedThe buyer released the money to you
disputedA dispute is open. Support will decide.
refundedThe money went back to the buyer
released_by_adminSupport decided in your favour and paid you
closedThe escrow closed with no payout
  • You can refund the buyer through the API while the money is still held.
  • In test mode there is no real buyer, so a simulate call lets you act as the buyer (release or dispute) to test your flow.
  • Webhooks are signed (header X-DroppCash-Signature) so you can verify they really came from DroppCash.
  • Escrow webhooks are sent once, not retried. If your server was down when an event fired, do not wait for it again — poll the escrow status call instead.
  • Merchant accounts do not have an escrow screen in the dashboard. Track escrows with the status call and webhooks.
  • Fee: 1% + NGN 100. By default it is taken from your payout; the buyer can choose to pay it on top.

Technical details are in the API documentation under Escrow Checkout.

See it in action: DroppCash inside a real website

This example is from a live customer: an online healthcare booking platform (DocPlus). Patients pay for their appointments with DroppCash, and the platform marks each appointment Paid the moment DroppCash confirms the money. Your website or app can look exactly the same — everything it uses is the standard checkout and escrow API described in Connect your website (API) and Escrow checkout. Nothing else is installed.

What each column means in DroppCash terms

On the business's screenWhat it is in DroppCash
Amount (NGN 20,370.00)The amount and currency_code the platform sent when it started the payment. The customer pays exactly this.
Payment Status PaidThe platform's own flag. It is set only after the server confirmed the payment with check-validity (normal checkout) or received the escrow.funded webhook (escrow checkout). It is never set from the success page alone.
DateWhen the customer finished checkout. The platform stores it together with the DroppCash payment ID.
Status and actions (Approve, Complete, View, Add Prescription — the booking platform's own buttons)The business's own workflow. DroppCash tells it that the money is confirmed or safely held; what happens next is up to the platform.

What happens behind the scenes

  1. The patient books and clicks Pay. The platform's server sends the amount, currency, its own order reference (custom) and three URLs to DroppCash, and opens the checkout link.
  2. The patient signs in with their DroppCash User account and pays from their wallet. If the balance is too low, the checkout offers to add money by card or bank transfer on the spot.
  3. DroppCash calls the platform's webhook and returns the patient to its success page. The platform confirms with check-validity, matches its own order reference and amount, and only then marks the appointment Paid.
  4. When escrow checkout is used, the money is held at step 3 and moves to the platform's merchant wallet when it is released after the visit — so both sides are protected until the service is delivered.
Build it in Test mode first

In Test mode the checkout, webhook and statuses behave exactly like live mode, so your own screen will show Paid during testing too — without real money moving. When it all works, switch to Active mode on the API Access Key page.

Withdrawing your earnings

Go to Withdraw > Withdraw Money. You need approved KYC.

  1. Choose the wallet (currency) you are withdrawing from.
  2. Choose a method, enter the amount and your account details (bank details, PayPal email, crypto address and so on, as the method's instructions say).
  3. Submit. The amount plus the method fee is taken from your wallet at once.
  4. Standard methods are reviewed by our team and then paid. If rejected, you are refunded in full and the reason is shown in Withdraw History.
  5. Instant Bank Transfer (NGN): choose your bank, enter your 10-digit account number, check the account name and fee shown, and confirm. It is paid within minutes. The bank account name must match your merchant profile name (at least two parts), otherwise it goes to manual review.

Methods, limits and fees are the same as in Withdraw money (for example NGN bank transfer 500 to 500,000 with no fee; most international methods 1%).

Planning payouts

Payments you receive are in your wallet immediately, so you can withdraw as often as you like within the method limits. Withdraw regularly rather than letting large balances build up.

Go-live checklist

  1. Business name on your profile is correct.
  2. KYC is verified.
  3. Two-step security is on.
  4. Your integration works end to end in Test mode (payment, webhook, success redirect, cancel redirect, check-validity).
  5. Your server confirms every payment with check-validity before delivering, and delivers each order only once.
  6. Your access key is only on your server, not in your web page or mobile app code.
  7. You switched the API Access Key page to Active mode and ran one small real payment from a test buyer account.
  8. Your QR code is printed or shared, if you also take payments in person.
  9. You created a discount code and set low-stock alerts on your products (see My Store).
  10. You registered a webhook URL and saved the signing secret somewhere safe (see Webhooks).
  11. You created staff accounts for your cashiers, if others take payments (see Staff & Counter).
  12. If you collect USD or EUR, auto-settlement is switched on with your bank details (see Auto-settlement).

Merchant FAQ and troubleshooting

The customer's voucher is worth more than the purchase. What happens to the rest?

Enter the price of the purchase when you redeem. Only that amount is taken and the rest stays on the voucher for the customer. See Redeeming cash vouchers.

"Invalid or already used voucher code".

The code is wrong or the voucher has nothing left. Check the digits with the customer.

Customers cannot find my business by phone number.

A phone number only finds an account that has verified it, and only one merchant account can hold a verified number. Verify your number from the banner on your dashboard, or give customers your email or QR code.

Can I pay another merchant or send money to a friend from a Merchant account?

No. Merchant accounts receive and withdraw. If you need to send money, withdraw it, or use a separate User account.

A customer says they paid, but I do not see it.

Ask for their transaction reference and search it in Transactions. Check that they paid the right merchant email (it must be yours, not another merchant's). For online orders, confirm with check-validity using the payment ID.

A customer cannot pay on my website.

They must be a DroppCash User (not a Merchant or Agent), logged in, with a wallet in the payment currency and enough balance. If the balance is too low, the checkout offers to add money by card or bank transfer. They then go back to your site and start again.

The API says "Invalid API credentials".

The access key is missing or wrong. Send it as Authorization: Bearer YOUR_ACCESS_KEY. If you regenerated the key, update it in your code.

The API returns HTTP 200 but my payment did not start.

Always read the code field in the JSON response. Anything other than 200 is an error and the message explains what to fix.

Why was I credited less than the customer paid?

The customer pays the full amount and the DroppCash fee is deducted from what you receive. The fee is shown on the transaction. See Fees on money you receive.

I cannot withdraw.

Withdrawals need approved KYC and a wallet with enough balance for the amount plus fee. If your KYC is under review, wait for approval; if it was rejected, re-submit it.

Did a test-mode payment charge anyone?

No. In Test mode no money moves and no wallet balance is needed. Switch to Active mode only when you are ready for real payments.

What name do customers see at checkout?

Your business name from Setting > Profile Setting. If it is empty, your account name is shown.

Fees and limits at a glance

This table shows DroppCash's current settings (the same values your dashboard reads live). A fee such as "0.5% + NGN 1" means 0.5% of the amount plus a fixed NGN 1 (converted to your wallet's currency). "Free" means no fee.

ActionWho pays the feeFeeMinimumMaximumDaily / monthly limit
Transfer moneySender (added on top)FreeNGN 100NGN 1,000,000NGN 2,000,000 / NGN 50,000,000
Request moneyRequester (taken from what they receive)0.5% + NGN 10NGN 500NGN 1,000,000-
Exchange moneyPerson exchanging (added on top)0.5% + NGN 20NGN 1,000NGN 10,000,000-
Pay a merchantMerchant (taken from what they receive)0.5% + NGN 10---
Pay through the website checkout (API)Merchant (taken from what they receive)0.5% + NGN 10---
Create a cash voucherCreator (added on top)FreeNGN 1,000NGN 1,000,000-
Invoice paidInvoice creator (taken from what they receive)0.5% + NGN 10---
Escrow / Pay with ProtectionBuyer if they choose to pay it, otherwise the seller (taken from payout)1% + NGN 100---
Send to someone without an accountSender (added on top; returned if cancelled or expired)Free (transfer fee)NGN 100NGN 100,000 per held transfer, 5 per dayNGN 2,000,000 / NGN 50,000,000
Merchant redeems a cash voucherMerchant (taken from what they receive)FreeNGN 100NGN 1,000,000-
Agent creates a cash voucherAgent (DroppCash charge); the agent may collect a fee in cashFreeNGN 100NGN 1,000,000-
Agent redeems a cash voucherAgent (DroppCash charge); agent earns 30% fee shareFreeNGN 100NGN 1,000,000-
Cash out to an agent (including by SMS code)Customer (added on top); agent earns 30% of the fee0.5% + NGN 10NGN 500NGN 200,000NGN 2,000,000 / NGN 50,000,000
Cash in (agent credits a customer)No fee to the customer. The agent earns 0.5% commission.Free for the customerNGN 500NGN 1,000,000-
Merchant cash code paid through an agentMerchant (taken from what they receive); the agent keeps half of the fee1.5% + NGN 50NGN 100NGN 500,000-
Esusu payoutPaid from the pot when a round's beneficiary is paidNGN 100---
Savings pockets, scheduled payments, bills, USSD, insights—No platform fee at launch. USSD sessions carry the telco's small session fee; bill fees and any per-order cap are shown before you confirm.
USD virtual cards—No funding fee at launch; ₦2,000–₦500,000 per load. The card issuer's own exchange rate applies when you fund.
DepositShown per method on the deposit formAutomatic methods (including pay-by-bank with Mono and Plaid) and most bank transfers carry no DroppCash fee. Any fee is displayed before you confirm.
WithdrawPerson withdrawing (added on top)Depends on the method, for example free for NGN bank transfer and 1% for most international methods. See Withdraw money.
Referral earningsPaid to you: 1% (Users) / 15% (Merchants) / 2% (Agents) of the fees your invitees pay, held 7 daysSee Refer & Earn.
Reading the limits

Limits are set in the default currency (NGN) and automatically converted for other currencies. Daily totals reset at midnight; monthly totals reset on the 1st.

Worked examples

Cash out

You cash out NGN 10,000 to an agent. At the current rate the fee is shown on the form. You are charged the amount plus that fee; the agent is credited NGN 10,000 and gives you NGN 10,000 in cash.

Paying a merchant

You pay a shop NGN 20,000. Your wallet goes down by exactly NGN 20,000. The shop is credited NGN 20,000 minus the merchant payment fee.

Invoice

You invoice a customer NGN 50,000. They pay NGN 50,000. You are credited NGN 50,000 minus the invoice fee.

Exchange

You convert NGN 100,000 to USD. NGN 100,000 plus the exchange fee leaves your NGN wallet; your USD wallet is credited the converted amount at the rate shown.

The nightly machine New

A lot of DroppCash happens while you sleep. These automatic jobs keep wallets, savings, stores and shops honest — you never have to press anything, and every one of them is safe: money that cannot move is refunded or held for review, never lost.

WhenWhat runs
Every 5 minutesInstant bank withdrawals waiting for confirmation are re-checked; stuck bill payments are re-queried (failed ones are auto-reversed after 30 minutes)
Every 15 minutesReferral earnings whose hold ended are released; expired held transfers return to the sender; webhook deliveries retry; the agents-map "has cash" badges are cleared after closing time; unpaid storefront orders expire; crypto exchange rates refresh
HourlyScheduled payments and savings auto-funds run; protected payments are checked for delivery windows, reminders and auto-release; Esusu contributions are collected and beneficiaries paid
Every 6 hoursFiat exchange rates refresh
00:10 nightlySpending and sales rollups rebuild (feeds My Spending and merchant Insights)
06:00Locked savings pockets whose time is up mature
06:30Agent applications still missing a verified phone after 14 days are auto-rejected, with an email
09:00Overdue invoice reminders go out; invoice autopay charges due invoices
20:00Merchants get their daily sales digest
21:00Agents get their daily earnings statement (email + in-app)
23:00Auto-settlement converts USD/EUR balances and pays merchants in naira
Mondays 07:00Agent weekly volume tier bonuses are paid
1st of the month07:00: your month-in-review spending email; 08:00: the merchant monthly report
Good to know

These jobs run on the hosting platform's own scheduler — nothing for you to switch on. If something looks stuck (a "Paying out…" settlement, a pending bill), wait for the next run of the matching job before contacting support; most things complete themselves.

Glossary

TermMeaning
WalletYour balance in one currency. You can have many wallets.
FloatThe money an agent keeps in their wallet to serve customers.
Cash InGiving cash to an agent so they credit your wallet.
Cash OutSending wallet money to an agent so they give you cash.
CommissionWhat an agent earns on each cash-in.
EscrowA payment held by DroppCash until the buyer releases it or support resolves a dispute.
DisputeA complaint on an escrow, with messages and optional screenshots, decided by DroppCash support.
AI case reviewAn automated case analyst that reads a dispute's escrow chat, milestones and evidence and prepares a recommendation for the support team. It only advises; people decide, and it can never move money.
Cash voucherA one-time code worth real money (often just called a voucher). Whoever redeems it first receives the money.
KYCIdentity verification (know your customer).
Two-step securityAn SMS code required at login in addition to your password.
Verified phone numberA phone number you have confirmed with an SMS code. Only a verified number can be used to log in or to be found by phone, and only one account can hold it.
Held transferMoney sent to an email that has no DroppCash account yet. It is held until the person opens an account, and returned to the sender if it is cancelled or expires.
Help AssistantDroppCash's built-in AI chat (the bubble in the bottom-right corner) that answers questions about using the platform.
Saved recipientA person you saved with a nickname, so you can pick them instead of typing their email or phone number.
Partly used voucherA cash voucher where a merchant took only the price of a purchase. The rest stays on the voucher.
Private QR tokenThe encrypted code inside your QR code. Only DroppCash can decode it, so your email never appears in the code itself.
Customer cash-out (SMS code)A cash-out started by an agent and confirmed by the customer with a code sent by SMS.
Refer & EarnThe programme where you earn a share of the fees paid by people you invite with your personal link or code.
Escrow chatThe private message thread between the two people on an escrow, open while the money is held or disputed.
Account numberA permanent Nigerian bank account number in your own name. Transfers into it land in your wallet automatically.
Pay by bankA deposit method that charges your own bank directly through a partner: Mono (Nigeria, instant) and Plaid (UK and Europe) where enabled.
Buy and sell pricesEach currency can carry two exchange prices — one for converting into the default currency and one for converting out of it — refreshed automatically.
POS terminalA counter device or kiosk app connected to an agent account through the agent API: customer lookup, cash-in and merchant cash-code redemption.
Pay with ProtectionA payment held by DroppCash until the buyer approves the delivery (or cancels for a full refund before delivery). See Escrow.
MilestoneA stage of a protected payment. The seller delivers each stage, the buyer releases each stage's money.
Auto-releaseAfter the chosen window (7 / 14 / 30 days) a held payment pays the seller automatically unless the buyer approves or disputes first.
Payment linkA shareable link and QR that collect money for you — fixed amount or payer's choice, once or reusable.
Savings pocketA ring-fenced sub-account of your wallet for a goal, with optional locks of 30 / 90 / 180 / 365 days.
Scheduled paymentA standing order or savings auto-fund that runs automatically (daily, weekly, monthly or quarterly) at 09:00.
EsusuA rotating savings circle of 5–25 people. Each round the pot pays one member, in a fixed order, minus a flat payout fee.
Bills & airtimeThe hub for airtime, data, TV and electricity payments from the wallet.
USSDThe short dial code that works on any phone without internet, protected by a PIN.
Virtual cardA USD card for online payments, funded from your naira wallet.
Cash codeAn 8-digit code that carries a merchant payment: the customer shows it at any agent, pays cash, and the merchant is credited.
Float accountAn agent's own NGN account number. Transfers into it top up the shop's float instantly.
Sub-tellerA till login for an agent's shop. Payments are recorded on the till; commission lands on the shop's wallet.
End-of-Day sheetThe printable daily till reconciliation an agent (or teller) files: expected vs counted cash, difference and note.
Auto-settlementThe nightly conversion of a merchant's USD/EUR balance to naira, paid to their Nigerian bank.
Volume tierAn agent's weekly bonus level, based on cash-in + cash-out volume over the last 7 days.
Transaction referenceThe unique ID of a payment, used for searching and support.
API access keyA secret key that lets your software act for your account. Keep it private.
Test mode / Active modeTest mode: nothing real is charged. Active mode: real money moves.
WebhookA message DroppCash sends to your server when a payment or escrow event happens.
Default currencyThe platform's base currency (NGN). Fees and limits are defined in it.

Still need help?

If the answer is not in this guide:

Support ticket

Log in and open Support Ticket. Best for anything about your account or a transaction. You can attach screenshots.

Contact page

Use the contact form if you cannot log in.

FAQ and solutions

Short answers on the FAQ page, and one-page overviews of each feature under Solutions in the footer.

This guide describes the DroppCash platform as it works today. Fees, limits and available payment methods can change; the forms inside your dashboard always show the current values before you confirm anything.

Back to top ↑