Skip to main content

​
Overview

The Modulus Labs QR API enables you to create Dynamic QR Ph payments for Consumer Scans Business transactions. With this API, your customers can simply scan a generated QR code and complete transactions using their preferred online banking app.

Quick Start

Get up and running in minutes

API Reference

Explore all available endpoints

Authentication

Learn how to authenticate your requests

Testing

Test your integration in sandbox

​
API Endpoint

All API requests should be made to the sandbox environment: 
https://qrph.sbx.moduluslabs.io
This is the sandbox environment URL. You’ll receive production credentials and URL separately from Modulus Labs when you’re ready to go live.

​
API Philosophy

The Modulus Labs QR API is designed with security and simplicity in mind:

REST Architecture

Predictable resource-oriented URLs with standard HTTP methods

JSON Format

All requests and responses use JSON

HTTPS Only

All API requests must be made over HTTPS

Basic Auth

Simple HTTP Basic Authentication with Secret Keys

JWE Encryption

End-to-end payload encryption for maximum security

Webhooks

Real-time notifications for payment events

PCI DSS 4.1 Certified

Modulus Labs is PCI DSS 4.1 compliant, ensuring the highest standards of payment security and data protection

​
How It Works

1

Obtain Credentials

Modulus Labs will provide you with:
  • Secret Key: For authentication
  • Encryption Key: For JWE token encryption
  • Activation Code: Assigned to your sub-merchant account
2

Create QR Code

Make an API call to generate a Dynamic QR Ph with payment details (amount, currency, reference).
3

Customer Scans

Display the QR code to your customer. They scan it with their banking app.
4

Receive Webhook

Get real-time notifications when the payment is completed or fails.

​
Key Features

​
Dynamic QR Ph Payments

Create unique QR codes for each transaction with specific amounts and merchant references.

​
Secure Encryption

All sensitive payload data is encrypted using JWE (JSON Web Encryption) with:
  • A256CBC-HS512 content encryption algorithm
  • A256KW key wrap algorithm

​
Real-time Webhooks

Get instant notifications about payment status changes through our webhook system.

​
Comprehensive Error Handling

Clear error codes (10000001-10000015) and descriptive messages help you quickly identify and resolve issues.

​
Sandbox Environment

Fully functional testing environment that mirrors production behavior without processing real payments.

​
Use Cases

Add QR Ph as a payment option at checkout. Perfect for online stores wanting to accept real-time bank transfers.
Display QR codes on POS terminals or kiosks for contactless payments in physical locations.

​
What’s Next?

Quickstart Guide

Follow our step-by-step guide to make your first API call

Authentication

Learn how HTTP Basic Auth works with Secret Keys

Encryption Guide

Understand JWE token encryption for secure payloads

Contact Support

Get help from our technical team
Ready to start building? Head to the Quickstart Guide to make your first API call in minutes.