Documentation Index
Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
Use this file to discover all available pages before exploring further.
Bienvenue sur Navio
OneClick Payment (Navio) vous permet d’accepter des paiements en ligne sécurisés en Algérie avec un minimum d’effort d’intégration. Créez des liens de paiement, suivez les transactions et gérez vos fonds - le tout via notre API simple.Configuration rapide
Démarrez en quelques minutes avec notre API simple
Paiements sécurisés
Sécurité bancaire propulsée par SATIM
Suivi en temps réel
Surveillez le statut des paiements en temps réel
Frais flexibles
Choisissez qui paie les frais de transaction
Ce que vous allez construire
En suivant ce guide, vous implémenterez un flux de paiement complet :- Le client crée une commande dans votre application
- Votre système génère un lien de paiement via l’API Navio
- Le client complète le paiement sur la page de paiement sécurisée
- Votre système suit le statut du paiement et traite la commande
Prérequis
Compte OneClick
Créez un compte sur app.oneclickdz.com
Validation marchand
Effectuez la validation marchand sur Navio Merchant
Info
Comment ça fonctionne
- Le client passe une commande → Vous la sauvegardez comme
PENDING - Vous appelez
/v3/ocpay/createLink→ ObtenezpaymentUrletpaymentRef - Sauvegardez
paymentRefavec votre commande (important !) - Redirigez le client vers
paymentUrl - Le client paie → Retourne sur votre site
- Vous vérifiez le statut avec
/v3/ocpay/checkPayment/:ref - Mettez à jour la commande si le statut est
CONFIRMED
Concepts clés
Référence de paiement (paymentRef)
Référence de paiement (paymentRef)
Identifiant unique pour chaque paiement (format :
OCPL-XXXXXX-YYYY). Sauvegardez-le avec votre commande pour vérifier le statut ultérieurement.Expiration du lien de paiement
Expiration du lien de paiement
Les liens expirent après 20 minutes. Créez un nouveau lien si le client doit réessayer.
Vérification du statut
Vérification du statut
Vérifiez le statut du paiement lorsque le client revient sur votre site ou lorsque votre tâche cron s’exécute toutes les 20 minutes.
Structure des frais
Frais réduits : 0% en conservant le solde sur OneClick, seulement 1% au retrait
| Mode de frais | Description | Cas d’usage |
|---|---|---|
NO_FEE | Vous absorbez tous les frais | Meilleure expérience client |
SPLIT_FEE | Partage 50/50 | Responsabilité partagée |
CUSTOMER_FEE | Le client paie tous les frais | Maximisez votre profit |
Étapes d’intégration
Suivez ces guides dans l’ordre :1. Configuration marchand
Complétez la validation marchand et obtenez votre clé API
2. Flux de paiement
Implémentez l’intégration de paiement complète
3. Suivi du statut
Suivez les paiements et mettez à jour le statut des commandes
4. Bonnes pratiques
Conseils pour la production et gestion des erreurs
Démarrage rapide
Support et ressources
Référence API
Documentation API détaillée
Contacter le support
Obtenez l’aide de notre équipe
Tableau de bord
Gérez votre compte
Guide de sécurité
Sécurisez votre intégration
Prochaine étape : Configuration marchand
Prêt à commencer ? Démarrez par la validation marchand :Démarrer l'intégration
Complétez la configuration et la validation marchand

