Acessar dados de pagamentos
Para encontrar e visualizar um pagamento no Dashboard:
- Vá para Dashboard -> Payouts.
- Selecione o pagamento que deseja visualizar. Se ele não aparecer imediatamente, filtre por data ou valor para restringir sua busca. (A date é a data de chegada do pagamento).
- Veja a visão geral do pagamento e a lista de transações dentro do Dashboard.
- Para mais detalhes, clique em Export transactions para baixar um arquivo CSV do Payout summary ou Payout details.
- Legacy export: O formato de relatório legado ainda está disponível na página de cada pagamento até 31 de julho de 2025, para ajudar na transição para nossos novos relatórios.
Vários pagamentos
Para visualizar informações em vários pagamentos:
- Vá para Dashboard -> Payouts.
- Clique em Export no canto superior direito.
- Selecione o tipo de relatório de sua preferência: Payout summary ou Payout details.
- Ajuste os intervalos de datas. Os intervalos de datas são baseados na data da transação do pedido (não na data de chegada do pagamento).
- Clique em Generate report.
Visão geral do pagamento
A página de pagamento oferece uma visão de alto nível do seu pagamento para que você possa entender rapidamente os detalhes principais sem precisar exportar um relatório.
Cada pagamento é dividido em quatro componentes e depois totalizado:
- Payments: Transações em que os fundos foram recebidos.
- Refunds: Transações em que os fundos foram devolvidos.
- Charges: Taxas deduzidas do pagamento, como taxas de transação ou ajustes.
- Credits: Reembolsos aplicados ao seu pagamento, como devoluções por taxas cobradas em excesso ou outros créditos lançados na sua conta.
- Failed previous payout: Se um pagamento anterior falhou e foi enviado posteriormente junto com um pagamento subsequente, esta linha incluirá esses detalhes.
Para cada componente, são exibidos os seguintes detalhes:
- Items: O valor total que os compradores pagaram por produtos dentro do período do pagamento.
- Shipping: O valor total que os compradores pagaram por envio dentro do período do pagamento.
- Discount: Os descontos totais aplicados a pedidos dentro do período do pagamento.
- Duty, taxes, fees: O valor total que os compradores pagaram por direitos, impostos e outras taxas dentro do período do pagamento.
- Guarantee: O valor total que a Zonos recolheu para cobrir direitos, impostos e taxas garantidos, que a Zonos pagou em seu nome. Esses custos são garantidos pela Zonos.
- Transaction fee: As taxas totais pelo uso dos serviços do Checkout, incluindo proteção antifraude (exclui taxas de processamento de pagamento).
- Merchant fee: As taxas totais de processamento de pagamento deduzidas do pagamento.
- Other: O total de quaisquer encargos diversos dentro do período do pagamento, com memos fornecendo detalhes.
- Total: O total líquido do pagamento.
Para mais detalhes, exporte o relatório em CSV.
Transações dentro de um pagamento
Cada transação dentro do pagamento é listada na seção Transactions. À primeira vista, os seguintes detalhes estão disponíveis por transação:
- Date: A data da transação.
- Order number: O número de pedido da Zonos associado à transação.
- Items: O valor que o comprador pagou por produtos.
- Shipping: O valor que o comprador pagou por envio.
- Discount: Quaisquer descontos aplicados ao pedido.
- Duty, taxes, fees: O valor que o comprador pagou por direitos, impostos e outras taxas.
- Guarantee: O valor que a Zonos recolhe para cobrir direitos, impostos e taxas garantidos, que a Zonos paga em seu nome. Esses custos são garantidos pela Zonos.
- Transaction fee: A taxa pelo uso dos serviços do Checkout, incluindo proteção antifraude (exclui taxas de processamento de pagamento).
- Merchant fee: A taxa de processamento de pagamento.
- Other: Encargos diversos com um memo explicando o motivo.
- Total: O total líquido da transação incluído no pagamento.
Detalhamento das taxas da Zonos por transação
Clique no número de pedido de uma transação para ver um detalhamento completo, incluindo valores de produtos, custos de envio, direitos, impostos e taxas detalhadas (custos de passthrough não serão exibidos). Se nenhuma taxa aparecer, é possível que elas não se apliquem a essa transação (por exemplo, reembolsos ou pedidos DDU).
Exportar relatórios em CSV
Você pode exportar dois tipos de relatórios—Payout summary e Payout detail. Compare-os na página Relatórios para download.
Exportar um único pagamento
Para exportar um CSV de um pagamento específico:
- Vá para Dashboard -> Payouts
- Clique em um pagamento específico
- Clique em Export transactions em qualquer página de pagamento
- Escolha entre Payout summary ou Payout detail
- Isso exporta os dados apenas daquele pagamento específico
Vários períodos de pagamento
Para exportar um CSV que abranja vários períodos de pagamento:
- Vá para Dashboard -> Payouts
- Clique em Export no canto superior direito
- Selecione Payout summary ou Payout detail
- Escolha seu intervalo de datas (com base na data da transação do pedido)
- Clique em Generate report
Note: O formato de relatório legado ainda está disponível nas páginas de pagamentos individuais até 31 de julho de 2025, para ajudar na transição para nossos novos relatórios.
Tipos de relatório
Relatório Payout summary
O relatório Payout summary oferece uma visão completa de cada pedido. Cada pedido é listado em sua própria linha, facilitando o acompanhamento dos totais e taxas de cada pedido. Este relatório é ideal para conciliação rápida e para entender o valor líquido que você receberá por cada pedido. Abaixo está uma lista das colunas do relatório:
| Coluna↕ | Descrição↕ |
|---|---|
| account_name | O nome da sua conta Zonos |
| payout_date | A data em que o pagamento foi processado |
| arrival_date | A data em que o pagamento chegou à sua conta |
| payout_number | Identificador único do pagamento |
| payout_total | Valor total do pagamento |
| currency | Código da moeda do pagamento (por exemplo, USD) |
| transaction_id | Identificador único da transação |
| transaction_date | Data em que a transação ocorreu |
| order_number | Identificador de pedido da Zonos |
| order_reference | Número de referência do pedido na sua plataforma |
| order_date | Data em que o pedido foi feito |
| transaction_type | Tipo de transação (ORDER, ORDER_REFUND, ORDER_CANCEL) |
| item_order | O valor total que os compradores pagaram por produtos |
| shipping_order | O valor total que os compradores pagaram por envio |
| discount_order | Quaisquer descontos aplicados ao pedido |
| duty_tax_fee_order | O valor total que os compradores pagaram por direitos, impostos e outras taxas |
| guarantee | O valor total que a Zonos recolheu para cobrir direitos, impostos e taxas garantidos |
| transaction_fee | As taxas totais pelo uso dos serviços do Checkout |
| merchant_fee | As taxas totais de processamento de pagamento |
| other | Quaisquer encargos diversos com memos fornecendo detalhes |
| settled | O valor final liquidado do pedido |
| memo | Informações adicionais sobre a transação |
Relatório Payout detail
Além do relatório resumido, você pode baixar um relatório details mais detalhado para cada pagamento. Este relatório fornece um detalhamento linha a linha das transações e taxas associadas ao pagamento. Custos que se compensam (como o imposto que um comprador paga e que a Zonos retém para pagar em nome do lojista) não são incluídos neste relatório. Frequentemente haverá várias linhas por pedido, já que cada tipo de encargo é listado em sua própria linha. O relatório de detalhes é útil para reconciliar seus registros financeiros e entender as taxas associadas a cada transação.
Tipos de encargo do relatório Payout detail
Abaixo está uma lista dos possíveis itens de linha que você pode ver em um relatório Payout detail e suas descrições:
| Tipo de encargo↕ | Tipo↕ | Descrição↕ |
|---|---|---|
| ZONOS_MERCHANT_PROCESSING | Taxa de faturamento da Zonos | Taxas do lojista para processamento de pagamento. |
| ZONOS_TRANSACTION | Taxa de faturamento da Zonos | Taxa de transação do Zonos Checkout. |
| CURRENCY_CONVERSION_FEE | Taxa de faturamento da Zonos | Prêmio de câmbio a termo (FX forward) para risco de câmbio. |
| ZONOS_LANDED_COST | Taxa de faturamento da Zonos | Taxa da Zonos Landed Cost Guarantee. |
| ZONOS_LANDED_COST_GUARANTEE | Taxa de faturamento da Zonos | Taxa de garantia para cálculos de landed cost. |
| ADVANCEMENT | Taxa da transportadora | Cobrada pela transportadora—consulte a coluna memo do pagamento para mais detalhes. |
| BROKERAGE_FEE | Taxa da transportadora | Cobrada pela transportadora—consulte a coluna memo do pagamento para mais detalhes. |
| SHIPPING_AMOUNT | Item de subtotal do pedido | Total de envio do pedido, usado para garantir que as linhas de encargo somem o total do pedido. |
| PRODUCT_AMOUNT | Item de subtotal do pedido | Total do carrinho no pedido, usado para garantir que as linhas de encargo somem o total do pedido. |
| DUTY_TAX_AMOUNT | Item de subtotal do pedido | Total de direitos/impostos do pedido antes das retenções, usado para garantir que as linhas de encargo somem o total do pedido. |
| TAX | Item de subtotal do pedido | Total de impostos do pedido, usado para garantir que as linhas de encargo somem o total do pedido. Retido para repasse de impostos. |
| DUTY | Item de subtotal do pedido | Total de direitos do pedido, usado para garantir que as linhas de encargo somem o total do pedido. Retido para repasse de impostos. |
| GUARANTEE_PERCENT | Taxa de faturamento da Zonos | Taxa de garantia baseada em porcentagem para direitos e impostos. |
| GUARANTEE_ORDER | Taxa de faturamento da Zonos | Taxa de garantia de valor fixo por pedido. |
| TRANSACTION_ORDER | Taxa de faturamento da Zonos | Taxa de transação de valor fixo por pedido. |
| TRANSACTION_PERCENT | Taxa de faturamento da Zonos | Taxa de transação baseada em porcentagem. |
Tipos de transação
Os relatórios de pagamentos incluem diferentes tipos de transações:
| Tipo de transação↕ | Descrição↕ |
|---|---|
| ORDER | Transações de pedido regulares em que os fundos foram recebidos. |
| ORDER_REFUND | Transações em que os fundos foram devolvidos ao cliente. |
| ORDER_CANCEL | Transações em que os pedidos foram cancelados antes do processamento. |
| Charge | Transações que não estão associadas a um pedido e representam um encargo. |
| Credit | Transações que não estão associadas a um pedido e representam um crédito. |
Recuperar detalhes de pagamentos via API
Além de exportar relatórios em CSV pelo Dashboard, você pode recuperar o mesmo detalhamento de pagamentos de forma programática por meio da API GraphQL da Zonos. Isso é útil para sincronizar automaticamente os dados de pagamentos com seus próprios sistemas de contabilidade ou reconciliação.
Seja notificado com o webhook ORDER_PAYOUT_DETAILS_READY
Assine o webhook ORDER_PAYOUT_DETAILS_READY para ser notificado quando os
detalhes por item de um pagamento estiverem disponíveis para consulta. Recebê-lo significa que o
detalhamento do pagamento é final e seguro para ser obtido. O webhook entrega o payoutId
que você usa para buscar os detalhes—ele não inclui os detalhes propriamente ditos. Consulte o
guia de webhooks para aprender a configurar webhooks.
{ "payoutId": "payout_xxxxxxxxxxxxx", "eventType": "ORDER_PAYOUT_DETAILS_READY"}Consultar detalhes de pagamentos
Passe o payoutId para a consulta
orderPayoutDetails. Ela retorna
uma conexão paginada de itens
OrderPayoutDetailItem—uma linha
por transação—refletindo o relatório CSV Payout detail
abordado em
Exportar relatórios em CSV
acima.
query OrderPayoutDetails($payoutId: String!, $first: Int, $after: String) { orderPayoutDetails(payoutId: $payoutId, first: $first, after: $after) { totalAmount edges { cursor node { accountName payoutDate arrivalDate payoutNumber currency transactionId transactionDate orderNumber orderReference orderDate transactionType detailType payee payor amount memo } } pageInfo { hasNextPage endCursor } }}A conexão também expõe um campo totalAmount—a soma de amount entre as
linhas visíveis para sua organização—para que você possa obter o total do pagamento
sem precisar somar cada página manualmente.
Visualizar pagamentos
Aprenda a acessar e entender os detalhes dos seus pagamentos do Checkout.
Acesse e visualize facilmente seus relatórios de pagamentos no Zonos Dashboard. Os pagamentos são gerados regularmente, fornecendo um detalhamento das transações, taxas e valores líquidos ao usar o Zonos Checkout. Os pagamentos são emitidos na moeda local selecionada quando você configurou sua conta. Esses relatórios ajudam você a reconciliar registros financeiros e acompanhar seus ganhos.