DOCS

Consulter les paiements

Découvrez comment accéder à vos paiements et comprendre leurs détails pour Checkout.

Accédez facilement à vos rapports de paiement et consultez-les dans le Dashboard Zonos. Les paiements sont générés régulièrement et fournissent une ventilation détaillée des transactions, frais et montants nets lors de l'utilisation de Zonos Checkout. Les paiements sont émis dans votre devise locale, sélectionnée lors de la configuration de votre compte. Ces rapports vous aident à rapprocher vos registres financiers et à suivre vos revenus.

Pour des rapports supplémentaires, tels que les détails de commande et une ventilation des calculs de coût rendu, consultez Rapports. Découvrez comment les utiliser dans Rapports téléchargeables.

Accéder aux données de paiement 

Pour trouver et consulter un paiement dans Dashboard :

  1. Accédez à Dashboard -> Paiements.
  2. Sélectionnez le paiement que vous souhaitez consulter. S'il n'apparaît pas immédiatement, filtrez par date ou montant pour affiner votre recherche. (La date correspond à la date d'arrivée du paiement).
  3. Consultez l'aperçu du paiement et la liste des transactions dans Dashboard.
  4. Pour plus de détails, cliquez sur Exporter les transactions pour télécharger un fichier CSV du Récapitulatif de paiement ou des Détails de paiement.
    1. Export existant : L'ancien format de rapport reste disponible sur la page de chaque paiement jusqu'au 31 juillet 2025, afin de faciliter la transition vers nos nouveaux rapports.

Paiements multiples

Pour consulter des informations portant sur plusieurs paiements :

  1. Accédez à Dashboard -> Paiements.
  2. Cliquez sur Exporter en haut à droite.
  3. Sélectionnez le type de rapport souhaité : Récapitulatif de paiement ou Détails de paiement.
  4. Ajustez les plages de dates. Les plages de dates sont basées sur la date de transaction de la commande (et non la date d'arrivée du paiement).
  5. Cliquez sur Générer le rapport.

Aperçu du paiement 

La page de paiement offre une vue d'ensemble de votre paiement afin que vous puissiez rapidement comprendre les détails clés sans avoir besoin d'exporter un rapport.

Chaque paiement est décomposé en quatre éléments, puis totalisé :

  • Paiements: Transactions pour lesquelles des fonds ont été reçus.
  • Remboursements: Transactions pour lesquelles des fonds ont été restitués.
  • Frais: Frais déduits du paiement, tels que les frais de transaction ou les ajustements.
  • Crédits: Remboursements appliqués à votre paiement, tels que les remboursements de frais facturés en trop ou d'autres crédits accordés à votre compte.
  • Paiement précédent échoué: Si un paiement précédent a échoué puis a été renvoyé avec un paiement suivant, cette ligne inclura ces détails.

Pour chaque élément, les détails suivants sont affichés :

  • Articles: Le montant total payé par les acheteurs pour les produits au cours de la période de paiement.
  • Livraison: Le montant total payé par les acheteurs pour la livraison au cours de la période de paiement.
  • Remise: Le total des remises appliquées aux commandes au cours de la période de paiement.
  • Droits, taxes, frais: Le montant total payé par les acheteurs pour les droits de douane, les taxes et les autres frais au cours de la période de paiement.
  • Garantie: Le montant total collecté par Zonos pour couvrir les droits, taxes et frais garantis, que Zonos a payés en votre nom. Ces coûts sont garantis par Zonos.
  • Frais de transaction: Le total des frais liés à l'utilisation des services Checkout, y compris la protection contre la fraude (hors frais de traitement des paiements).
  • Frais marchand: Le total des frais de traitement des paiements déduits du paiement.
  • Autre: Le total des frais divers au cours de la période de paiement, avec des mémos apportant des précisions.
  • Total: Le montant net total du paiement.

Pour plus de détails, exportez le rapport CSV.

Exemple de paiement

Transactions dans un paiement

Chaque transaction du paiement est répertoriée dans la section Transactions. En un coup d'œil, les détails suivants sont disponibles par transaction :

  • Date: La date de la transaction.
  • Numéro de commande: Le numéro de commande Zonos associé à la transaction.
  • Articles: Le montant payé par l'acheteur pour les produits.
  • Livraison: Le montant payé par l'acheteur pour la livraison.
  • Remise: Les remises éventuellement appliquées à la commande.
  • Droits, taxes, frais: Le montant payé par l'acheteur pour les droits de douane, les taxes et les autres frais.
  • Garantie: Le montant collecté par Zonos pour couvrir les droits, taxes et frais garantis, que Zonos paie en votre nom. Ces coûts sont garantis par Zonos.
  • Frais de transaction: Les frais liés à l'utilisation des services Checkout, y compris la protection contre la fraude (hors frais de traitement des paiements).
  • Frais marchand: Les frais de traitement des paiements.
  • Autre: Frais divers accompagnés d'un mémo expliquant le motif.
  • Total: Le montant net total de la transaction incluse dans le paiement.

Ventilation des frais Zonos par transaction

Cliquez sur le numéro de commande d'une transaction pour afficher une ventilation détaillée, incluant les montants des produits, les frais de livraison, les droits de douane, les taxes et les frais détaillés (les coûts refacturés ne s'affichent pas). Si aucun frais n'apparaît, il se peut qu'ils ne s'appliquent pas à cette transaction (par exemple, les remboursements ou les commandes DDU).

Exporter des rapports CSV 

Vous pouvez exporter deux types de rapports : le Récapitulatif de paiement et le Détail de paiement. Comparez-les sur la page Rapports téléchargeables.

Exporter un paiement unique

Pour exporter un CSV d'un paiement spécifique :

  1. Accédez à Dashboard -> Paiements
  2. Cliquez sur un paiement spécifique
  3. Cliquez sur Exporter les transactions sur n'importe quelle page de paiement
  4. Choisissez entre Récapitulatif de paiement et Détail de paiement
  5. Cela exporte les données de ce seul paiement

Périodes de paiement multiples

Pour exporter un CSV couvrant plusieurs périodes de paiement :

  1. Accédez à Dashboard -> Paiements
  2. Cliquez sur Exporter en haut à droite
  3. Sélectionnez Récapitulatif de paiement ou Détail de paiement
  4. Choisissez votre plage de dates (basée sur la date de transaction de la commande)
  5. Cliquez sur Générer le rapport

Remarque : L'ancien format de rapport reste disponible sur les pages de paiement individuelles jusqu'au 31 juillet 2025, afin de faciliter la transition vers nos nouveaux rapports.

Types de rapports

Rapport récapitulatif de paiement

Le rapport récapitulatif de paiement offre une vue complète de chaque commande. Chaque commande est répertoriée sur sa propre ligne, ce qui facilite le suivi des totaux et des frais de chaque commande. Ce rapport est idéal pour un rapprochement rapide et pour comprendre le montant net que vous recevrez pour chaque commande. Voici la liste des colonnes du rapport :

ColonneDescription
account_nameLe nom de votre compte Zonos
payout_dateLa date à laquelle le paiement a été traité
arrival_dateLa date à laquelle le paiement est arrivé sur votre compte
payout_numberIdentifiant unique du paiement
payout_totalMontant total du paiement
currencyCode de devise du paiement (par exemple, USD)
transaction_idIdentifiant unique de la transaction
transaction_dateDate à laquelle la transaction a eu lieu
order_numberIdentifiant de commande Zonos
order_referenceNuméro de référence de commande de votre plateforme
order_dateDate à laquelle la commande a été passée
transaction_typeType de transaction (ORDER, ORDER_REFUND, ORDER_CANCEL)
item_orderLe montant total payé par les acheteurs pour les produits
shipping_orderLe montant total payé par les acheteurs pour la livraison
discount_orderLes remises éventuellement appliquées à la commande
duty_tax_fee_orderLe montant total payé par les acheteurs pour les droits de douane, les taxes et les autres frais
guaranteeLe montant total collecté par Zonos pour couvrir les droits, taxes et frais garantis
transaction_feeLe total des frais liés à l'utilisation des services Checkout
merchant_feeLe total des frais de traitement des paiements
otherLes frais divers éventuels, avec des mémos apportant des précisions
settledLe montant final réglé pour la commande
memoInformations supplémentaires sur la transaction

Rapport détaillé de paiement

En complément du rapport récapitulatif, vous pouvez télécharger un rapport de détails plus approfondi pour chaque paiement. Ce rapport fournit une ventilation ligne par ligne des transactions et des frais associés au paiement. Les coûts qui s'annulent (comme la taxe payée par l'acheteur, que Zonos conserve pour la reverser au nom du marchand) ne sont pas inclus dans ce rapport. Il y aura souvent plusieurs lignes par commande, chaque type de frais étant répertorié sur sa propre ligne. Le rapport de détails est utile pour rapprocher vos registres financiers et comprendre les frais associés à chaque transaction.

