Partner FAQs

Frequently asked questions about OZZOBiT integration

How long does it take to integrate OZZOBiT?

The basic widget integration (redirection or iFrame) can be completed in under an hour. Whitelabel API integrations typically take 1-3 days depending on complexity. Mobile SDKs take 1-2 days.

Can I use OZZOBiT in my mobile app?

Yes! We support Android (Kotlin/Java), iOS (Swift/SwiftUI), and React Native. Flutter is deprecated - see our Flutter guide for alternatives.

Do I need to build my own KYC flow?

No. OZZOBiT handles all KYC verification internally. Users complete identity verification within the OZZOBiT widget or through our API. You can also use KYC Reliance to reuse existing Sumsub verifications.

Can I white-label the entire experience?

Yes, using the Whitelabel API, you can build a completely custom UI while OZZOBiT handles compliance and settlement in the background.

What payment methods are supported?

We support credit/debit cards (Visa, Mastercard), bank transfers (ACH, SEPA, Faster Payments, wire), Apple Pay, Google Pay, and 100+ local payment methods depending on the country.

What are the transaction limits?

Limits vary by KYC level, country, and payment method:

  • Tier 0 (Email only): $10-$75/day
  • Tier 1 (Basic info): $75-$500/day
  • Tier 2 (Full KYC): $500-$10,000+/day
  • Tier 3 (Enhanced): Custom limits available

How long do transactions take?

  • Card payments: Instant to 10 minutes
  • Bank transfers: Same day to 3 business days (varies by country)
  • Crypto delivery: Typically within minutes of payment confirmation

What happens if a transaction fails?

If payment fails, the user is notified immediately and can retry. Funds are never deducted for failed transactions. You receive a webhook event with failure details.

What documents are required for KYC?

Typically a government-issued photo ID (passport, driver's license, national ID) and a selfie. Some regions may also require proof of address for higher tiers.

How long does KYC approval take?

Most automated approvals happen within 1-5 minutes. Manual review (for edge cases) takes up to 24 hours during business days.

Is KYC data shared with partners?

No. KYC data is processed and stored by OZZOBiT in compliance with GDPR and other data protection regulations. Partners receive only KYC status updates via webhooks/APIs, not raw document data.

Can I skip KYC for small amounts?

Some jurisdictions allow reduced KYC for amounts below certain thresholds. Use the /kyc/skip API endpoint to check eligibility. Contact support for your region-specific requirements.

What are the API rate limits?

  • Public API: 60 requests/minute per IP
  • Whitelabel API: 120 requests/minute per partner key
  • Webhook delivery: Up to 5 retries with exponential backoff

Is there an SDK for my framework?

We provide official SDKs for JavaScript/TypeScript (web), Kotlin/Java (Android), Swift (iOS), and React Native. For other frameworks, use our REST API directly or embed the widget via iFrame.

How do I handle webhooks securely?

All webhooks are encrypted with AES-256-GCM. See our decryption guide for implementation examples in JavaScript, Java, and Go. Always verify signatures before processing.

Do you support testnet/sandbox?

Yes! Set environment=STAGING to use sandbox mode with fake transactions. Test on Goerli/Mumbai testnets before mainnet deployment.

How much does OZZOBiT cost?

Pricing varies based on volume, products used, and integration type. Contact our sales team at sales@OZZOBiT.com for a custom quote.

Who pays the fees?

Fees can be structured in different ways: paid by the user (added to the exchange rate), paid by you (revenue share model), or split between both. Discuss options with your account manager.

Are there minimum volume requirements?

No strict minimums for getting started. Enterprise pricing tiers with better rates become available as your volume grows.

How do I get technical support?

Use the Partner Support Hub to submit tickets. Enterprise partners get dedicated Slack channels and priority support.

My widget isn't loading. What should I check?

  1. Verify your API key is correct and active
  2. Check browser console for errors
  3. Ensure your domain is allowed in dashboard settings
  4. Try disabling browser extensions (ad blockers may interfere)
  5. Test with environment set to STAGING

Where can I find API status information?

Check our status page at OZZOBiT.com/status for real-time system status and incident history.