Passer au contenu principal

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 :
  1. Le client crée une commande dans votre application
  2. Votre système génère un lien de paiement via l’API Navio
  3. Le client complète le paiement sur la page de paiement sécurisée
  4. Votre système suit le statut du paiement et traite la commande

Prérequis

1

Compte OneClick

Créez un compte sur app.oneclickdz.com
2

Validation marchand

Effectuez la validation marchand sur Navio Merchant Info
Cette étape est obligatoire avant de pouvoir créer des liens de paiement
3

Clé API

Obtenez votre clé API depuis le tableau de bord (utilisez la clé Sandbox pour les tests)
4

Prérequis techniques

  • Serveur backend pour gérer les appels API - Base de données pour stocker les commandes et références de paiement - Compréhension de base des API REST

Comment ça fonctionne

  1. Le client passe une commande → Vous la sauvegardez comme PENDING
  2. Vous appelez /v3/ocpay/createLink → Obtenez paymentUrl et paymentRef
  3. Sauvegardez paymentRef avec votre commande (important !)
  4. Redirigez le client vers paymentUrl
  5. Le client paie → Retourne sur votre site
  6. Vous vérifiez le statut avec /v3/ocpay/checkPayment/:ref
  7. Mettez à jour la commande si le statut est CONFIRMED

Concepts clés

Identifiant unique pour chaque paiement (format : OCPL-XXXXXX-YYYY). Sauvegardez-le avec votre commande pour vérifier le statut ultérieurement.
Les liens expirent après 20 minutes. Créez un nouveau lien si le client doit réessayer.
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
Vous pouvez choisir qui paie les frais de retrait :
Mode de fraisDescriptionCas d’usage
NO_FEEVous absorbez tous les fraisMeilleure expérience client
SPLIT_FEEPartage 50/50Responsabilité partagée
CUSTOMER_FEELe client paie tous les fraisMaximisez 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

const fetch = require("node-fetch");

// Créer un lien de paiement
async function createPayment(orderId, amount, title) {
  const response = await fetch(
    "https://api.oneclickdz.com/v3/ocpay/createLink",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Access-Token": process.env.ONECLICK_API_KEY,
      },
      body: JSON.stringify({
        productInfo: { title, amount },
        redirectUrl: `https://yoursite.com/orders/${orderId}`,
      }),
    }
  );

  const data = await response.json();

  // Sauvegardez paymentRef avec votre commande !
  await db.orders.update(orderId, {
    paymentRef: data.data.paymentRef,
  });

  return data.data.paymentUrl; // Redirigez le client ici
}

// Check payment status
async function checkPayment(paymentRef) {
  const response = await fetch(
    `https://api.oneclickdz.com/v3/ocpay/checkPayment/${paymentRef}`,
    { headers: { "X-Access-Token": process.env.ONECLICK_API_KEY } }
  );

  const data = await response.json();
  return data.data.status; // PENDING, CONFIRMED, ou FAILED
}

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