Como posso consultar um pagamento no Dashboard?

Aceda a Dashboard -> Payouts e selecione o pagamento que pretende consultar. Se não aparecer de imediato, filtre por data ou montante (a data é a data de chegada do pagamento). A página do pagamento apresenta a visão geral do pagamento e a lista das transações nele incluídas.

Em que moeda são emitidos os pagamentos?

Os pagamentos são emitidos na moeda local selecionada quando configurou a sua conta.

Qual é a diferença entre os relatórios Payout summary e Payout detail?

O relatório Payout summary apresenta cada encomenda na sua própria linha, o que facilita o acompanhamento dos totais e das taxas de cada encomenda. O relatório Payout detail fornece uma discriminação, linha a linha, das transações e taxas de um pagamento, muitas vezes com várias linhas por encomenda, uma vez que cada tipo de cobrança é apresentado na sua própria linha.

Checkout•

InícioComércio eletrónico global Faturação Pagamentos

Consultar pagamentos

Q: Posso obter os detalhes dos pagamentos através da API?

Sim. Pode obter a mesma discriminação dos detalhes do pagamento através da API GraphQL da Zonos. Subscreva o webhook ORDER_PAYOUT_DETAILS_READY para ser notificado quando os detalhes de um pagamento estiverem finalizados; o webhook envia o payoutId que utiliza para os obter.

Saiba como aceder aos detalhes dos seus pagamentos do Checkout e como interpretá-los.

Aceda facilmente aos seus relatórios de pagamentos e consulte-os no Zonos Dashboard. Os pagamentos são gerados regularmente e apresentam uma discriminação detalhada das transações, taxas e valores líquidos quando utiliza o Zonos Checkout. Os pagamentos são emitidos na moeda local que selecionou ao configurar a sua conta. Estes relatórios ajudam-no a reconciliar os registos financeiros e a acompanhar os seus ganhos.

Para relatórios adicionais, como os detalhes das encomendas e a discriminação dos cálculos de landed cost, visite Reports. Saiba como utilizá-los em Relatórios transferíveis.

Aceder aos dados de pagamentos

Para encontrar e consultar um pagamento no Dashboard:

Aceda a Dashboard -> Payouts.
Selecione o pagamento que pretende consultar. Se não aparecer de imediato, filtre por data ou montante para restringir a pesquisa. (A data é a data de chegada do pagamento).
Consulte a visão geral do pagamento e a lista de transações no Dashboard.
Para obter mais detalhes, clique em Export transactions para transferir um ficheiro CSV do Payout summary ou do Payout details.
1. Exportação legada: O formato de relatório legado continua disponível na página de cada pagamento até 31 de julho de 2025, para facilitar a transição para os nossos novos relatórios.

Vários pagamentos

Para consultar informações de vários pagamentos:

Aceda a Dashboard -> Payouts.
Clique em Export no canto superior direito.
Selecione o tipo de relatório pretendido: Payout summary ou Payout details.
Ajuste os intervalos de datas. Os intervalos de datas baseiam-se na data da transação da encomenda (e não na data de chegada do pagamento).
Clique em Generate report.

Visão geral do pagamento

A página do pagamento apresenta uma visão de alto nível do seu pagamento, para que possa compreender rapidamente os detalhes principais sem ter de exportar um relatório.

Cada pagamento é dividido em cinco componentes, que são depois somados:

Payments: Transações em que foram recebidos fundos.
Refunds: Transações em que foram devolvidos fundos.
Charges: Taxas deduzidas do pagamento, como taxas de transação ou ajustes.
Credits: Reembolsos aplicados ao seu pagamento, como devoluções de taxas cobradas em excesso ou outros créditos emitidos para a sua conta.
Failed previous payout: Se um pagamento anterior falhou e foi posteriormente enviado com um pagamento seguinte, esta linha inclui esses detalhes.

Para cada componente, são apresentados os seguintes detalhes:

Items: O montante total que os compradores pagaram por produtos durante o período do pagamento.
Shipping: O montante total que os compradores pagaram pelo envio durante o período do pagamento.
Discount: O total de descontos aplicados às encomendas durante o período do pagamento.
Duty, taxes, fees: O montante total que os compradores pagaram em direitos aduaneiros, impostos e outras taxas durante o período do pagamento.
Guarantee: O montante total cobrado pela Zonos para cobrir os direitos aduaneiros, impostos e taxas garantidos, que a Zonos pagou em seu nome. Estes custos são garantidos pela Zonos.
Transaction fee: O total das taxas pela utilização dos serviços do Checkout, incluindo a proteção contra fraude (exclui as taxas de processamento de pagamentos).
Merchant fee: O total das taxas de processamento de pagamentos deduzidas do pagamento.
Other: O total de quaisquer encargos diversos durante o período do pagamento, com memorandos que fornecem detalhes.
Total: O total líquido do pagamento.

