Start integrating with Ciro Pay in minutes
Modern APIs and integrated tools to help you embed payments quickly and securely. From Sandbox to production in clear steps.
import CiroPay from '@ciro/pay-sdk';// تهيئة العميلconst client = new CiroPay({apiKey: process.env.CIRO_SECRET_KEY,env: 'production'});// إنشاء عملية دفعconst payment = await client.payments.create({amount: 12500, // بالهللةcurrency: 'SAR',source: req.body.token,description: 'طلب رقم 4529'});
Every API you need in one place
We've brought everything together — from integration to analytics, all in one platform.
Payment Processing Interface
Payment APIs
Authorize, capture, verify, and refund Saudi financial transactions end to end.
- Create payment requests
- Verify & cancel
- Mada & Visa card support
- 3DS Secure 2.0 support
Soft-POS
SoftPOS APIs
Read Tap-on-Phone cards on Android apps with full NFC SDK support.
- NFC reader integration
- EMV contactless flow
- Mastercard / Visa certified
- POS reporting
Analytics Interface
Analytics APIs
Extract sales data, settlements, installment balances, and accurate financial reports.
- Real-time revenue
- Settlement reports
- Branch performance tracking
Integrate with Your Favorite Language
Ready-made libraries for every popular environment — with interactive docs and real examples for every SDK.
TypeScript
SDK available
Go
SDK available
JavaScript
SDK available
Java
SDK available
Python
SDK available
Vue
SDK available
PHP
SDK available
React
SDK available
Start in a Few Lines
From sandbox to production, Ciro Pay provides all the tools and APIs you need to build a complete, scalable payment experience.
import ciropayimport osciropay.api_key = os.environ['CIRO_SECRET_KEY']ciropay.environment = 'sandbox'payment = ciropay.Payment.create(amount=12500,currency='SAR',source=request.json['token'],)
Professional Tools for Every Stage
From initial testing to production monitoring — the right tools at your fingertips.
API Explorer
Test any endpoint directly from the browser — send real requests, see responses, and understand how the API works.
Sandbox Environment
A fully isolated testing environment. Test cards for every scenario — success, decline, 3DS, expiry.
Request Inspector
A complete log of every request and response — headers, payload, response time, and HTTP code. Instant diagnosis.
Webhook Testing
Test Webhooks by sending instant test events to your endpoint — payment.captured, payment.failed, refund.created.
Everything You Need to Know
Comprehensive documentation and integrated developer tools to help you build and scale payment solutions fast — with practical examples and detailed guides for every step.
Video Tutorials
Lessons for building real integrations from scratch.
- ✓Create & process payments
- ✓Authorize & cancel
- ✓Partial & full refunds
- ✓3D Secure 2.0 support
payment.succeeded
Delivered • 0.8s ago
Guides & Walkthroughs
Step-by-step for every possible payment scenario.
- ✓Create & process payments
- ✓Authorize & cancel
- ✓Partial & full refunds
- ✓3D Secure 2.0 support
POST /v1/payments
200 OK • 118ms
API Reference
Complete docs for every endpoint with interactive examples.
- ✓Detailed docs for every endpoint
- ✓Ready-made request & response examples
- ✓Error codes & status handling
- ✓Full sandbox & production support
Sandbox API endpoint //
https://sandbox-api.ciropay.com
Webhooks
Full list of all events and payload structure.
- ✓Create & process payments
- ✓Authorize & cancel
- ✓Partial & full refunds
- ✓3D Secure 2.0 support
payment.completed
Delivered • 1.2s ago
SDK Docs
Full reference with changelog and upgrade instructions.
- ✓Create & process payments
- ✓Authorize & cancel
- ✓Partial & full refunds
- ✓3D Secure 2.0 support
JavaScript SDK
v3.4.2 • Latest
Sample Projects
Complete apps ready to clone and deploy.
- ✓Create & process payments
- ✓Authorize & cancel
- ✓Partial & full refunds
- ✓3D Secure 2.0 support
React Starter
Ready to Deploy
From Sign-up to First Payment
Five clear steps — from creating your account to receiving your first real transaction.
Create Your Account
Register your company details and get instant access to the dashboard and testing environment.
Company Name
Phone Number
Business Type
Publishable Key
Secret Key
Get Your API Keys
Generate test and production keys to manage secure communication between your system and Ciro Pay.
Use the Sandbox
Safely test payment flows using test data before going live.
200 OK payment.captured • 118ms
"status": "captured"
Test Your Integration
Verify requests succeed, Webhooks are received, and transaction states are handled correctly.
Go Live
Switch to production and start accepting real payments from your customers across multiple channels.
Live Payment
SAR 450.00
✓ Completed
Secure by Design
Every integration layer is built to protect your customers and minimize your legal liability.
PCI DSS Scope Zero
Never touch raw card data — full Tokenization. Completely out of PCI scope.
Webhook Signing
Every Webhook carries HMAC-SHA256. Verify it before processing.
TLS 1.3 Encryption
All connections are encrypted. Older versions are rejected automatically.
Dual-Key Auth
Publishable Key for the browser. Secret for the server only. Never exposed to the client.
const crypto = require('crypto');function verifyWebhook(payload, signature, secret) {const computed = crypto.createHmac('sha256', secret).update(payload).digest('hex');return crypto.timingSafeEqual(Buffer.from(computed),Buffer.from(signature));}app.post('/webhook', (req, res) => {const sig = req.headers['ciro-signature'];if (!verifyWebhook(req.rawBody, sig, process.env.WEBHOOK_SECRET))return res.status(400).send('Invalid signature');// عالج الحدث...});
Make your first payment in minutes
Get your API keys now and start integrating in Sandbox for free — no credit card required.
- Free Sandbox instantly
- PCI DSS Level 1
- 99.9% Uptime