Skip to main content

Welcome to Modulus Labs

Modulus Labs provides payment infrastructure for businesses in the Philippines. Our suite of APIs enables you to accept QR Ph payments, onboard merchants, and receive real-time transaction notifications.

Security & Compliance

PCI DSS 4.1 Certified - Modulus Labs maintains PCI DSS 4.1 compliance, ensuring the highest standards of payment security and data protection for all transactions processed through our APIs.

QR API

Accept QR Ph payments from your customers using Dynamic QR codes. The QR API enables Consumer Scans Business (C2B) transactions where customers scan QR codes using their banking apps to complete payments. Key Features:
  • Generate Dynamic QR Ph codes with specific amounts and references
  • Support for multiple currencies (PHP, USD, etc.)
  • JWE-encrypted payloads for maximum security
  • Real-time webhook notifications for payment status
  • Comprehensive error handling
  • Full sandbox environment for testing
Use Cases:
  • E-commerce checkout payments
  • In-store point-of-sale transactions

Onboarding API

Streamline merchant onboarding with our KYC (Know Your Customer) API. Enable businesses to accept various payment methods including QR Ph, PayMaya, GCash, and more through a single integration. Key Features:
  • Complete merchant onboarding workflow
  • Support for multiple payment methods (QR Ph, PayMaya, GCash, Cards)
  • Document upload and verification
  • Business information collection
  • JWT-based authentication
Use Cases:
  • Payment service provider platforms
  • Multi-merchant marketplaces
  • Financial technology applications
  • Business management platforms

Webhooks API

Receive real-time notifications when QR Ph transactions complete. Webhooks push transaction updates directly to your server, enabling instant order fulfillment and payment verification. Key Features:
  • Real-time transaction notifications
  • JWE-encrypted payloads for security
  • Automatic retry mechanism (up to 4 attempts)
  • Support for success and declined events
  • HTTP Basic Authentication
  • Multi-merchant support with activation codes
Webhooks are REQUIRED for QR Ph integration. Without webhooks, you cannot receive transaction status updates.
Use Cases:
  • Order fulfillment automation
  • Payment confirmation emails
  • Transaction reconciliation
  • Real-time dashboard updates
  • Customer notification systems

Authentication

Each API uses different authentication methods:
APIAuthentication MethodHeader Format
QR APIHTTP Basic AuthAuthorization: Basic {credentials}
Onboarding APIJWT Bearer TokenAuthorization: Bearer {token}
Webhooks APIHTTP Basic AuthAuthorization: Basic {credentials}

Environments

All APIs are currently available in sandbox mode for testing:
APISandbox URL
QR APIhttps://qrph.sbx.moduluslabs.io
Onboarding APIhttps://kyc.sbx.moduluslabs.io
Webhooks APIhttps://webhooks.sbx.moduluslabs.io

Getting Started

Choose your integration path:
1

Accept QR Payments

Start with the QR API introduction to accept QR Ph payments from customers. Set up webhooks to receive real-time notifications.
2

Onboard Merchants

Use the Onboarding API to enable merchants to accept various payment methods through your platform.
3

Build a Complete Platform

Combine all three APIs to create a comprehensive payment solution: onboard merchants, accept QR payments, and receive real-time notifications via webhooks.
New to our APIs? Start with the QR API quickstart guide to make your first API call in minutes, then explore webhooks for real-time notifications.

Support

For technical support and questions:
  • Email: [email protected]
  • Documentation feedback: Use the feedback buttons on each page
  • Technical issues: Include API endpoint, request/response details, and error codes