FAQ

Getting Started

How do I get started?

Sign up at moosyl.com
Get API keys from dashboard
Choose SDK: Flutter or React
Set up webhooks for notifications
Test with test keys

What payment methods are supported?

Moosyl integrates with Mauritania's banking apps:

Bankily by BPM
Sedad by BMI
Masrivi by BMCI
BimBank by BimBank
Click by BNM

Do I need a merchant account?

No, Moosyl handles payment processing and settlement directly to your bank account.

API Keys

Publishable vs Secret keys?

Publishable (pk_...): Safe for client-side (Flutter, React)
Secret (sk_...): Backend only, keep secure

How to keep keys secure?

Never expose secret keys in client code
Use environment variables
Rotate keys regularly
Use different keys per environment

Can I test without real payments?

Yes! Use test keys (pk_test_..., sk_test_...) for safe testing without real money.

Payments

How long do payments take?

Processing: Real-time (immediate)
Settlement: 1-3 business days
Webhooks: Delivered within seconds

What currencies are supported?

Currently supports MRU (Mauritanian Ouguiya). Additional currencies available on request.

What are payment limits?

Limits depend on verification level:

Unverified: Lower limits
Verified: Higher limits after KYC
Enterprise: Custom limits

Can I refund payments?

No, refunds are not supported yet. We are working on it.

Webhooks

What events are available?

payment-request-created - New payment request
payment-request-updated - Request status changed
payment-created - Payment processed
payment-updated - Payment status updated

How do I verify signatures?

Use HMAC-SHA256 verification. See webhooks guide for implementation.

What if my endpoint is down?

Moosyl retries failed deliveries:

Schedule: 1, 2, 4, 8, 16, 32 minutes
Max retries: 6 attempts
Total window: ~1 hour

Can I receive duplicates?

Yes, webhooks may be delivered multiple times due to retries or network issues. Handle duplicates on your own.

Troubleshooting

Flutter app won't load payment interface?

Check API key is correct
Ensure transaction ID exists
Verify network connection
Update to latest SDK version

Webhooks not received?

Confirm endpoint is publicly accessible
Use HTTPS only
Return 200 status code
Check dashboard logs

Payment methods not showing?

Verify account configuration
Check transaction limits
Confirm account verification status

Payment failures?

Show user-friendly error messages
Provide retry options
Log errors for debugging
Contact support for persistent issues

Pricing

How does pricing work?

Transaction fees: Small percentage per payment
No monthly fees: Pay per use
Volume discounts: Available for high volume
No setup fees: Start immediately

Contact sales for detailed pricing.

When do I get paid?

Standard: 1-3 business days
Verified: Faster options available
Enterprise: Custom schedules

Support

Supported languages?

Flutter/Dart: Mobile apps
React/JavaScript: Web apps
Node.js/Python/PHP: Backend
Direct API: Any language

Code examples?

Yes! Complete examples in documentation and GitHub repositories.

Get help?

Email: support@moosyl.com
Dashboard: Built-in support
Docs: Comprehensive guides
Community: Developer discussions

API uptime?

99.9% SLA with redundant infrastructure and real-time monitoring.

Compliance

PCI compliant?

Yes - PCI DSS Level 1, SOC 2 Type II, GDPR compliant.

Data collection?

Only necessary data:

Transaction details
Phone numbers (optional)
Technical data (IP, device)
No sensitive payment data

International usage?

Currently focused on Mauritania with regional expansion plans.

Account

Update account info?

Update business details, banking info, API keys, and webhooks through dashboard.

Multiple environments?

Yes - separate development, staging, and production environments with different API keys.

Close account?

Complete transactions, export data, contact support for closure.

Still have questions? Contact support@moosyl.com or check our documentation.

FAQ

On this page