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.
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, 50000
string
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 frais
string
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
object
Informations complètes du lien de paiement
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
Métadonnées de la réponse
Afficher propriétés de meta
string
Horodatage de la réponse (ISO 8601)
string
ID unique de la requête pour le support
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);