Paiement par QR code

En plus du lien de paiement, Djonanko peut générer un QR code de paiement que vos clients scannent avec l’appareil photo de leur téléphone — sans application à installer. Le scan ouvre directement la page de paiement, où le client choisit son opérateur et confirme. C’est le mode idéal quand il n’y a pas de redirection web possible :

Facture ou devis : imprimez le QR code sur le document, le client règle en le scannant.
Point de vente : affichez-le sur un écran de caisse ou une étiquette.
Affiche, flyer, menu : encaissez sans site web.

Générer un QR code

C’est le même endpoint que pour un lien de paiement, POST /web-merchant/create-web-payment-link. La seule différence : passez isQrCode: true dans le payload. La réponse contient alors une image PNG encodée en data URL (qrcode) au lieu de paymentUrl.

curl -X POST https://apidjonanko.tech/web-merchant/create-web-payment-link \
  -H "Content-Type: application/json" \
  -H "x-api-key: $DJONANKO_API_KEY" \
  -H "x-api-secret: $DJONANKO_API_SECRET" \
  -d '{
    "amount": 2500,
    "merchant_reference": "beautyshop",
    "isQrCode": true,
    "return_url": "https://example.com/merci",
    "cancel_url": "https://example.com/echec",
    "metadata": { "order_id": "TICKET-0091" }
  }'

{
  "success": true,
  "paymentLink": {
    "id": "50f668cf-2a84-41e7-9bcb-6874b0d5d286",
    "message": "Payment link created successfully",
    "qrcode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA…",
    "reference": "PAYR9PVUYEWVF"
  }
}

Afficher le QR code

HTML
React
Impression / PDF

La data URL se place directement dans un attribut src :

<img src="data:image/png;base64,iVBORw0KGgo…" alt="Scannez pour payer 2 500 FCFA" width="256" />

function PayQr({ qrcode, amount }) {
  return (
    <figure>
      <img src={qrcode} alt={`Scannez pour payer ${amount} FCFA`} width={256} />
      <figcaption>Scannez avec l'appareil photo de votre téléphone</figcaption>
    </figure>
  );
}

Décodez le base64 pour obtenir le fichier PNG :

const base64 = qrcode.replace(/^data:image\/png;base64,/, "");
fs.writeFileSync(`qr-${reference}.png`, Buffer.from(base64, "base64"));

import base64
data = qrcode.split(",", 1)[1]
with open(f"qr-{reference}.png", "wb") as f:
    f.write(base64.b64decode(data))

Ce que contient le QR code

Le QR code encode l’URL https://checkout.djonanko.ci/{reference}. Le client qui le scanne arrive sur la même page de paiement que via un lien : le parcours, les statuts et les webhooks sont identiques.

Vous pouvez donc générer un lien classique et fabriquer votre propre QR code avec la librairie de votre choix, si vous voulez le personnaliser (logo, couleurs). Le comportement sera le même.

Suivre le paiement en point de vente

Un QR code affiché sur un écran de caisse doit indiquer en temps réel quand le paiement est reçu. Deux approches :

Webhook (recommandé) : votre serveur reçoit SUCCESS et pousse l’information à la caisse (WebSocket, SSE, polling interne).
Polling : la caisse interroge GET /web-merchant/payment/status toutes les 3 à 5 secondes jusqu’à un statut final.

async function waitForPayment(reference, token, { intervalMs = 4000, timeoutMs = 300000 } = {}) {
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const res = await fetch(
      `https://apidjonanko.tech/web-merchant/payment/status?payment_reference=${reference}`,
      { headers: { authenticationtoken: token } }
    );
    const { status } = await res.json();
    if (status !== "PENDING") return status; // SUCCESS ou FAILED
    await new Promise((r) => setTimeout(r, intervalMs));
  }
  return "TIMEOUT";
}

Durée de validité

Comme un lien, un QR code expire 24 heures après sa création. Pour une affiche permanente, générez un nouveau QR code à chaque commande plutôt qu’un QR code statique.

Premiers pas

Guides d'intégration

Dashboard marchand

Générer un QR code

Afficher le QR code

Ce que contient le QR code

Suivre le paiement en point de vente

Durée de validité

​Générer un QR code

​Afficher le QR code

​Ce que contient le QR code

​Suivre le paiement en point de vente

​Durée de validité

Générer un QR code

Afficher le QR code

Ce que contient le QR code

Suivre le paiement en point de vente

Durée de validité