# Numero Documentation

## Docs
- [Overview](https://doc.usenumero.com/overview-1808887m0.md): 
- [Transfers & Payouts](https://doc.usenumero.com/transfers-payouts-5758547f0.md): 
- [Virtual Accounts](https://doc.usenumero.com/virtual-accounts-5758549f0.md): 
- [Transaction History](https://doc.usenumero.com/transaction-history-5758560f0.md): 
- [Webhooks & Security](https://doc.usenumero.com/webhooks-security-5758544f0.md): 
- Webhooks & Security [Webhook Notifications](https://doc.usenumero.com/webhook-notifications-1808875m0.md): 
- [Utility](https://doc.usenumero.com/utility-7709879f0.md): No signature required on **generatesignature** (not wrapped in SignatureValidation).
- [Verification — POST (signed)](https://doc.usenumero.com/verification-post-signed-7709880f0.md): All requests require `{{apiHeaderName}}: {{apiKey}}` and a valid HMAC signature over the raw body (see collection pre-request script).
- [Verification — GET (API key only)](https://doc.usenumero.com/verification-get-api-key-only-7709881f0.md): These routes use **BusinessValidationFilter** (API key) only — **no** request signature.

## API Docs
- Transfers & Payouts [Validate Account Number](https://doc.usenumero.com/validate-account-number-24940620e0.md): 
- Transfers & Payouts [Initiate Single Transfer](https://doc.usenumero.com/initiate-single-transfer-24940621e0.md): 
- Transfers & Payouts [Initiate Bulk Transfer](https://doc.usenumero.com/initiate-bulk-transfer-24940622e0.md): 
- Transfers & Payouts [Transfer Status](https://doc.usenumero.com/transfer-status-24940625e0.md): 
- Virtual Accounts [Create Virtual Account Customer](https://doc.usenumero.com/create-virtual-account-customer-24940623e0.md): 
- Virtual Accounts [Create Virtual Account Business](https://doc.usenumero.com/create-virtual-account-business-24940624e0.md): 
- Virtual Accounts [Get Virtual Account](https://doc.usenumero.com/get-virtual-account-24940627e0.md): 
- Virtual Accounts [Get All Virtual Accounts](https://doc.usenumero.com/get-all-virtual-accounts-24940628e0.md): 
- Virtual Cards > USD Virtual Cards [Issue Card](https://doc.usenumero.com/issue-card-31587570e0.md): **DTO:** `IssueCardRequestDto`
- Virtual Cards > USD Virtual Cards [Top Up Card](https://doc.usenumero.com/top-up-card-31587571e0.md): **DTO:** `TopUpCardRequestDto` — `cardId`, `amount` (double).
- Virtual Cards > USD Virtual Cards [Withdraw From Card](https://doc.usenumero.com/withdraw-from-card-31587572e0.md): **DTO:** `WithdrawCardRequestDto` — `cardId`, `amount`, optional `reason`.
- Virtual Cards > USD Virtual Cards [Activate Card](https://doc.usenumero.com/activate-card-31587573e0.md): **DTO:** `ActivateCardRequestDto` — `cardId`.
- Virtual Cards > USD Virtual Cards [Deactivate Card](https://doc.usenumero.com/deactivate-card-31587574e0.md): **DTO:** `DeactivateCardRequestDto` — `cardId`.
- Virtual Cards > USD Virtual Cards [Get Card Transactions](https://doc.usenumero.com/get-card-transactions-31587575e0.md): **DTO:** `CardTransactionRequestDto`
- Virtual Cards > USD Virtual Cards [Get Merchant Customers](https://doc.usenumero.com/get-merchant-customers-31587576e0.md): **DTO:** `MerchantCustomerRequestDto` — currently **empty object** `{}`.
- Virtual Cards > USD Virtual Cards [Get Card Details](https://doc.usenumero.com/get-card-details-31587577e0.md): **DTO:** `CardDetailsRequestDto` — `cardId`, `withPan` (bool, default false).
- Virtual Cards > USD Virtual Cards [List Cards By Customer Id](https://doc.usenumero.com/list-cards-by-customer-id-31587578e0.md): **DTO:** `ListCardsRequestDto` — `customerId` (maps to `cardCustomerId` from issue response).
- Transaction History [Get Transactions](https://doc.usenumero.com/get-transactions-24940626e0.md): 
- Webhooks & Security [Generate Signature](https://doc.usenumero.com/generate-signature-24940619e0.md): 
- Utility [Generate signature (debug)](https://doc.usenumero.com/generate-signature-debug-32446859e0.md): Returns a **plain text** Base64 signature string for the JSON body, using the same `JsonSerializerOptions` as live verification (camelCase + relaxed escaping). Use the **exact** body you will send on the target POST; copy the response into the signature header if auto-sign mismatches.
- Verification — POST (signed) [BVN](https://doc.usenumero.com/bvn-32446860e0.md): Bank Verification Number (basic). **Body:** `bvn` (required), `idempotencyKey` (optional).
- Verification — POST (signed) [NIN](https://doc.usenumero.com/nin-32446861e0.md): National Identification Number (NG).
- Verification — POST (signed) [BVN Advanced](https://doc.usenumero.com/bvn-advanced-32446862e0.md): Extended BVN verification (advanced tier).
- Verification — POST (signed) [Bank account](https://doc.usenumero.com/bank-account-32446863e0.md): Resolve account name / validation. **bankCode** = bank sort code.
- Verification — POST (signed) [CAC Advanced](https://doc.usenumero.com/cac-advanced-32446864e0.md): Corporate Affairs Commission — advanced lookup by registration number.
- Verification — POST (signed) [CAC Premium](https://doc.usenumero.com/cac-premium-32446865e0.md): CAC premium tier.
- Verification — POST (signed) [CAC Basic](https://doc.usenumero.com/cac-basic-32446866e0.md): CAC basic lookup.
- Verification — POST (signed) [CAC by name](https://doc.usenumero.com/cac-by-name-32446867e0.md): CAC advanced by company name.
- Verification — POST (signed) [TIN](https://doc.usenumero.com/tin-32446868e0.md): Tax Identification Number verification.
- Verification — POST (signed) [Phone basic](https://doc.usenumero.com/phone-basic-32446869e0.md): Phone identity (basic tier).
- Verification — POST (signed) [Phone advanced](https://doc.usenumero.com/phone-advanced-32446870e0.md): Phone identity (advanced tier).
- Verification — POST (signed) [Phone + NIN](https://doc.usenumero.com/phone-nin-32446871e0.md): Link phone with NIN.
- Verification — POST (signed) [PVC](https://doc.usenumero.com/pvc-32446872e0.md): Permanent Voter Card (standard).
- Verification — POST (signed) [PVC Premium](https://doc.usenumero.com/pvc-premium-32446873e0.md): PVC premium tier.
- Verification — POST (signed) [FRSC](https://doc.usenumero.com/frsc-32446874e0.md): FRSC / driver licence–related identifier verification.
- Verification — POST (signed) [Address](https://doc.usenumero.com/address-32446875e0.md): Address verification.
- Verification — POST (signed) [Passport](https://doc.usenumero.com/passport-32446876e0.md): International passport verification. **Required:** passport number, **lastName**, **dateOfBirth** (ISO or parseable date).
- Verification — POST (signed) [AML](https://doc.usenumero.com/aml-32446877e0.md): AML / PEP screening. **`countries` is required:** comma-separated ISO2 (e.g. `NG` or `NG,KE`) or JSON string array `["NG"]`. Derive year from `dateOfBirth` if `yearOfBirth` omitted.
- Verification — POST (signed) [Generic — TriCredit summary (BVN)](https://doc.usenumero.com/generic-tricredit-summary-bvn-32446878e0.md): **Generic route:** `verification/{verificationCode}` where code is uppercased (hyphens → underscores). Use when the verification type is **enabled for merchants** in `VerificationTypes`. Credit types are often admin-only (`MerchantEnabled = false`).
- Verification — POST (signed) [Generic — CRC (BVN)](https://doc.usenumero.com/generic-crc-bvn-32446879e0.md): Credit CRC check — **`bvn`** in payload.
- Verification — POST (signed) [Generic — Kenya CRB](https://doc.usenumero.com/generic-kenya-crb-32446880e0.md): Kenya CRB (credit bureau) check. Payload: **firstName**, **lastName**, **nationalId** (aliases: `nationalid`, `idNumber`).
- Verification — POST (signed) [Generic — National ID (KE)](https://doc.usenumero.com/generic-national-id-ke-32446881e0.md): Kenya national ID verification.
- Verification — POST (signed) [History](https://doc.usenumero.com/history-32446882e0.md): Paginated verification history for the business resolved from API key.
- Verification — GET (API key only) [Get by ID](https://doc.usenumero.com/get-by-id-32446883e0.md): Single verification detail for this business. Replace `1` with `verificationRequestId` from verify response or history.
- Response reference [POST verify — ApiResponse shape](https://doc.usenumero.com/post-verify-apiresponse-shape-32446884e0.md): Standard wrapper: `ApiResponse<T>`