Para mais detalhes, exporte o relatório CSV.

Exemplo de pagamento

Transações de um pagamento

Cada transação do pagamento é apresentada na secção Transactions. De relance, estão disponíveis os seguintes detalhes por transação:

Date: A data da transação.
Order number: O número de encomenda da Zonos associado à transação.
Items: O montante que o comprador pagou por produtos.
Shipping: O montante que o comprador pagou pelo envio.
Discount: Quaisquer descontos aplicados à encomenda.
Duty, taxes, fees: O montante que o comprador pagou em direitos aduaneiros, impostos e outras taxas.
Guarantee: O montante cobrado pela Zonos para cobrir os direitos aduaneiros, impostos e taxas garantidos, que a Zonos paga em seu nome. Estes custos são garantidos pela Zonos.
Transaction fee: A taxa pela utilização dos serviços do Checkout, incluindo a proteção contra fraude (exclui as taxas de processamento de pagamentos).
Merchant fee: A taxa de processamento de pagamentos.
Other: Encargos diversos, com um memorando que explica o motivo.
Total: O total líquido da transação incluído no pagamento.

Discriminação das taxas da Zonos por transação

Clique no número de encomenda de uma transação para ver uma discriminação detalhada, incluindo os montantes dos produtos, os custos de envio, os direitos aduaneiros, os impostos e as taxas discriminadas (os custos de passthrough não são apresentados). Se não aparecer nenhuma taxa, é possível que não se apliquem a essa transação (por exemplo, reembolsos ou encomendas DDU).

Exportar relatórios CSV

Pode exportar dois tipos de relatórios: Payout summary e Payout detail. Compare-os na página Relatórios transferíveis.

Exportar um único pagamento

Para exportar um CSV de um pagamento específico:

Aceda a Dashboard -> Payouts
Clique num pagamento específico
Clique em Export transactions em qualquer página de pagamento
Escolha entre Payout summary e Payout detail
São exportados os dados apenas desse pagamento específico

Vários períodos de pagamento

Para exportar um CSV que abranja vários períodos de pagamento:

Aceda a Dashboard -> Payouts
Clique em Export no canto superior direito
Selecione Payout summary ou Payout detail
Escolha o intervalo de datas (com base na data da transação da encomenda)
Clique em Generate report

Nota: O formato de relatório legado continua disponível nas páginas de cada pagamento até 31 de julho de 2025, para facilitar a transição para os nossos novos relatórios.

Tipos de relatório

Relatório Payout summary

O relatório Payout summary apresenta uma visão completa de cada encomenda. Cada encomenda é apresentada na sua própria linha, o que facilita o acompanhamento dos totais e das taxas de cada encomenda. Este relatório é ideal para uma reconciliação rápida e para compreender o montante líquido que irá receber por cada encomenda. Segue-se a 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	Montante 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 da encomenda na Zonos
order_reference	Número de referência da encomenda na sua plataforma
order_date	Data em que a encomenda foi efetuada
transaction_type	Tipo de transação (ORDER, ORDER_REFUND, ORDER_CANCEL)
item_order	O montante total que os compradores pagaram por produtos
shipping_order	O montante total que os compradores pagaram pelo envio
discount_order	Quaisquer descontos aplicados à encomenda
duty_tax_fee_order	O montante total que os compradores pagaram em direitos aduaneiros, impostos e outras taxas
guarantee	O montante total cobrado pela Zonos para cobrir os direitos aduaneiros, impostos e taxas garantidos
transaction_fee	O total das taxas pela utilização dos serviços do Checkout
merchant_fee	O total das taxas de processamento de pagamentos
other	Quaisquer encargos diversos, com memorandos que fornecem detalhes
settled	O montante final liquidado relativo à encomenda
memo	Informações adicionais sobre a transação

Relatório Payout detail

