Skip to main content
POST

Overview

Create a secure, single-use payment link with customizable settings. Perfect for e-commerce orders, service payments, and subscription renewals.
Merchant Validation Required: Complete merchant validation at https://app.oneclickdz.com/profile before using this endpoint.

Request Body

productInfo
object
required
Product or service details being paid for
feeMode
string
default:"NO_FEE"
Determines who pays withdrawal fees - NO_FEE - Merchant pays all fees (default) - SPLIT_FEE - Fees split 50/50 - CUSTOMER_FEE - Customer pays all fees
successMessage
string
Custom success message (max 500 characters) shown after payment Example: "Thank you for your purchase! Your order is being processed."
redirectUrl
string
Redirect URL after successful payment (must be valid HTTP/HTTPS) Example: "https://yourstore.com/order-check?orderId=12345"

Response

success
boolean
Indicates if the operation was successful
data
object
Payment link details
meta
object
Response metadata

Key Features

Fee Flexibility

Choose who pays transaction fees - merchant, customer, or split

Custom Branding

Personalized success messages and redirect URLs

Sandbox Testing

Test integration safely before going live

Single-Use Security

Each link is single-use for enhanced security

Important Notes

Amount Limits: - Minimum: 500 DZD - Maximum: 500,000 DZD - Must be whole numbers (no decimals)
Fee Structure: - 0% if using OneClick balance - 1% withdrawal fee only (configurable per transaction)
Link Expiration: Payment links expire 20 minutes after creation if payment is not initiated

Next Steps

Check Payment Status

Learn how to check payment status

Integration Guide

Complete Navio integration guide