Numero Documentation
    • Overview
    • Transfers & Payouts
      • Validate Account Number
        POST
      • Initiate Single Transfer
        POST
      • Initiate Bulk Transfer
        POST
      • Transfer Status
        GET
    • Virtual Accounts
      • Create Virtual Account Customer
        POST
      • Create Virtual Account Business
        POST
      • Get Virtual Account
        GET
      • Get All Virtual Accounts
        GET
    • Virtual Cards
      • USD Virtual Cards
        • Issue Card
        • Top Up Card
        • Withdraw From Card
        • Activate Card
        • Deactivate Card
        • Get Card Transactions
        • Get Merchant Customers
        • Get Card Details
        • List Cards By Customer Id
    • Transaction History
      • Get Transactions
        GET
    • Webhooks & Security
      • Webhook Notifications
      • Generate Signature
        POST
    • Utility
      • Generate signature (debug)
        POST
    • Verification — POST (signed)
      • BVN
        POST
      • NIN
        POST
      • BVN Advanced
        POST
      • Bank account
        POST
      • CAC Advanced
        POST
      • CAC Premium
        POST
      • CAC Basic
        POST
      • CAC by name
        POST
      • TIN
        POST
      • Phone basic
        POST
      • Phone advanced
        POST
      • Phone + NIN
        POST
      • PVC
        POST
      • PVC Premium
        POST
      • FRSC
        POST
      • Address
        POST
      • Passport
        POST
      • AML
        POST
      • Generic — TriCredit summary (BVN)
        POST
      • Generic — CRC (BVN)
        POST
      • Generic — Kenya CRB
        POST
      • Generic — National ID (KE)
        POST
      • History
        GET
    • Verification — GET (API key only)
      • Get by ID
    • Response reference
      • POST verify — ApiResponse shape

    Overview

    Numero Logo

    Numero Developer Docs#

    Build scalable fintech products with Numero's robust infrastructure.
    Create virtual accounts, manage transfers, and automate payouts with just a few lines of code.
    Get API Keys
    Contact Support
    💸

    Transfers & Payouts#

    Send money instantly to any bank account in Nigeria. Supports single and bulk transfer requests.
    🏦

    Virtual Accounts#

    Create dynamic NUBAN accounts for your customers to receive funds via bank transfer.
    📜

    Transaction History#

    Retrieve detailed reports and reconcile payments with ease.
    🔔

    Webhooks#

    Listen for real-time events like incoming credits or failed transfers.

    Authentication#

    The Numero API uses API keys to authenticate requests. You can view and manage your API keys in the Merchant Dashboard.
    Your API keys carry many privileges, so be sure to keep them secret! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.
    Authentication to the API is performed via the x-api-key header.
    x-api-key: NUMERO_SECRET_KEY

    Request Signature#

    For security, all POST requests (like Transfers) also require a signature in the x-signature-key header. You can read the full guide on generating signatures in the Security & Webhooks section.

    Base URLs#

    All API requests should be made to one of the following base URLs:
    Sandbox (Test)https://api-dev.usenumero.com/numeroaccount
    Production (Live)https://api.usenumero.com/numeroaccount
    Modified at 2025-12-09 09:37:18
    Next
    Transfers & Payouts
    Built with