Além do relatório de resumo, pode transferir um relatório de detalhes mais aprofundado para cada pagamento. Este relatório apresenta uma discriminação linha a linha das transações e taxas associadas ao pagamento. Os custos que se compensam (como o imposto que um comprador paga e que a Zonos retém para pagar em nome do comerciante) não são incluídos neste relatório. É frequente existirem várias linhas por encomenda, uma vez que cada tipo de encargo é apresentado na sua própria linha. O relatório de detalhes é útil para reconciliar os seus registos financeiros e compreender as taxas associadas a cada transação.

Tipos de encargo do relatório Payout detail

Segue-se uma lista das possíveis linhas que pode encontrar num relatório Payout detail e respetivas descrições:

Tipo de encargo↕	Tipo↕	Descrição↕
ZONOS_MERCHANT_PROCESSING	Taxa de faturação da Zonos	Taxas do comerciante para o processamento de pagamentos.
ZONOS_TRANSACTION	Taxa de faturação da Zonos	Taxa de transação do Zonos Checkout.
CURRENCY_CONVERSION_FEE	Taxa de faturação da Zonos	Prémio de câmbio a prazo (FX forward) para cobertura do risco cambial.
ZONOS_LANDED_COST	Taxa de faturação da Zonos	Taxa da Zonos Landed Cost Guarantee.
ZONOS_LANDED_COST_GUARANTEE	Taxa de faturação da Zonos	Taxa de garantia para os 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	Subtotal da encomenda	Total do envio da encomenda, utilizado para garantir que as linhas de encargos correspondem ao total da encomenda.
PRODUCT_AMOUNT	Subtotal da encomenda	Total do carrinho da encomenda, utilizado para garantir que as linhas de encargos correspondem ao total da encomenda.
DUTY_TAX_AMOUNT	Subtotal da encomenda	Total de direitos aduaneiros/impostos da encomenda antes das retenções, utilizado para garantir que as linhas de encargos correspondem ao total da encomenda.
TAX	Subtotal da encomenda	Total de impostos da encomenda, utilizado para garantir que as linhas de encargos correspondem ao total da encomenda. Retido para entrega dos impostos.
DUTY	Subtotal da encomenda	Total de direitos aduaneiros da encomenda, utilizado para garantir que as linhas de encargos correspondem ao total da encomenda. Retido para entrega dos impostos.
GUARANTEE_PERCENT	Taxa de faturação da Zonos	Taxa de garantia percentual para direitos aduaneiros e impostos.
GUARANTEE_ORDER	Taxa de faturação da Zonos	Taxa de garantia fixa por encomenda.
TRANSACTION_ORDER	Taxa de faturação da Zonos	Taxa de transação fixa por encomenda.
TRANSACTION_PERCENT	Taxa de faturação da Zonos	Taxa de transação percentual.

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 encomendas normais em que foram recebidos fundos.
ORDER_REFUND	Transações em que os fundos foram devolvidos ao cliente.
ORDER_CANCEL	Transações em que as encomendas foram canceladas antes do processamento.
Charge	Transações que não estão associadas a uma encomenda e constituem um encargo.
Credit	Transações que não estão associadas a uma encomenda e constituem um crédito.

Obter os detalhes dos pagamentos através da API

Além de exportar relatórios CSV a partir do Dashboard, pode obter a mesma discriminação detalhada dos pagamentos de forma programática através da API GraphQL da Zonos. Isto é útil para sincronizar automaticamente os dados dos pagamentos com os seus próprios sistemas de contabilidade ou de reconciliação.

Receber notificações com o webhook ORDER_PAYOUT_DETAILS_READY

Subscreva o webhook ORDER_PAYOUT_DETAILS_READY para ser notificado quando os detalhes das linhas de um pagamento estiverem disponíveis para consulta. A receção deste webhook significa que a discriminação do pagamento é definitiva e pode ser obtida com segurança. O webhook envia o payoutId que utiliza para obter os detalhes, mas não inclui os próprios detalhes. Consulte o guia de webhooks para saber como configurar webhooks.

1{

2 "payoutId": "payout_xxxxxxxxxxxxx",

3 "eventType": "ORDER_PAYOUT_DETAILS_READY"

4}

Consultar os detalhes dos pagamentos

Passe o payoutId para a consulta orderPayoutDetails. Esta devolve uma ligação (connection) paginada de linhas OrderPayoutDetailItem, uma linha por transação, que reflete o relatório CSV Payout detail descrito em Exportar relatórios 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 ligação (connection) também expõe um campo totalAmount, a soma de amount em todas as linhas visíveis para a sua organização, para que possa obter o total do pagamento sem ter de somar cada página.

Paginar pagamentos grandes

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

Marcar uma demonstração