QR 码和即时支付

在QR 码和即时支付流程中，Yuno 只需出示一个 QR 码，就能立即向客户收取费用，并在一个无缝步骤中为客户注册所有未来的定期支付。当客户扫描二维码时，他们的银行应用程序就会处理第一笔分期付款，同时获取他们对后续自动收费的同意，无需任何额外的审批或手动输入。

首次扫描和付款后，商户将通过 Yuno 发送后续请求，并由客户的银行根据最初的同意自动进行验证，从而确保快速、可靠的转账，而无需与客户进一步互动。这一流程将注册和支付合并为单个用户操作，从而最大限度地提高了转化率，简化了订购管理。

第 1 步：首次付款和创建订阅

要启动流程，必须从一个标准的像素支付同时设置订阅。这将生成一个二维码或重定向屏幕，供客户授权重复使用。一旦付款，订购就会创建，并生成一个 subscription_id 返回。

您可以定义频率、可用性窗口和金额类型（固定或可变），作为订阅有效载荷的一部分。

订阅字段	说明
频率	定义订阅收费的频率（每天、每周或每月），指定下一个账单周期需要收取的金额。
可用性	订阅的开始和结束日期。
金额	定义用于未来支付订阅费用的值。可以是 `FIXED` 定义了最小值，或 `VARIABLE` 未确定未来付款金额。

如前所述，订阅创建时定义的信息将限制用于未来付款的日期和值。

{
  "amount": {
    "value": "100",
    "currency": "BRL"
  },
	"payment_method": {
        "type": "PIX_AUTOMATIC"
	},
	"subscription": {
    "frequency": {
      "type": "MONTH",
      "value": 1
    },
    "availability": {
      "start_at": "2025-05-23T20:17:30.277678Z",
      "finish_at": "2027-05-23T20:17:30.277678Z"
    },
    "amount": {
      "value": "100",
      "currency": "BRL",
      "type": "FIXED" // or "VARIABLE"
    }
  }

首次付款确认后，客户的订购就激活了，您就可以开始安排未来的收费。

第 2 步：未来付款

根据中央银行的规定，付款必须在预定账单日期前 2 天创建，并在订阅创建后至少 10 天创建。使用 subscription_id 来识别付款创建的重复性。

未来付款字段
`subscription_id`	第一步获得的订阅 ID。
账单日期	通过指定 billing_date 对象，商家可以定义订阅计费确切日期背后的逻辑。

"workflow": "DIRECT",
"amount": {
  "value": "100",
  "currency": "BRL"
},
"payment_method": {
  "type": "PIX_AUTOMATIC",
},
"subscription": {
  "id": "cab9f0fe-2428-419b-8f9d-4b5efee8c1c8",
  "billing_date": {
    "type": "DAY",
    "day": 14
  }
}

如果定期付款失败，可以使用新的付款请求进行重试。重试必须在原始账单日期后7 天内进行，每个周期仅限重试 3 次。