Complete KYB Verification
Submit your business details to unlock live API keys and start accepting real payments.
Complete KYB Verification
Before you can accept real payments, Bag needs to verify your business. This is called KYB (Know Your Business) — it's a regulatory requirement for any Merchant of Record.
The process takes about 5 minutes to submit and is typically reviewed within 1-2 business days.
Why KYB is required
As a Merchant of Record, Bag is the legal seller in every transaction. That means we need to know who we're paying out to. KYB verification lets us:
- Comply with financial regulations
- Issue live API keys
- Process settlements to your wallet or bank account
You can build and test your entire integration without KYB. Test keys work immediately. KYB is only required when you're ready to go live.
The verification process
KYB is a 4-step wizard in the Bag dashboard:
Step 1: Welcome
Confirm you're ready to start the verification process.
Step 2: Business basics
| Field | Required | Description |
|---|---|---|
| Business name | Yes | Your legal business name |
| Business type | Yes | e.g. LLC, Corporation, Sole Proprietor |
| Registration number | No | Business registration or tax ID |
| Country | Yes | 2-letter ISO code (e.g. US, IN, GB) |
| Website | No | Your product's URL |
| Product description | Yes | What you sell (up to 2000 characters) |
| Expected monthly volume | Yes | Estimated monthly payment volume |
| Primary use case | No | e.g. SaaS, digital goods, subscriptions |
Step 3: Identity
| Field | Required | Description |
|---|---|---|
| Contact name | Yes | Your full name |
| Contact email | Yes | Your email address |
| Contact role | No | Your role in the business |
Sensitive fields (name, email, registration number) are encrypted at rest with AES-256-GCM.
Step 4: Payout setup
| Field | Required | Description |
|---|---|---|
| Payout method | No | usdc_wallet or bank_account |
| Payout wallet address | No | Your USDC wallet for receiving settlements |
| Payout network | No | Which network to settle on |
You can update payout details later from the dashboard.
KYB statuses
| Status | Meaning |
|---|---|
not_submitted | Haven't started the process |
pending_review | Submitted, waiting for Bag to review |
approved | Verified — live keys available |
rejected | Verification failed — check email for details |
Submit via the dashboard
- Sign in to the Bag dashboard.
- If you haven't completed KYB, you'll see the onboarding wizard.
- Fill in each step and submit.
- You'll receive an email when your application is reviewed.
Submit via the API
You can also submit KYB programmatically:
curl -X POST https://justusebag.xyz/api/kyb \
-H "Authorization: Bearer $BAG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"businessName": "Acme Inc",
"businessType": "LLC",
"country": "US",
"contactName": "Jane Doe",
"contactEmail": "jane@acme.com",
"productDescription": "SaaS project management tool",
"expectedMonthlyVolume": "$5,000 - $10,000"
}'After approval
Once approved:
- Generate a live API key in Developer Settings.
- Update your environment — swap your test key for the live key and switch to production networks.
- Start accepting payments.
See the Go Live Checklist for the full transition process.