Polling (Banque → Connecteur)

​

A. Principe fondamental du polling

• Le polling est basé sur un curseur temporel
• L’offset N’EST PAS un index, mais une date d’initiation (beforeAt)
• La Banque contrôle entièrement la progression du curseur
• La Banque garantit l’idempotence métier

Ce mécanisme est robuste face aux changements de statut asynchrones.

​

B. Endpoint de requête d’ordres (côté Connecteur)

GET /payment-orders

​

En-têtes requis

​

Paramètres de requête (Query Params)

​

Exemple

GET /payment-orders?status=READY&limit=50&offset=2025-11-19T06:00:00Z

​

C. Réponse du Connecteur

{

  "offset": "2025-11-19T06:00:00Z",
  "limit": 50,
  "size": 50,
  "total_elements": 142,
  "content": [
    {
      "reference": "PAY-2025-0001",
      "initiated_at": "2025-11-19T06:05:00Z",
      "reason": "Paiement frais scolaires",
      "type": "DIRECT_DEBIT",
      "debtor": {
        "name": "Jean Dupont",
        "iban": "CM123..."
      },
      "creditors": [
        {
          "name": "École ABC",
          "iban": "CM456...",
          "bank_code": "BANK01",
          "amount": "15000.00",
          "reason": "Tranche 1"
        }
      ],
      "total_amount": "15000.00",
      "currency": "XAF",
      "metadata": {
        "initiator": "school-portal"
      }
    }
  ]
}

​

D. Gestion de l’offset (Responsabilité Banque)

• GÈRE elle-même la valeur de l’offset
• Met à jour l’offset avec :
  • la **plus grande valeur de **initiated_attraitée
• Garantit :
  • la non-redemande
  • la déduplication
  • l’idempotence métier

Le Connecteur ne stocke aucun état de consommation.

​

E. Callback Push OBLIGATOIRE en mode polling

​

Règle contractuelle

Le Callback Push (Banque → Connecteur) est OBLIGATOIRE lorsque le polling est utilisé.

​

Justification

• Le Connecteur ne sait pas :
  • quand l’ordre est traité
  • s’il a échoué ou réussi
• Seule la Banque est source de vérité du résultat final

• l’ordre reste indéfiniment en statut READY ou PENDING
• l’intégration est considérée comme non conforme

​

F. Exemple de requêtes de pulling

​

cURL

curl -X GET "https://connector.example.com/dhi/payment-orders?status=READY&limit=50&offset=2025-11-19T06:00:00Z" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Timestamp: 2025-11-19T07:05:00Z" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000" \
  -H "X-Signature: <signature>"