Rapports & rapprochement

Tout ce dont vous avez besoin pour rapprocher se trouve dans le registre des transactions. Qu'un webhook ait été manqué ou que vous clôturiez les comptes, le registre fait autorité.

Prerequisites

Un jeton API valide (Authentification). Tous les points de terminaison sont limités à vos propres données.

Interroger vos transactions

GET/api/payments/transaction/Bearer

bash

curl "https://payrouter.io/api/payments/transaction/?ordering=-created_at&page=1&page_size=50" \
  -H "Authorization: Bearer $PAYROUTER_TOKEN"

Filtres utiles

Paramètre	Exemple	Notes
`transaction_status`	`Success`, `Failed`, `Pending`	Filtrer par état du cycle de vie.
`operation`	`debit`, `credit`	Encaissements vs versements.
`provider_code_name`	`freshpay`, `unipesa`	Filtrer par fournisseur routé.
`service`	un id de service	Filtrer par service.
`search`	référence / numéro client	Recherche en texte libre.
`ordering`	`-created_at`	Tri (préfixe `-` pour ordre décroissant).
`page`, `page_size`	`1`, `50`	Pagination (taille de page max 200).

Les réponses sont paginées (count, next, previous, results) et chaque ligne porte des libellés lisibles (currency_abbr, service_name, country_abbr) ainsi que la ventilation des montants (amount, commission_amount, merchant_amount).

Mouvements de portefeuille

bash

# Your wallets
curl https://payrouter.io/api/merchants/merchant/wallet/ \
  -H "Authorization: Bearer $PAYROUTER_TOKEN"

# Ledger movements (date-range filterable)
curl "https://payrouter.io/api/merchants/merchant/wallet-history/?created_at__gt=2026-06-01&created_at__lt=2026-07-01" \
  -H "Authorization: Bearer $PAYROUTER_TOKEN"

L'historique de portefeuille prend en charge les recherches wallet, operation, currency, service, flow, et de plage created_at (__gt, __lt, __gte, __lte).

Chronologie des statuts

Pour une transaction unique, lisez l'historique complet de la machine à états :

bash

curl https://payrouter.io/api/payments/transaction/<reference>/history/ \
  -H "Authorization: Bearer $PAYROUTER_TOKEN"

Chaque entrée enregistre le status, une description, l'actor, et un horodatage — la piste d'audit de la façon dont un paiement a atteint son état final.

Récupérer un webhook manqué

Si votre point de terminaison était hors service au moment où un callback s'est déclenché, rapprochez par interrogation :

Listez les transactions récentes filtrées par transaction_status=Pending (ou par date).
Pour chacune, ré-interrogez GET /api/payments/transaction/<reference>/.
Appliquez le statut faisant autorité dans votre système (de façon idempotente, basé sur reference).

Dans le portail

Le portail marchand présente cela sous forme d'écrans Transactions, Portefeuilles et Historique de portefeuille — les mêmes données, visualisées.

Erreurs & codes

Sécurité