Types de charges du rapport détaillé

Voici une liste des lignes possibles que vous pouvez voir sur un rapport de détails de paiement, ainsi que leurs descriptions :

Type de fraisTypeDescription
ZONOS_MERCHANT_PROCESSINGFrais de facturation ZonosFrais marchand pour le traitement des paiements.
ZONOS_TRANSACTIONFrais de facturation ZonosFrais de transaction Zonos Checkout.
CURRENCY_CONVERSION_FEEFrais de facturation ZonosPrime de change à terme pour le risque de change.
ZONOS_LANDED_COSTFrais de facturation ZonosFrais de garantie Zonos Landed Cost.
ZONOS_LANDED_COST_GUARANTEEFrais de facturation ZonosFrais de garantie pour les calculs de coût rendu.
ADVANCEMENTFrais de transporteurFacturé par le transporteur : consultez la colonne memo du paiement pour plus de détails.
BROKERAGE_FEEFrais de transporteurFacturé par le transporteur : consultez la colonne memo du paiement pour plus de détails.
SHIPPING_AMOUNTÉlément du sous-total de la commandeTotal de la livraison sur la commande, utilisé pour s'assurer que les lignes de frais correspondent au total de la commande.
PRODUCT_AMOUNTÉlément du sous-total de la commandeTotal du panier sur la commande, utilisé pour s'assurer que les lignes de frais correspondent au total de la commande.
DUTY_TAX_AMOUNTÉlément du sous-total de la commandeTotal des droits/taxes sur la commande avant retenues, utilisé pour s'assurer que les lignes de frais correspondent au total de la commande.
TAXÉlément du sous-total de la commandeTotal des taxes sur la commande, utilisé pour s'assurer que les lignes de frais correspondent au total de la commande. Retenu pour le versement des taxes.
DUTYÉlément du sous-total de la commandeTotal des droits de douane sur la commande, utilisé pour s'assurer que les lignes de frais correspondent au total de la commande. Retenu pour le versement des taxes.
GUARANTEE_PERCENTFrais de facturation ZonosFrais de garantie basés sur un pourcentage pour les droits et taxes.
GUARANTEE_ORDERFrais de facturation ZonosFrais de garantie fixe par commande.
TRANSACTION_ORDERFrais de facturation ZonosFrais de transaction fixe par commande.
TRANSACTION_PERCENTFrais de facturation ZonosFrais de transaction basés sur un pourcentage.

