Reçus et rapprochement - OneClickDz Flexy API

Reçu

Dès qu’une transaction est SUCCESS, son receiptUrl pointe vers GET /v3/bills/transactions/{transactionId}/receipt. La réponse est le fichier lui-même, pas une enveloppe JSON.

curl https://api.oneclickdz.com/v3/bills/transactions/68cdf0a2b7c1e4d5f6a7b8c9/receipt \
  -H "X-Access-Token: YOUR_API_KEY" \
  --output receipt.pdf

En-tête	Valeur
`Content-Type`	`application/pdf`, `image/png` ou `image/jpeg`
`Content-Disposition`	`attachment; filename="…"`
`Cache-Control`	`private, max-age=86400`

Lisez Content-Type pour choisir l’extension du fichier. Les reçus sandbox sont des images PNG. Les erreurs conservent l’enveloppe JSON : 404 NOT_FOUND lorsque la transaction ne vous appartient pas, n’est pas SUCCESS ou n’a pas de reçu. Conservez le fichier avec operationId et transactionId. Remettez le reçu à votre client, pas seulement un message de confirmation.

Avis de paiement AADL

Pour les transactions AADL, GET /v3/bills/transactions/{transactionId}/avis renvoie l’avis de paiement du facturier au format PDF. Il est disponible dès que la découverte est READY, ce qui vous permet d’afficher l’avis avant que le client ne paie.

curl https://api.oneclickdz.com/v3/bills/transactions/68cdf0a2b7c1e4d5f6a7b8c9/avis \
  -H "X-Access-Token: YOUR_API_KEY" \
  --output avis.pdf

404 NOT_FOUND pour tout autre facturier, pour une transaction inconnue, ou tant que l’avis n’est pas encore disponible.

Historique

GET /v3/bills/transactions liste vos transactions, les plus récentes en premier, limitées à l’environnement de votre clé.

Paramètre	Description
`status`	Un statut : `PENDING`, `READY`, `PROCESSING`, `UNKNOWN`, `SUCCESS`, `FAILED`, `REFUNDED`
`partner`	Un nom de partenaire
`from`, `to`	Bornes ISO 8601 sur `createdAt`
`limit`	1 à 100, 20 par défaut
`offset`	0 par défaut

curl "https://api.oneclickdz.com/v3/bills/transactions?status=SUCCESS&from=2026-09-20T00:00:00Z&to=2026-09-21T00:00:00Z&limit=100" \
  -H "X-Access-Token: YOUR_API_KEY"

meta contient total, limit et offset pour la pagination.

Chaque ligne porte les mêmes champs que GET /v3/bills/transactions/{transactionId}, y compris bills, selectedBills et error.

Rapprochement quotidien

Listez les transactions de la veille avec status=SUCCESS, en paginant avec offset.
Rapprochez chaque transactionId de votre propre registre. Comparez total avec le montant facturé à votre client.
Listez status=REFUNDED et assurez-vous que chacune est également remboursée de votre côté.
Listez status=UNKNOWN et gardez-les ouvertes jusqu’à leur résolution.

Tout SUCCESS absent de votre côté est un paiement accepté mais non enregistré ; tout enregistrement de votre côté sans SUCCESS correspond à de l’argent que vous n’auriez pas dû encaisser.

Suivant : Tests en sandbox

Reproduire chaque résultat avec des comptes de test

​Reçu

​Avis de paiement AADL

​Historique

​Rapprochement quotidien

Suivant : Tests en sandbox

Reçu

Avis de paiement AADL

Historique

Rapprochement quotidien