一单一付(用户付款)

1. 概述

一单一付 (TO C) 模式由 CatFee 提供,主要面向钱包厂商或支付平台。 该模式下,由最终用户直接支付能量/带宽资源费用,钱包厂商无需预存资金即可为用户提供实时能量服务。

适用于 兑换、MEME 币交易等对实时性要求高的业务场景,能显著提升用户体验。

模式优势

  1. 用户体验好:实时发起合约时,自动获取所需能量,整个过程无感知。

  2. 钱包无需垫资:不需要钱包预先充值或锁定资金。

  3. 账务透明:所有资源代理、支付交易均在 TRON 链上可查,账务可追溯。


2. 接入流程

钱包需要对接 CatFee 的开放 API,实现资源费用查询、交易创建、支付确认。

流程语言描述

  1. 用户发起合约 用户在钱包中发起一次智能合约调用(如兑换、转账),此时交易尚未广播。

  2. 查询资源费用 钱包调用 /v1/mate/open/transaction/estimate 向 CatFee 请求所需能量/带宽的费用,CatFee 返回预估结果,钱包将费用展示给用户。

  3. 创建代理资源交易 钱包调用 /v1/mate/open/transaction,由 CatFee 返回一笔已签名但未广播的 代理能量交易。这笔交易稍后会用于为用户补充能量。

  4. 用户确认支付 钱包提示用户支付资源费,用户确认后,钱包生成一笔 支付资源费交易(未广播)。

  5. 依次广播交易 钱包依次将三笔交易广播到 TRON 网络:

    • 代理资源交易(确保用户能量充足)

    • 用户智能合约交易(完成业务逻辑)

    • 用户支付资源费交易(支付给 CatFee)

  6. 提交支付 HASH 钱包调用 /v1/mate/open/transaction/pay/{order_id},将用户支付交易的 HASH 提交给 CatFee。

  7. CatFee 对账与确认 CatFee 定时扫描链上:

    • 若支付成功 → 更新订单为 成功

    • 若支付失败 → 更新订单为 失败,并将结果反馈给钱包。

时序图


3. API 接口说明

3.1 预估所需资源费用

接口POST /v1/mate/open/transaction/estimate

描述: 钱包调用此接口,获取执行用户合约所需的能量/带宽费用。

详细说明点击这里


3.2 创建代理资源交易

接口POST /v1/mate/open/transaction

描述: CatFee 返回一个未广播的代理资源交易(能量代理),钱包负责后续广播。

详细说明点击这里


3.3 提交支付 HASH

接口POST /v1/mate/open/transaction/pay/{order_id}

参数

  • hash:用户支付资源费的交易 HASH

描述: 钱包在用户完成支付后,将支付交易 HASH 提交给 CatFee,CatFee 定时扫描链上确认支付情况,并更新订单状态。

详细说明点击这里


4. 对账与异常处理

  1. 支付校验

    • CatFee 会定时扫描链上确认支付交易。

    • 若支付成功 → 更新订单为 成功

    • 若支付失败 → 更新订单为 失败,并反馈给钱包。

  2. 异常场景

    • 用户未及时支付 → 订单会进入 失败状态

    • 钱包需根据反馈信息决定是否提示用户或重试。


5. 接入要点总结

  • 钱包端职责

    • 发起合约前,先查询所需能量费用

    • 请求 CatFee 生成资源代理交易

    • 负责广播代理交易、合约交易、支付交易

    • 将支付 HASH 提交给 CatFee

  • CatFee职责

    • 提供资源费用估算

    • 返回未广播代理交易

    • 校验用户支付交易并更新订单状态

    • 提供失败订单反馈


📌 一单一付模式适合:

  • 钱包厂商无需自备能量池

  • 需要实时完成交易(兑换、MEME 币等高频操作)

  • 强调用户自主支付与账务透明

Last updated

Was this helpful?