Como posso visualizar os detalhes de carrinhos históricos, ativos e abandonados no Dashboard?

Para visualizar uma lista de todos os carrinhos históricos, ativos ou abandonados no Dashboard, vá para Dashboard -> Carts e clique em All carts na barra lateral esquerda. Nessa visualização, você pode selecionar um carrinho para ver seus detalhes ou filtrar a lista de carrinhos por status.

Quais são os possíveis status de carrinho no Dashboard?

Os possíveis status de carrinho são: Live - carrinhos que estão atualmente no processo de checkout; Abandoned - carrinhos que o comprador abandonou; Order placed - carrinhos que foram convertidos em pedidos; Recovered - carrinhos abandonados que foram recuperados com sucesso e convertidos em pedidos.

Como posso visualizar os detalhes de um carrinho no Dashboard?

Depois de selecionar um carrinho na lista All carts, você será direcionado para a página de detalhes do carrinho. Ali você pode ver o conteúdo do carrinho, as informações de contato do comprador e o status do carrinho. Você também pode copiar rapidamente um link do carrinho se precisar compartilhá-lo.

Qual é o comportamento para compradores da UE devido ao RGPD?

Devido ao RGPD na UE, não podemos exibir determinadas informações de identificação pessoal (PII) de compradores da UE em nossa visualização de carrinhos até que um pedido tenha sido feito. Isso inclui o nome, o endereço de e-mail e o número de telefone do comprador. Ao visualizar um carrinho de um comprador da UE, esses campos serão indicados por texto desfocado onde as PII normalmente seriam exibidas. Outras funções, como visualizar o país, o total do carrinho ou o ID do carrinho, ou copiar o link do carrinho, continuam disponíveis.

Checkout•

InícioComércio eletrônico global Billing Payouts

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.

Para relatórios adicionais, como detalhes de pedidos e um detalhamento dos cálculos de landed cost, visite Reports. Aprenda a usá-los em Relatórios para download.

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.
1. 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.

Exemplo de pagamento

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.

1{

2 "payoutId": "payout_xxxxxxxxxxxxx",

3 "eventType": "ORDER_PAYOUT_DETAILS_READY"

4}

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.

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}

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.

Paginar pagamentos grandes

Um único pagamento pode conter muitas transações. Use os argumentos first e after para percorrer os resultados em páginas, seguindo pageInfo.endCursor até que pageInfo.hasNextPage seja false.

Agendar uma demonstração