构建报告

Yuno 报告提供了一种获取不同支付阶段信息的实用方法。您可以轻松申请和下载与 Yuno 业务相关的各种报告。Yuno 提供四种类型的报告：

• Payment
• 交易
• 交易对账
• 定居

您可以访问报告字段文档，查看每种报告的详细说明。交易对账和结算报告提供与对账相关的信息。要查看每个报告的所有字段及其说明，请访问报告字段页面。

要求

如需申请报告，您需要

• 访问您的 应用程序接口凭据 在 Yuno 控制面板上，它包括
  • public-api-key
  • private-secrete-key

📘

探索汤野Postman 作品集

Yuno 提供Postman Collections，您可以用它在本地复制用例。

步骤摘要

使用 Yuno 时，接收报告的过程包括两个步骤：

1. 创建报告
2. 下载报告

访问报告

如步骤摘要所示，在访问报告之前，您需要完成两个步骤。

步骤 1：创建报告

要启动报告生成流程，请使用 创建报告endpoint.首先，选择所需的报告类型 (type)，这将决定生成报告的内容。其次，通过设置参数来定义希望将数据纳入报告的日期范围 start_date 和 end_date.

创建报告时，可以通过指定某些字段的值来过滤添加的数据。例如，您可能只想接收与在阿根廷和巴西进行的交易有关的数据。在这种情况下，您可以提供 AR,BR 参数的内容 country.

创建报告时，您可以选择过滤以下字段：

• payment_status
• payment_sub_status
• payment_method
• currency
• country
• transaction_type
• transaction_status
• updated_at_start
• updated_at_end

📘

筛选值格式

定义筛选器值时，以字符串值列表的形式提供，如下面的示例： "payment_status": "CREATED,READY_TO_PAY,DECLINED"

对于付款或交易报告，您还可以使用参数"...... "选择最终报告中包含的字段。 columns.

当您使用 创建报告endpoint 请求创建报告，您将在收到回复后收到报告 id 和 status.您将使用 id 申请下载报告时 步骤 3.......。 status 通知是否可以下载。

第 2 步：检查报告是否准备就绪

请求创建报告后，可以使用endpoints 检索报告 或 列出所有报告 以检查是否可以下载。当使用 检索报告endpoint您需要提供报告 id.另一方面，由于 列出所有报告endpoint您需要通知您的 account_id 以获取所有现有报告及其状态的列表。

当报告的状态为 SUCCEEDED您可以申请下载。访问 报告状态页面 检查所有可能的报告状态。

第 3 步：下载报告

使用 下载报告 收到您的报告，并提供其 id.您将收到 .zip 文件格式的报告。但是，对于结算报告，API 将返回一个 .csv 文件。