Types de transaction

Les rapports de paiement incluent différents types de transactions :

Type de transactionDescription
ORDERTransactions de commande standard pour lesquelles des fonds ont été reçus.
ORDER_REFUNDTransactions pour lesquelles des fonds ont été restitués au client.
ORDER_CANCELTransactions pour lesquelles des commandes ont été annulées avant traitement.
ChargeTransactions non associées à une commande et correspondant à des frais.
CreditTransactions non associées à une commande et correspondant à un crédit.

Récupérer les détails de paiement via API 

En plus d'exporter des rapports CSV depuis Dashboard, vous pouvez récupérer la même ventilation des détails de paiement de manière programmatique via l'API GraphQL de Zonos. Cela est utile pour synchroniser automatiquement les données de paiement dans vos propres systèmes de comptabilité ou de rapprochement.

Être notifié avec le webhook ORDER_PAYOUT_DETAILS_READY

Abonnez-vous au webhook ORDER_PAYOUT_DETAILS_READY pour être averti lorsque les détails ligne par ligne d'un paiement sont disponibles pour interrogation. Sa réception signifie que la ventilation du paiement est définitive et peut être récupérée en toute sécurité. Le webhook transmet le payoutId que vous utilisez pour récupérer les détails ; il n'intègre pas les détails eux-mêmes. Consultez le guide des webhooks pour savoir comment configurer des webhooks.

1{
2 "payoutId": "payout_xxxxxxxxxxxxx",
3 "eventType": "ORDER_PAYOUT_DETAILS_READY"
4}

Interroger les détails de paiement

Transmettez le payoutId à la requête orderPayoutDetails. Elle renvoie une connexion paginée d'éléments OrderPayoutDetailItem - une ligne par transaction - reflétant le rapport CSV Détail de paiement présenté dans Exporter des rapports CSV ci-dessus.

1query OrderPayoutDetails($payoutId: String!, $first: Int, $after: String) {
2 orderPayoutDetails(payoutId: $payoutId, first: $first, after: $after) {
3 totalAmount
4 edges {
5 cursor
6 node {
7 accountName
8 payoutDate
9 arrivalDate
10 payoutNumber
11 currency
12 transactionId
13 transactionDate
14 orderNumber
15 orderReference
16 orderDate
17 transactionType
18 detailType
19 payee
20 payor
21 amount
22 memo
23 }
24 }
25 pageInfo {
26 hasNextPage
27 endCursor
28 }
29 }
30}

La connexion expose également un champ totalAmount - la somme des amount de tous les éléments visibles par votre organisation - afin que vous puissiez obtenir le total du paiement sans avoir à additionner vous-même chaque page.

Paginer les grands paiements

Un seul paiement peut contenir de nombreuses transactions. Utilisez les arguments first et after pour parcourir les résultats, en suivant pageInfo.endCursor jusqu'à ce que pageInfo.hasNextPage soit false.

Cette page a-t-elle été utile?