DocsTableau de bord

GuidesEncaisserRapprochement

Rapprochement

Le rapprochement vérifie que l’argent annoncé par vos prestataires correspond à vos paiements : chaque mouvement de leur rapport est rattaché à sa commande, ses frais réels sont mis à côté de ceux de votre contrat, et ce qui ne correspond pas devient un écart à traiter.

Importer le rapport du prestataire

Exportez le rapport de règlement chez le prestataire, puis importez-le dans le tableau de bord (Rapprochement) ou par l’API : chez Stripe « Balance change from activity itemized », chez Adyen « Settlement details », chez Checkout.com « Financial actions ». 10 Mo au plus.

POST/v1/reconciliation/importscURL
curl -X POST "$PAYMENT_OS_API/v1/reconciliation/imports" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -d '{
    "connection_id": "con_5b1d7e2a-0c4f-4e8b-a9d3-6f2e1c8b4a70",
    "file_name": "stripe-octobre-2026.csv",
    "content": "…le texte CSV du rapport…"
  }'
  • Le même fichier importé deux fois ne compte qu’une fois
  • Un fichier coupé ou en partie illisible est gardé comme partiel : il ne prouve jamais qu’un mouvement manque
  • Les ventes qui ne sont pas passées par PayHaze sont comptées à part, sans être gardées

Le journal et les frais réels

Chaque mouvement du rapport est séparé en montant et en frais, relié à sa ligne d’origine et à l’estimation du tarif de votre contrat. Son état : rapproché, écart, argent sans commande, ou mouvement du compte sans paiement (GET /v1/reconciliation/journal).

Pour chaque compte, les frais réels du dernier rapport s’affichent à côté des frais estimés (GET /v1/reconciliation). Rien n’est jamais effacé : un rapport corrigé ajoute une écriture inverse, liée à celle qu’il corrige.

Traiter les écarts

Les écarts forment une file, chacun avec sa priorité, son responsable, sa raison et son degré de certitude. Dans le tableau de bord, une personne de votre équipe confie un écart, l’accepte, le conteste auprès du prestataire, ou rattache de l’argent arrivé sans commande à la commande de votre espace.

Pour un seul paiement dont l’état vous semble douteux, POST /v1/payment-intents/{id}/reconcile demande à PayHaze de relire le paiement chez le prestataire, sans rien y modifier.