Welcome to OCPay
OneClick Payment (OCPay) enables you to accept secure online payments in Algeria with minimal integration effort. Create payment links, track transactions, and manage your funds - all through our simple API.Quick Setup
Get started in minutes with our straightforward API
Secure Payments
Bank-grade security powered by SATIM
Real-time Tracking
Monitor payment status in real-time
Flexible Fees
Choose who pays transaction fees
What You’ll Build
By following this guide, you’ll implement a complete payment flow:- Customer creates an order in your application
- Your system generates a payment link via OCPay API
- Customer completes payment on secure payment page
- Your system tracks payment status and fulfills the order
Prerequisites
1
OneClick Account
Create an account at oneclickdz.com
2
Merchant Validation
Complete merchant validation at OCPay Merchant
Info
This step is required before you can create payment links
3
API Key
Get your API key from the dashboard (use Sandbox key for testing)
4
Technical Requirements
- Backend server to handle API calls - Database to store order and payment references - Basic understanding of REST APIs
How It Works
- Customer places order → You save it as
PENDING - You call
/v3/ocpay/createLink→ GetpaymentUrlandpaymentRef - Save
paymentRefwith your order (important!) - Redirect customer to
paymentUrl - Customer pays → Returns to your site
- You check status with
/v3/ocpay/checkPayment/:ref - Update order and fulfill if
CONFIRMED
Key Concepts
Payment Reference (paymentRef)
Payment Reference (paymentRef)
Unique identifier for each payment (format:
OCPL-XXXXXX-YYYY). Save this with your order to check status later.Payment Link Expiration
Payment Link Expiration
Links expire after 20 minutes. Create a new link if customer needs to retry.
Status Checking
Status Checking
Check payment status when customer returns to your site or when your cron job runs every 20 minutes.
Fee Structure
Low Fees: 0% when keeping balance in OneClick, only 1% on withdrawal
| Fee Mode | Description | Use Case |
|---|---|---|
NO_FEE | You absorb all fees | Best customer experience |
SPLIT_FEE | 50/50 split | Shared responsibility |
CUSTOMER_FEE | Customer pays all fees | Maximize your profit |
Integration Steps
Follow these guides in order:1. Merchant Setup
Complete merchant validation and get your API key
2. Payment Flow
Implement the complete payment integration
3. Status Polling
Track payments and update order status
4. Best Practices
Production-ready tips and error handling
Quick Start
Support & Resources
API Reference
Detailed API documentation
Contact Support
Get help from our team
Dashboard
Manage your account
Security Guide
Keep your integration secure
Next: Merchant Setup
Ready to start? Begin with merchant validation:Start Integration
Complete merchant setup and validation

