Acquiring（收单）

本页说明 Acquiring 钱包模式和 Checkout 模式的订单终态通知。

通知以 HTTP POST 发送。请按配置和重试约定验签、幂等处理并返回 HTTP 200。不要把此通知格式与查询接口的响应格式混用。

通知 Body

参数	类型	说明
partner_id	String	MusePay 分配的合作伙伴账户 ID。
customer_ref_id	String	客户关联 ID，有值时返回。
order_no	String	MusePay 订单号。
request_id	String	合作伙伴提供的订单请求号。
order_type	String	交易类型，参见订单类型。
product_code	String	交易产品编码。
currency	String	订单通知中的币种代码。
order_amount	String	请求的订单金额。
pay_amount	String	实际支付金额。
fee_amount	String	服务费金额。
settle_currency	String	结算币种代码。
actual_amount	String	以 settle_currency 计价的实际结算金额。
finish_time	String	通知所取订单的更新时间，以 Unix 毫秒时间戳字符串返回。
status	Number	终态订单状态：99（成功）、44（失败）、88（关闭）。参见订单状态。
reason	String	失败或关闭原因，有值时返回。
extra_info	JSON String	包含订单可选扩展字段的 JSON 字符串。
sign	String	Base64 编码签名，参见 Webhook 配置。

pay_amount 可能因少付或多付与 order_amount 不同，参见支付金额处理。

Extra Info

extra_info 是 JSON 字符串，需再次解析。以下字段均为可选，按实际订单数据返回；空字符串字段不返回。字段名区分大小写。

通用字段

参数	类型	说明
payType	String	支付类型。
paymentMethod	String	订单支付方式。
productName	String	支付关联的商品名称。
customerRefId	String	合作伙伴提供的客户关联 ID。
description	String	请求中的描述信息。
remark	String	订单备注。
email	String	订单关联的电子邮箱。
exchangeRate	String	订单记录的汇率，需结合订单交易对理解。
symbol	String	汇率对应的交易对。
rateTime	Number	汇率时间，Unix 毫秒时间戳。

链上交易与支付字段

参数	类型	说明
sourceAddress	String	链上来源地址。
sourceTag	String	来源地址的 Tag 或 Memo，按网络返回。
destinationAddress	String	链上目标地址。
destinationTag	String	目标地址的 Tag 或 Memo，按网络返回。
txnHash	String	链上交易 Hash。
blockHeight	String	区块高度，以字符串返回。
numOfConfirms	String	通知时的确认数，以字符串返回。
network	String	区块链网络标识。