🪙 加密货币收付款总览

欢迎使用加密货币收付款 API 整合文档！本组为渠道型加密货币（第三方渠道结算）的收款与付款统括文档，覆盖 USDT 与 JPYC 两种币种的代收、代付、查询与回调接入。

⚠️ 先确认：您要接入的是哪一种加密货币收付？

本系统提供三种不同模型的加密货币收付，接口与订单体系完全不同，请先依后台分配给您的 service_id 与币种确认您的模型，再选择对应文档：

	自有钱包 TRC20	渠道型 USDT（本组）	渠道型 JPYC（本组）
模型	平台自有 TRON 钱包	第三方渠道结算	第三方渠道结算
代收 service_id	无需（专属接口）	SVC0086	SVC0087
代付方式	POST /gateway/api/v1/tron/payout-txns	SVC0077 + currency=usdt	SVC0077 + currency=jpyc
链	TRON	TRON	ETHEREUM
对应文档	TRC-20（自有钱包）	本组	本组

💡 若您不确定开通的是哪一种，请联系您的商务经理确认 service_id 与币种。

📋 概览

渠道型加密货币收付通过标准代收 / 代付接口与第三方渠道结算，整体资金流如下：

代收（Deposit）流程

1. 商户调用创建收款单，依币种填入对应 service_id（USDT = SVC0086、JPYC = SVC0087）。
2. 我方接口返回收银台地址 link，商户将付款人引导至 link。
3. 收银台展示渠道返回的收款地址、二维码与链别，付款人完成链上转账。
4. 上游渠道确认到账后结算并回调通知到商户的 notify_url，代收成功即上分。

代付（Withdraw）流程

1. 商户调用创建出款单，固定填 service_id=SVC0077，由 currency 决定币种与链（usdt → TRON 地址 / jpyc → ETHEREUM 地址），number 填收款链上地址。
2. 我方调用上游渠道发起链上打款。
3. 上游处理结果回调到商户的 notify_url：代付成功 = 打款，代付失败 = 退款。

💡 收款地址、链别、二维码均由收银台 / 上游渠道负责展示与生成，不在 API 直接返回；商户只需把付款人导向 link（代收）或提供 number 收款地址（代付）即可。

支持的功能

功能	说明
代收 (Deposit)	创建渠道型加密货币代收订单
代付 (Withdraw)	创建渠道型加密货币代付订单
订单查询	查询代收 / 代付订单状态
回调通知	接收代收 / 代付结果通知
余额查询	查询渠道可用余额

🚀 快速开始

1. 获取 API 凭证

请联系客服获取：

• platform_id - 商户 ID
• 签名密钥 - 用于请求签名（签名说明）
• service_id - 确认您开通的币种与收付方向

2. service_id 对照

方向	币种	链	service_id	currency
代收	USDT	TRON	SVC0086	由 service_id 决定
代收	JPYC	ETHEREUM	SVC0087	由 service_id 决定
代付	USDT	TRON	SVC0077	usdt
代付	JPYC	ETHEREUM	SVC0077	jpyc

加密货币代付统一使用通用入口 service_id=SVC0077，靠 currency 区分币种与链。未来新增加密币只需扩展 currency 值，service_id 不变。

3. 选择您需要的 API

• 代收下单：创建收款单（渠道型）
• 代收查询：查询收款单
• 代收回调：收款结果通知
• 代付下单：创建出款单（渠道型）
• 代付查询：查询出款单
• 代付回调：出款结果通知
• 余额：查询渠道余额

📞 联系支持

如有任何问题，请联系您的商务经理。