إنتقل إلى المحتوى الرئيسي

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