Integrations
Overview
BayanCore integrates with external Saudi government systems, payment providers, and banking APIs.
Government Integrations
ZATCA Fatoora
- Purpose: E-invoicing clearance and reporting
- Protocol: REST API with XML payloads
- Authentication: CSID certificates
- Endpoints: Clearance (B2B), Reporting (B2C)
GOSI
- Purpose: Social insurance contributions and filing
- Protocol: Web portal / API
- Frequency: Monthly payroll submissions
WPS (Wage Protection System)
- Purpose: Salary disbursement verification
- Protocol: Bank file transfer (SIF format)
- Frequency: Monthly payroll
Payment Integrations
Payment Gateways
- Providers: Moyasar, PayTabs, Checkout.com
- Features: Card payments, Apple Pay, STC Pay
- Webhooks: Payment status notifications
Banking APIs
- Providers: Saudi banks (Al Rajhi, SNB, Riyad Bank)
- Protocol: ISO 20022 / Open Banking
- Features: Account verification, transfers, reconciliation
Third-Party Services
Authentication
- Provider: Clerk
- Features: SSO, RBAC, session management
Communication
- Email: Transactional email service
- SMS: OTP and notifications
- WhatsApp: Business messaging for alerts
Integration Patterns
- Webhooks: Event-driven notifications
- Polling: Scheduled data sync
- Batch: Bulk data transfers
- Real-time: Streaming updates