For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fiat Payout(法币出款)

本页说明法币出款订单的终态通知。创建接口成功只表示请求已受理,最终结果以通知或查询为准。

通知以 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 配置。

金额字段均为十进制字符串。出款的支付金额与法币结算金额可能采用不同币种;actual_amount 以 settle_currency 计价,不应直接与 pay_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 毫秒时间戳。

出款与收付款账户字段

参数
类型
说明

country

String

出款关联的国家。

payerAccount

String

付款账户。

payerAccountName

String

付款账户持有人名称。

payerBankSwiftCode

String

付款银行 SWIFT 代码。

beneficiaryName

String

收款人名称。

beneficiaryBankCode

String

收款银行代码。

beneficiaryWallet

String

收款钱包标识。

beneficiaryAccountNumber

String

收款账号。

beneficiaryAccountType

String

收款账户类型。

beneficiaryEmail

String

收款人电子邮箱。

beneficiaryPhoneAreaCode

String

收款人电话国家或地区区号。

beneficiaryPhone

String

收款人电话号码。

documentId

String

订单记录的身份证件号码。

documentType

String

订单记录的身份证件类型。

bankRoutingCode

String

银行路由代码。

userInfo

Object

法币出款相关的扩展信息,键和值均为字符串;具体内容随出款业务而异,可能为空对象。

最后更新于