主题
入款相关接口
创建充值订单
POST /api/mnt/v1/create/remittance
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo | string | 是 | 商户订单号，同一商户下唯一 |
balance | string | 是 | 订单金额 |
tokenType | string | 是 | 货币类型，如 USD |
notifyUrl | string | 否 | 订单状态回调 URL |
timestamp | long | 是 | 毫秒时间戳 |
sign | string | 是 | RSA 签名 |
请求示例
json
{
"orderNo": "RM1788149530103",
"balance": "120.5",
"notifyUrl": "",
"tokenType": "USD",
"timestamp": 1788149537100,
"sign": "LI0CdLB9lo12NNDD2XZIKA9rWQmQYdHTEBVAQ3YVuSxAKIUUshKlnvhOwPRCVnm68vDRSc+deQEie+4Z4w8ZXFMMzrlAuTelL4U4sa0OaxmUJa4Y56GwcqKkRnUyX5xnmzQPRNrC2BfIi/yW4ko7JpXqViBjijBmNTtWMlOqGmzDNVSdlSin7eGd6VpEAHgdLnxD4Ng7hzstxb5VUoIVAsIAv5Vs/e4Tg9HgAHt1LO8TUoDqp/MRNgdGQxeCubSJam7RKzwFIWbZ+S0YU8UVLQMgVD86AEyPtVFKD0GtvRwNaj9EsAQW2AvFfac4gxJnpJHzAh0aIg1+wCaqoadhdw=="
}响应 data：ResponseCreateRemittance
如果系统需要显示收款的二维码，只需要根据 invoiceText 的内容进行生成即可。金额、汇率等数值字段以字符串返回，便于签名验签。
| 字段 | 类型 | 说明 |
|---|---|---|
orderNo | string | 商户订单号 |
orderBalance | string | 订单金额（USD） |
invoiceId | string | BTCPay 发票 ID |
invoiceText | string | 支付票据详情（闪电网络票据），用于生成支付二维码 |
payState | int | 支付状态，见下方枚举 |
payDate | datetime | 支付时间 |
expireDate | datetime | 过期时间 |
createDate | datetime | 创建时间 |
rate | string | 兑换比例 |
tokenType | string | 货币类型 |
timestamp | long | 毫秒时间戳 |
sign | string | RSA 签名 |
json
{
"code": 200,
"data": {
"orderBalance": "120.5",
"orderNo": "RM1788149530103",
"invoiceId": "P3XVLNSbSQS6iiVGdDZz7t",
"invoiceText": "lnbc1553120n1p4fflepsp5g3y7xm59ju5vpx2rvpqt0yn4s9lqhkr7fal6w60erhgjg0hplqtspp56s2jjwyq4e5zd989mnmznqn0r7cvtjxj6pev42dmemspudxuzy3sdpa2pskjepqw3hjqmr4yp3ksetwvuszsnmjv3jhygzfgsazqer9wccrzvjlxyujjxqrpc8cqpjrzjqfphcq80th3xs6nt6c8c4j6us0ghqyy3vqg2zh68n400snqy7pzg2r4nu5qq8wqqqqqqqqqqqqqqqeqqjq9qxpqysgq37v2kh8zja2p4wwk4l8ukhncfanks8sfa40wx8nca7szcc2pk47xfmznjtz35dzuzmw7p2as4yp4m2uclgdj739fz9e8etspg0xxmlqpc3cju5",
"payState": 0,
"expireDate": "2026-08-31T04:42:17.000+00:00",
"createDate": "2026-08-31T04:12:17.124+00:00",
"rate": "77586",
"tokenType": "USD",
"timestamp": 1788149537100,
"sign": "Base64RSASign..."
},
"msg": "success"
}充值支付状态 payState
| 值 | 说明 |
|---|---|
0 | 待支付 |
1 | 支付成功 |
-1 | 已过期 |
-2 | 异常/回退 |
查询入单记录
POST /api/mnt/v1/queryRemittance
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo | string | 是 | 商户充值订单号 |
timestamp | long | 是 | 毫秒时间戳 |
sign | string | 是 | RSA 签名 |
请求示例
json
{
"orderNo": "RM1788149530103",
"timestamp": 1788149611083,
"sign": "aU9owxAi2865uHk4Px5NQaw6HM+XUeOGT8qA8t7DjdvWTc3t1lccWACL6uIindG/SELkP20/VxNfrRu1DoAJ/9HqwhZZaNOZAoMypdb+IPGyUIXZObX+I4M2WvNubO5VmTrh/tDP4Sc8uMxWdGUmgAemeqdY7Cab6Xq63EY7ZLgMO3ThlwLVlt6mtZo+lMsFSWugQ91+5T5jDhRNvEoWPH/4sO+DSXMUrKK2oBNSoYiY8jcW31FYdTP/dWPJIYRR+s974j/jFhXGdC6WD9ogDBQilZGy9BQ88iP7F6XQC7/85PEjWjPGWA15gB22yrPUeRMH69d6NOx5VX+1Rix8Nw=="
}响应 data
结构同 创建充值订单 的 ResponseCreateRemittance。
订单不存在时返回错误：订单不存在。 如果系统需要显示收款的二维码，只需要根据invoiceText的内容进行生成即可
json
{
"code": 200,
"data": {
"orderBalance": "120.5",
"orderNo": "RM1788149530103",
"invoiceId": "P3XVLNSbSQS6iiVGdDZz7t",
"invoiceText": "lnbc1553120n1p4fflepsp5g3y7xm59ju5vpx2rvpqt0yn4s9lqhkr7fal6w60erhgjg0hplqtspp56s2jjwyq4e5zd989mnmznqn0r7cvtjxj6pev42dmemspudxuzy3sdpa2pskjepqw3hjqmr4yp3ksetwvuszsnmjv3jhygzfgsazqer9wccrzvjlxyujjxqrpc8cqpjrzjqfphcq80th3xs6nt6c8c4j6us0ghqyy3vqg2zh68n400snqy7pzg2r4nu5qq8wqqqqqqqqqqqqqqqeqqjq9qxpqysgq37v2kh8zja2p4wwk4l8ukhncfanks8sfa40wx8nca7szcc2pk47xfmznjtz35dzuzmw7p2as4yp4m2uclgdj739fz9e8etspg0xxmlqpc3cju5",
"payState": 0,
"expireDate": "2026-08-31T04:42:17.000+00:00",
"createDate": "2026-08-31T04:12:17.124+00:00",
"rate": "77586",
"tokenType": "USD",
"timestamp": 1788149611083,
"sign": "Base64RSASign..."
},
"msg": "success"
}回调通知
平台在入款成功后，若创建订单时配置了 notifyUrl，会向该地址发起异步回调。
请收到通知后尽快返回成功应答。建议先落库/入队，再异步查询订单状态确认（切记：不能在返回成功应答之前同步查询平台接口）。
注意事项
- 平台可能对同一订单发送不止一次通知，请务必按订单号做幂等处理，避免重复入账或重复业务操作。
- 收到回调后不要执行任何可能导致阻塞的操作（如同步查单、远程调用、复杂计算等），否则可能引发超时，导致平台重试通知。
回调方式
| 项 | 说明 |
|---|---|
| 方法 | POST |
| URL | 创建入款订单时传入的 notifyUrl |
| Content-Type | application/json |
| 超时 | 10 秒 |
| 失败重试 | 失败后按间隔重试，超过重试次数后停止 |
请求头
| 字段 | 说明 |
|---|---|
api-key | 商户 API Key，用于识别商户身份 |
Content-Type | application/json |
请求体
结构为 ResponseCreateRemittance（与创建/查询入款订单的 data 一致）。签名规则见 签名说明。
字段说明见上方 创建充值订单 的 ResponseCreateRemittance；回调时 payState 一般为支付成功 1。
请求示例
json
{
"orderBalance": "120.5",
"orderNo": "RM1788166073913",
"invoiceId": "KGeCKanb645jmpij9cdMzm",
"invoiceText": "lnbc1538340n1p4f20ausp5kkd55nlptw7n6vkfeusrj6302wafawwhnf2np5mke04zjs7xy3yspp5yy50qvqlxwkvt9qv6dnesjtzzmcckmky96d6s9axtnu7aqsvnmfqdpa2pskjepqw3hjqmr4yp3ksetwvuszsnmjv3jhygzfgsazqer9wccrzvjlxgcjjxqrpc8cqpjrzjqfphcq80th3xs6nt6c8c4j6us0ghqyy3vqg2zh68n400snqy7pzg2r4suvqqfncqqqqqqqqqqqqqqeqqjq9qxpqysgqd3kyvnz895j7j50mxzth5ys5hxxyusxvh4dxdgz0mqp47hy587kq2eeeg07pupjany7gtgnt9f4zn9dgjadlprn0cmgftna5axhjtjgphfgqnh",
"payState": 1,
"payDate": 1788166099528,
"expireDate": 1788167876000,
"createDate": 1788166075104,
"rate": "78331.3",
"tokenType": "USD",
"timestamp": 1788166461270,
"sign": "B6Qv+gx+CM4Cngz0lHxbd6BELHuBUl/aSBFcJWQfH3w0XFSffiLXNJ4UiR239a30BE7Tx/QjAXY71cLZ5mXvSm0IuCxY7EvKnNoIXLAnsuSj/2GEEnSNcRqOJlcLQ2FkdReJ6vMic2HzpQ9RhVSdObOuzs2Kt9LtR6uGaFn3TKiP1ki5wg7SVWrd/HhQtWdwaCagwTPWXHavcHMe9bjXAIvT4aGD7xxTEAB7+AB/XtCxLgTLgoGC77wt3LE1B33gKqwmNH7StAmmjwntAwxR/5W8tLd52keAPPhtHlJvFnuE8gJDW+kKkzfqGb+DF/gwnwwSjvhwx6uTe+yz3RBeYw=="
}商户应答
平台解析返回的 JSON，要求：
code为200data为字符串SUCCESS（大小写不敏感）
满足以上条件视为回调成功，否则视为失败并进入重试。
json
{
"code": 200,
"data": "SUCCESS",
"msg": "success"
}