Rapprochement
Importer un rapport
POST/v1/reconciliation/importsreconciliation:write
Needs reconciliation:write. The file is the provider's documented export (Stripe Balance change from activity itemized, Adyen Settlement details, Checkout.com Financial actions), 10 MB at most. The same file twice returns the first import with replayed=true. A cut or partly unreadable file is stored as partial and never proves that a movement is missing. Lines of sales PayHaze did not make are counted in unmanaged and not kept. 400 report_format names the missing column.
En-têtes
AuthorizationBearer pos_test_…obligatoire- Clé de serveur. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire- L’espace marchand concerné (mrc_…).
X-Environment"test"obligatoire- Seule valeur acceptée tant que la production n’est pas ouverte.
Corps
connection_idstringobligatoirefile_namestring, 0 à 255obligatoirecontentstringobligatoire- The CSV text of the report.
Réponses
- 201Créé
- 400Requête invalide
- 401Clé absente ou invalide
- 403Autorisation ou espace refusé
- 404Ressource introuvable
- 429Trop de demandes, réessayez plus tard
- 500Request rejected; no success is implied.
Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.