curl --request POST \
--url https://api.oneclickdz.com/v3/ocpay/createLink \
--header 'Content-Type: application/json' \
--header 'X-Access-Token: YOUR_API_KEY' \
--data '{
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345"
}'
const response = await fetch("https://api.oneclickdz.com/v3/ocpay/createLink", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Access-Token": "YOUR_API_KEY",
},
body: JSON.stringify({
productInfo: {
title: "Premium Subscription",
description: "Monthly access to premium features",
amount: 5000,
},
feeMode: "NO_FEE",
successMessage: "Thank you for your purchase!",
redirectUrl: "https://yourstore.com/success?orderId=12345",
}),
});
const data = await response.json();
console.log("Payment URL:", data.data.paymentUrl);
console.log("Payment Ref:", data.data.paymentRef);
import requests
url = "https://api.oneclickdz.com/v3/ocpay/createLink"
headers = {
"Content-Type": "application/json",
"X-Access-Token": "YOUR_API_KEY"
}
payload = {
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345"
}
response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(f"Payment URL: {data['data']['paymentUrl']}")
print(f"Payment Ref: {data['data']['paymentRef']}")
<?php
$url = 'https://api.oneclickdz.com/v3/ocpay/createLink';
$headers = [
'Content-Type: application/json',
'X-Access-Token: YOUR_API_KEY'
];
$payload = [
'productInfo' => [
'title' => 'Premium Subscription',
'description' => 'Monthly access to premium features',
'amount' => 5000
],
'feeMode' => 'NO_FEE',
'successMessage' => 'Thank you for your purchase!',
'redirectUrl' => 'https://yourstore.com/success?orderId=12345'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "Payment URL: " . $data['data']['paymentUrl'] . "\n";
echo "Payment Ref: " . $data['data']['paymentRef'] . "\n";
?>
{
"success": true,
"data": {
"paymentLink": {
"uid": "user_123456789",
"ref": "OCPL-A1B2C3-D4E5",
"isSandbox": false,
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345",
"time": "2025-01-15T10:30:00Z"
},
"paymentUrl": "https://pay.ocdz.link/pay/OCPL-A1B2C3-D4E5",
"paymentRef": "OCPL-A1B2C3-D4E5"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"requestId": "req_abc123xyz"
}
}
Navio
Créer un Lien de Paiement
Crée un nouveau lien de paiement à usage unique pour le système de paiement OneClick (Navio)
POST
/
v3
/
ocpay
/
createLink
curl --request POST \
--url https://api.oneclickdz.com/v3/ocpay/createLink \
--header 'Content-Type: application/json' \
--header 'X-Access-Token: YOUR_API_KEY' \
--data '{
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345"
}'
const response = await fetch("https://api.oneclickdz.com/v3/ocpay/createLink", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Access-Token": "YOUR_API_KEY",
},
body: JSON.stringify({
productInfo: {
title: "Premium Subscription",
description: "Monthly access to premium features",
amount: 5000,
},
feeMode: "NO_FEE",
successMessage: "Thank you for your purchase!",
redirectUrl: "https://yourstore.com/success?orderId=12345",
}),
});
const data = await response.json();
console.log("Payment URL:", data.data.paymentUrl);
console.log("Payment Ref:", data.data.paymentRef);
import requests
url = "https://api.oneclickdz.com/v3/ocpay/createLink"
headers = {
"Content-Type": "application/json",
"X-Access-Token": "YOUR_API_KEY"
}
payload = {
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345"
}
response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(f"Payment URL: {data['data']['paymentUrl']}")
print(f"Payment Ref: {data['data']['paymentRef']}")
<?php
$url = 'https://api.oneclickdz.com/v3/ocpay/createLink';
$headers = [
'Content-Type: application/json',
'X-Access-Token: YOUR_API_KEY'
];
$payload = [
'productInfo' => [
'title' => 'Premium Subscription',
'description' => 'Monthly access to premium features',
'amount' => 5000
],
'feeMode' => 'NO_FEE',
'successMessage' => 'Thank you for your purchase!',
'redirectUrl' => 'https://yourstore.com/success?orderId=12345'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "Payment URL: " . $data['data']['paymentUrl'] . "\n";
echo "Payment Ref: " . $data['data']['paymentRef'] . "\n";
?>
{
"success": true,
"data": {
"paymentLink": {
"uid": "user_123456789",
"ref": "OCPL-A1B2C3-D4E5",
"isSandbox": false,
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345",
"time": "2025-01-15T10:30:00Z"
},
"paymentUrl": "https://pay.ocdz.link/pay/OCPL-A1B2C3-D4E5",
"paymentRef": "OCPL-A1B2C3-D4E5"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"requestId": "req_abc123xyz"
}
}
Vue d’ensemble
Créez un lien de paiement sécurisé et à usage unique avec des paramètres personnalisables. Idéal pour les commandes e-commerce, les paiements de services et les renouvellements d’abonnements.Validation marchande requise : Complétez la validation marchande sur https://app.oneclickdz.com/profile avant d’utiliser cet endpoint.
Corps de la requête
object
requis
Détails du produit ou du service à payer
Afficher propriétés de productInfo
Afficher propriétés de productInfo
string
requis
Nom du produit/service (1 à 200 caractères) Exemples : -
"Premium Subscription" - "Web Design Services" - "Online Course Access"string
Description détaillée (max 1000 caractères). Prend en charge le markdown.
number
requis
Montant du paiement en DZD (500 - 500 000) Exemples :
5000, 15000, 50000string
défaut:"NO_FEE"
Détermine qui paie les frais de retrait -
NO_FEE - Le marchand paie tous les frais (par défaut) - SPLIT_FEE - Frais partagés 50/50 - CUSTOMER_FEE - Le client paie tous les fraisstring
Message de succès personnalisé (max 500 caractères) affiché après le paiement
string
URL de redirection après un paiement réussi (doit être un HTTP/HTTPS valide)
Réponse
boolean
Indique si l’opération a réussi
object
Détails du lien de paiement
Afficher propriétés de data
Afficher propriétés de data
object
Informations complètes du lien de paiement
Afficher propriétés de paymentLink
Afficher propriétés de paymentLink
string
Identifiant unique du marchand
string
Code de référence du paiement (format :
OCPL-XXXXXX-YYYY)boolean
Si c’est un lien de paiement de test
object
Informations du produit telles que soumises
string
Mode de configuration des frais
string
Message de succès personnalisé
string
URL de redirection après paiement
string
Horodatage de création du lien (ISO 8601)
string
URL complète à partager avec les clients pour le paiement
string
Code de référence du paiement - SAUVEGARDEZ-LE pour le suivi des paiements
object
Fonctionnalités clés
Flexibilité des frais
Choisissez qui paie les frais de transaction - marchand, client ou partagé
Marque personnalisée
Messages de succès personnalisés et URL de redirection
Tests en sandbox
Testez votre intégration en toute sécurité avant la mise en production
Sécurité à usage unique
Chaque lien est à usage unique pour une sécurité renforcée
Notes importantes
Limites de montant : - Minimum : 500 DZD - Maximum : 500 000 DZD - Doit être un nombre entier (pas de décimales)
Structure des frais : - 0% si utilisation du solde OneClick - 1% de frais de retrait uniquement (configurable par transaction)
Expiration du lien : Les liens de paiement expirent 20 minutes après la création si le paiement n’est pas initié
curl --request POST \
--url https://api.oneclickdz.com/v3/ocpay/createLink \
--header 'Content-Type: application/json' \
--header 'X-Access-Token: YOUR_API_KEY' \
--data '{
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345"
}'
const response = await fetch("https://api.oneclickdz.com/v3/ocpay/createLink", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Access-Token": "YOUR_API_KEY",
},
body: JSON.stringify({
productInfo: {
title: "Premium Subscription",
description: "Monthly access to premium features",
amount: 5000,
},
feeMode: "NO_FEE",
successMessage: "Thank you for your purchase!",
redirectUrl: "https://yourstore.com/success?orderId=12345",
}),
});
const data = await response.json();
console.log("Payment URL:", data.data.paymentUrl);
console.log("Payment Ref:", data.data.paymentRef);
import requests
url = "https://api.oneclickdz.com/v3/ocpay/createLink"
headers = {
"Content-Type": "application/json",
"X-Access-Token": "YOUR_API_KEY"
}
payload = {
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345"
}
response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(f"Payment URL: {data['data']['paymentUrl']}")
print(f"Payment Ref: {data['data']['paymentRef']}")
<?php
$url = 'https://api.oneclickdz.com/v3/ocpay/createLink';
$headers = [
'Content-Type: application/json',
'X-Access-Token: YOUR_API_KEY'
];
$payload = [
'productInfo' => [
'title' => 'Premium Subscription',
'description' => 'Monthly access to premium features',
'amount' => 5000
],
'feeMode' => 'NO_FEE',
'successMessage' => 'Thank you for your purchase!',
'redirectUrl' => 'https://yourstore.com/success?orderId=12345'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "Payment URL: " . $data['data']['paymentUrl'] . "\n";
echo "Payment Ref: " . $data['data']['paymentRef'] . "\n";
?>
{
"success": true,
"data": {
"paymentLink": {
"uid": "user_123456789",
"ref": "OCPL-A1B2C3-D4E5",
"isSandbox": false,
"productInfo": {
"title": "Premium Subscription",
"description": "Monthly access to premium features",
"amount": 5000
},
"feeMode": "NO_FEE",
"successMessage": "Thank you for your purchase!",
"redirectUrl": "https://yourstore.com/success?orderId=12345",
"time": "2025-01-15T10:30:00Z"
},
"paymentUrl": "https://pay.ocdz.link/pay/OCPL-A1B2C3-D4E5",
"paymentRef": "OCPL-A1B2C3-D4E5"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"requestId": "req_abc123xyz"
}
}
Étapes suivantes
Vérifier le statut du paiement
Apprendre à vérifier le statut du paiement
Guide d'intégration
Guide complet d’intégration Navio
⌘I

