Acceder a los datos de pagos
Para encontrar y ver un pago en Dashboard:
- Vaya a Dashboard -> Payouts.
- Seleccione el pago que desea ver. Si no aparece de inmediato, filtre por fecha o importe para acotar la búsqueda. (La fecha es la fecha de llegada del pago).
- Consulte la vista general del pago y la lista de transacciones en Dashboard.
- Para obtener más detalles, haga clic en Export transactions para descargar un archivo CSV del Payout summary o Payout details.
- Legacy export: El formato de reporte heredado sigue disponible en la página de cada pago hasta el 31 de julio de 2025, para facilitar la transición a nuestros nuevos reportes.
Varios pagos
Para ver información de varios pagos:
- Vaya a Dashboard -> Payouts.
- Haga clic en Export en la esquina superior derecha.
- Seleccione el tipo de reporte que prefiera: Payout summary o Payout details.
- Ajuste los rangos de fechas. Los rangos de fechas se basan en la fecha de la transacción del pedido (no en la fecha de llegada del pago).
- Haga clic en Generate report.
Vista general del pago
La página de pagos ofrece una vista de alto nivel de su pago para que pueda comprender rápidamente los detalles clave sin necesidad de exportar un reporte.
Cada pago se divide en cuatro componentes y luego se totaliza:
- Payments: Transacciones en las que se recibieron fondos.
- Refunds: Transacciones en las que se devolvieron fondos.
- Charges: Tasas deducidas del pago, como tasas de transacción o ajustes.
- Credits: Reembolsos aplicados a su pago, como devoluciones por tasas cobradas en exceso u otros créditos emitidos a su cuenta.
- Failed previous payout: Si un pago anterior falló y se envió posteriormente con un pago subsiguiente, esta línea incluirá esos detalles.
Para cada componente, se muestran los siguientes detalles:
- Items: El importe total que los compradores pagaron por productos dentro del período del pago.
- Shipping: El importe total que los compradores pagaron por envío dentro del período del pago.
- Discount: Los descuentos totales aplicados a los pedidos dentro del período del pago.
- Duty, taxes, fees: El importe total que los compradores pagaron por derechos, impuestos y otras tasas dentro del período del pago.
- Guarantee: El importe total que Zonos recaudó para cubrir derechos, impuestos y tasas garantizados, que Zonos pagó en su nombre. Estos costos están garantizados por Zonos.
- Transaction fee: Las tasas totales por el uso de los servicios de Checkout, incluida la protección contra fraude (excluye las tasas de procesamiento de pagos).
- Merchant fee: Las tasas totales de procesamiento de pagos deducidas del pago.
- Other: El total de cualquier cargo misceláneo dentro del período del pago, con notas que proporcionan detalles.
- Total: El total neto del pago.
Para más detalle, exporte el reporte CSV.
Transacciones dentro de un pago
Cada transacción dentro del pago aparece en la sección Transactions. De un vistazo, están disponibles los siguientes detalles por transacción:
- Date: La fecha de la transacción.
- Order number: El número de pedido de Zonos asociado a la transacción.
- Items: El importe que el comprador pagó por productos.
- Shipping: El importe que el comprador pagó por envío.
- Discount: Los descuentos aplicados al pedido.
- Duty, taxes, fees: El importe que el comprador pagó por derechos, impuestos y otras tasas.
- Guarantee: El importe que Zonos recauda para cubrir derechos, impuestos y tasas garantizados, que Zonos paga en su nombre. Estos costos están garantizados por Zonos.
- Transaction fee: La tasa por el uso de los servicios de Checkout, incluida la protección contra fraude (excluye las tasas de procesamiento de pagos).
- Merchant fee: La tasa de procesamiento de pagos.
- Other: Cargos misceláneos con una nota que explica el motivo.
- Total: El total neto de la transacción incluida en el pago.
Desglose de tasas de Zonos por transacción
Haga clic en el número de pedido de una transacción para ver un desglose detallado, que incluye importes de productos, costos de envío, derechos, impuestos y tasas desglosadas (los costos de traspaso no se mostrarán). Si no aparecen tasas, es posible que no apliquen a esa transacción (p. ej., reembolsos o pedidos DDU).
Exportar reportes CSV
Puede exportar dos tipos de reportes: Payout summary y Payout detail. Compárelos en la página de Reportes descargables.
Exportar un solo pago
Para exportar un CSV de un pago específico:
- Vaya a Dashboard -> Payouts
- Haga clic en un pago específico
- Haga clic en Export transactions en cualquier página de pago
- Elija entre Payout summary o Payout detail
- Esto exporta los datos solo de ese pago específico
Varios períodos de pago
Para exportar un CSV que abarque varios períodos de pago:
- Vaya a Dashboard -> Payouts
- Haga clic en Export en la esquina superior derecha
- Seleccione Payout summary o Payout detail
- Elija su rango de fechas (basado en la fecha de la transacción del pedido)
- Haga clic en Generate report
Nota: El formato de reporte heredado sigue disponible en las páginas de pagos individuales hasta el 31 de julio de 2025, para facilitar la transición a nuestros nuevos reportes.
Tipos de reporte
Reporte Payout summary
El reporte Payout summary ofrece una vista completa de cada pedido. Cada pedido aparece en su propia fila, lo que facilita el seguimiento de totales y tasas por pedido. Este reporte es ideal para una conciliación rápida y para comprender el importe neto que recibirá por cada pedido. A continuación se muestra una lista de las columnas del reporte:
| Columna↕ | Descripción↕ |
|---|---|
| account_name | El nombre de su cuenta de Zonos |
| payout_date | La fecha en que se procesó el pago |
| arrival_date | La fecha en que el pago llegó a su cuenta |
| payout_number | Identificador único del pago |
| payout_total | Importe total del pago |
| currency | Código de moneda del pago (p. ej., USD) |
| transaction_id | Identificador único de la transacción |
| transaction_date | Fecha en que ocurrió la transacción |
| order_number | Identificador de pedido de Zonos |
| order_reference | Número de referencia del pedido de su plataforma |
| order_date | Fecha en que se realizó el pedido |
| transaction_type | Tipo de transacción (ORDER, ORDER_REFUND, ORDER_CANCEL) |
| item_order | El importe total que los compradores pagaron por productos |
| shipping_order | El importe total que los compradores pagaron por envío |
| discount_order | Los descuentos aplicados al pedido |
| duty_tax_fee_order | El importe total que los compradores pagaron por derechos, impuestos y otras tasas |
| guarantee | El importe total que Zonos recaudó para cubrir derechos, impuestos y tasas garantizados |
| transaction_fee | Las tasas totales por el uso de los servicios de Checkout |
| merchant_fee | Las tasas totales de procesamiento de pagos |
| other | Cualquier cargo misceláneo con notas que proporcionan detalles |
| settled | El importe final liquidado del pedido |
| memo | Información adicional sobre la transacción |
Reporte Payout detail
Además del reporte de resumen, puede descargar un reporte de details más detallado para cada pago. Este reporte ofrece un desglose línea por línea de las transacciones y tasas asociadas al pago. Los costos que se compensan (como el impuesto que paga un comprador y que Zonos retiene para pagar en nombre del comerciante) no se incluyen en este reporte. A menudo habrá varias filas por pedido, ya que cada tipo de cargo aparece en su propia línea. El reporte de detalles es útil para conciliar sus registros financieros y comprender las tasas asociadas a cada transacción.
Tipos de cargo del reporte Payout detail
A continuación se muestra una lista de posibles partidas que puede ver en un reporte Payout detail y sus descripciones:
| Tipo de cargo↕ | Tipo↕ | Descripción↕ |
|---|---|---|
| ZONOS_MERCHANT_PROCESSING | Tasa de facturación de Zonos | Tasas de comerciante por procesamiento de pagos. |
| ZONOS_TRANSACTION | Tasa de facturación de Zonos | Tasa de transacción de Zonos Checkout. |
| CURRENCY_CONVERSION_FEE | Tasa de facturación de Zonos | Prima de cobertura de cambio por riesgo de tipo de cambio. |
| ZONOS_LANDED_COST | Tasa de facturación de Zonos | Tasa de garantía de Zonos Landed Cost. |
| ZONOS_LANDED_COST_GUARANTEE | Tasa de facturación de Zonos | Tasa de garantía para cálculos de landed cost. |
| ADVANCEMENT | Tasa del transportista | Cobrado por el transportista; consulte la columna memo de Payout para más detalles. |
| BROKERAGE_FEE | Tasa del transportista | Cobrado por el transportista; consulte la columna memo de Payout para más detalles. |
| SHIPPING_AMOUNT | Partida de subtotal del pedido | Total de envío del pedido, utilizado para asegurar que las líneas de cargo sumen el total del pedido. |
| PRODUCT_AMOUNT | Partida de subtotal del pedido | Total del carrito del pedido, utilizado para asegurar que las líneas de cargo sumen el total del pedido. |
| DUTY_TAX_AMOUNT | Partida de subtotal del pedido | Total de derechos/impuestos del pedido antes de retenciones, utilizado para asegurar que las líneas de cargo sumen el total del pedido. |
| TAX | Partida de subtotal del pedido | Total de impuestos del pedido, utilizado para asegurar que las líneas de cargo sumen el total del pedido. Retenido para remisión de impuestos. |
| DUTY | Partida de subtotal del pedido | Total de derechos del pedido, utilizado para asegurar que las líneas de cargo sumen el total del pedido. Retenido para remisión de impuestos. |
| GUARANTEE_PERCENT | Tasa de facturación de Zonos | Tasa de garantía basada en porcentaje para derechos e impuestos. |
| GUARANTEE_ORDER | Tasa de facturación de Zonos | Tasa de garantía de tarifa fija por pedido. |
| TRANSACTION_ORDER | Tasa de facturación de Zonos | Tasa de transacción de tarifa fija por pedido. |
| TRANSACTION_PERCENT | Tasa de facturación de Zonos | Tasa de transacción basada en porcentaje. |
Tipos de transacción
Los reportes de pagos incluyen distintos tipos de transacciones:
| Tipo de transacción↕ | Descripción↕ |
|---|---|
| ORDER | Transacciones de pedido regulares en las que se recibieron fondos. |
| ORDER_REFUND | Transacciones en las que se devolvieron fondos al cliente. |
| ORDER_CANCEL | Transacciones en las que los pedidos se cancelaron antes del procesamiento. |
| Charge | Transacciones no asociadas a un pedido que representan un cargo. |
| Credit | Transacciones no asociadas a un pedido que representan un crédito. |
Recuperar detalles de pagos mediante API
Además de exportar reportes CSV desde Dashboard, puede recuperar el mismo desglose de detalles de pagos de forma programática a través de la API GraphQL de Zonos. Esto es útil para sincronizar automáticamente los datos de pagos con sus propios sistemas de contabilidad o conciliación.
Recibir notificaciones con el webhook ORDER_PAYOUT_DETAILS_READY
Suscríbase al webhook ORDER_PAYOUT_DETAILS_READY para recibir una notificación cuando los
detalles de partidas de un pago estén disponibles para consulta. Recibirlo significa que el
desglose del pago es definitivo y seguro para extraer. El webhook entrega el payoutId
que utiliza para obtener los detalles; no incluye los detalles en sí. Consulte la
guía de webhooks para aprender a configurar webhooks.
{ "payoutId": "payout_xxxxxxxxxxxxx", "eventType": "ORDER_PAYOUT_DETAILS_READY"}Consultar detalles de pagos
Pase el payoutId a la consulta
orderPayoutDetails. Devuelve
una conexión paginada de partidas
OrderPayoutDetailItem,
una fila por transacción, que refleja el reporte CSV Payout detail
descrito en
Exportar reportes CSV
anteriormente.
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 } }}La conexión también expone un campo totalAmount: la suma de amount en las
partidas visibles para su organización, de modo que puede obtener el total del pago
sin sumar cada página manualmente.
Ver pagos
Aprenda a acceder y comprender los detalles de sus pagos de Checkout.
Acceda y consulte fácilmente sus reportes de pagos en el Dashboard de Zonos. Los pagos se generan periódicamente y ofrecen un desglose detallado de transacciones, tasas e importes netos al usar Zonos Checkout. Los pagos se emiten en la moneda local que seleccionó al configurar su cuenta. Estos reportes le ayudan a conciliar registros financieros y realizar el seguimiento de sus ingresos.