KYB/KYC Requirements
Merchant onboarding verification process, required documents, and timeline.
KYB/KYC Requirements
All merchants must complete Know Your Business (KYB) verification before accepting live payments. Sandbox mode is available immediately — no verification required.
Verification Process
┌─────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐
│ Sign Up │───▶│ Submit KYB │───▶│ Under │───▶│ Approved │
│ │ │ Documents │ │ Review │ │ (Go Live) │
└─────────────┘ └──────────────┘ └──────────────┘ └──────┬──────┘
│ │
▼ │
┌──────────────┐ │
│ Rejected │ │
│ (Resubmit) │──────────┘
└──────────────┘Step 1: Sign Up
Create a Bag account and start building in sandbox mode immediately. No documents required.
Step 2: Submit KYB Documents
When you're ready to go live, submit your business verification through the onboarding flow in the dashboard.
Required documents:
| Document | Description |
|---|---|
| Business registration | Certificate of incorporation, articles of organization, or equivalent |
| Proof of address | Utility bill, bank statement, or government correspondence (< 3 months old) |
| Beneficial ownership | Disclosure of individuals owning 25%+ of the business |
| Identity verification | Government-issued ID for the primary account holder |
| Bank or wallet details | Payout destination for settlements |
Additional documents may be requested based on your jurisdiction, business type, or expected transaction volume.
Step 3: Review
Bag reviews your submission. During review:
- Sandbox access continues uninterrupted
- You can update your submission if additional information is needed
- Status is visible in the dashboard under Settings > KYB Status
Step 4: Approval
Once approved:
- Live API keys become available in Developer Settings
- You can accept real payments
- Settlement and payout features are activated
KYB Status
| Status | Meaning |
|---|---|
not_submitted | KYB documents have not been submitted yet |
submitted | Documents submitted, under review |
approved | Verification complete, live payments enabled |
rejected | Verification failed — check dashboard for details and resubmit |
Check status via the dashboard or API:
curl https://getbags.app/api/kyb \
-H "Authorization: Bearer $BAG_API_KEY"Timeline
| Step | Typical Duration |
|---|---|
| Document submission | 5–10 minutes |
| Initial review | 1–3 business days |
| Additional info request (if needed) | Adds 1–2 business days |
| Final approval | Same day after all documents are verified |
KYC for Individuals
If you operate as a sole proprietor or individual, the KYB process includes personal identity verification (KYC):
- Government-issued photo ID (passport, driver's license, or national ID)
- Proof of address
- Selfie verification (in some jurisdictions)
Prohibited Industries
Bag cannot onboard merchants in the following categories:
- Gambling and online casinos
- Adult content and services
- Weapons and ammunition
- Controlled substances
- Money transmission services
- Ponzi or pyramid schemes
- Sanctioned entities or individuals