{"info":{"_postman_id":"5784bb7a-1c94-4789-8d51-c99c3f10f69b","name":"Bit2Go API","description":"<html><head></head><body><p><strong>Bit2Go 致力于将链上资产无缝带入现实世界，让加密货币真正可用、可流通、可消费。</strong></p>\n<p>面向企业，Bit2Go 提供虚拟卡、全球收款账户（VA）、全球汇款及加密货币与法币之间的换汇能力，帮助企业将数字资产直接用于现实世界的支付与资金流转。</p>\n<p>面向用户，Bit2Go 正在构建一体化数字资产钱包，支持多链资产管理、转账、DeFi 与理财，并通过虚拟卡与法币通道，使加密资产可以像法币一样用于日常消费与收付。</p>\n<p>通过统一的资金账户与多币种支持，Bit2Go 连接加密金融与传统金融体系，构建面向未来的资产使用方式。</p>\n<h2 id=\"🔖-接入-api-的工作流程\">🔖 接入 API 的工作流程</h2>\n<ul>\n<li><p>注册账号 <a href=\"https://bit2go.io\">bit2go.io</a></p>\n</li>\n<li><p>启用测试模式，便于开发调试与流程验证</p>\n</li>\n<li><p>在商户设置 - 开发者菜单，获取以下信息：</p>\n<ul>\n<li><p>Merchant ID - 商户号</p>\n</li>\n<li><p>API Token &amp; API Key - 获取令牌和秘钥，授权可访问的 Bit2Go API 资源和配置 IP 地址白名单</p>\n</li>\n<li><p>Webhook - 异步回调通知地址，配置需要监听的通知事件开发者工具</p>\n</li>\n<li><p>模拟交易 - 供开发者在沙箱环境下测试和调试资金流、回调处理逻辑等</p>\n</li>\n</ul>\n</li>\n<li><p>对接成功后，关闭测试模式，更换正式域名与商户号，且配置 API Key &amp; Webhook</p>\n</li>\n</ul>\n<h2 id=\"api-请求域名\"><strong>API 请求域名</strong></h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>环境</th>\n<th>域名</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>正式</td>\n<td><a href=\"https://openapi.bit2go.io\">https://openapi.bit2go.io</a></td>\n</tr>\n<tr>\n<td>测试</td>\n<td><a href=\"https://test-openapi.bit2go.io\">https://test-openapi.bit2go.io</a></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"数据交互说明\"><strong>数据交互说明</strong></h2>\n<ul>\n<li><p>接口之间的签名和验签支持采用 <em><strong>MD5 或 RSA</strong></em></p>\n</li>\n<li><p>采用 HTTP 协议标准的 <em><strong>POST</strong></em> 方式调用接口</p>\n</li>\n<li><p>字符编码采用 <em><strong>UTF-8</strong></em> 编码</p>\n</li>\n<li><p>商户调用平台 API，发送的 POST 请求 Content-Type 采用 <em><strong>application/json</strong></em></p>\n</li>\n<li><p>商户调用平台 API，平台响应的 Content-Type 采用 <em><strong>application/json</strong></em></p>\n</li>\n</ul>\n<h2 id=\"请求方式\">请求方式</h2>\n<p>所有请求 Bit2Go API 都需要携带下面的 Header 参数：</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Header</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>Merchant</code></td>\n<td>商户ID</td>\n</tr>\n<tr>\n<td><code>Timestamp</code></td>\n<td>发起请求的时间对应的时间戳（UTC）（系统只处理最近 1min 内的请求）如: 1729590116</td>\n</tr>\n<tr>\n<td><code>Token</code></td>\n<td>API Key 的令牌（在开发者菜单获取）</td>\n</tr>\n<tr>\n<td><code>Sign</code></td>\n<td>数据签名  <br>MD5(json_body + timestamp + API Key)  <br>Base64(RSA-SHA256-Sign(json_body + timestamp))</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>MD5 签名大小写不敏感 </p>\n</blockquote>\n<blockquote>\n<p>RSA 签名方式为<strong>“使用 SHA256 摘要后通过 RSA 私钥签名，最终生成的签名需要使用 Base64 编码，不是 RSA 加密！”</strong></p>\n</blockquote>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1700178","collectionId":"5784bb7a-1c94-4789-8d51-c99c3f10f69b","publishedId":"2sAXxY5UoF","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-10-22T14:58:16.000Z"},"item":[{"name":"Core API","item":[{"name":"Balance","event":[{"listen":"test","script":{"id":"c7854cc7-591f-44b0-8889-9ab2de990f1d","exec":[""],"type":"text/javascript","packages":{}}}],"id":"4cd66cca-e2cf-4f6b-a28e-e4ca121e712b","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/balance","description":"<p>获取当前商户的钱包余额</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>说明</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>币种</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>币种代码（如 <code>USD</code>、<code>USDT</code>、<code>BTC</code> 等）</td>\n</tr>\n<tr>\n<td>available_amount</td>\n<td>string</td>\n<td><strong>可用余额</strong>，可立即使用</td>\n</tr>\n<tr>\n<td>receivable_amount</td>\n<td>string</td>\n<td><strong>在途入金</strong>（待入账，如待结算的收款）</td>\n</tr>\n<tr>\n<td>payable_amount</td>\n<td>string</td>\n<td><strong>在途出金</strong>（待出账，如待处理的代付/速汇）</td>\n</tr>\n<tr>\n<td>total_amount</td>\n<td>string</td>\n<td><strong>账面总额</strong>，通常为可用 + 受限（不含在途）</td>\n</tr>\n<tr>\n<td>reserved_amount</td>\n<td>string</td>\n<td><strong>受限资金</strong>（冻结 + 保证金/押金等不可用部分）</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","balance"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"66b5dbc3-f9e5-42e9-89f5-17d8d0713b43","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/balance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": [\n        {\n            \"currency\": \"USD\",\n            \"available_amount\": \"2.38\",\n            \"receivable_amount\": \"0\",\n            \"payable_amount\": \"0\",\n            \"total_amount\": \"2.38\",\n            \"reserved_amount\": \"0\"\n        }\n    ]\n}"}],"_postman_id":"4cd66cca-e2cf-4f6b-a28e-e4ca121e712b"}],"id":"7e98c92c-fb24-4d62-9ac4-0b75d566d0b9","_postman_id":"7e98c92c-fb24-4d62-9ac4-0b75d566d0b9","description":""},{"name":"Payment API","item":[{"name":"Create Invoice","event":[{"listen":"test","script":{"id":"c7854cc7-591f-44b0-8889-9ab2de990f1d","exec":[""],"type":"text/javascript","packages":{}}}],"id":"42a55e5d-1312-4793-b25e-9d68ef5afaaa","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USD\",\n    \"order_id\": \"123456\",\n    \"callback_url\": \"https://bit2go.io\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payment","description":"<p>创建数字货币收单、发票或链接支付</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>说明</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>是</td>\n<td>string</td>\n<td>订单金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>string</td>\n<td>订单货币；可以是法币和数字货币</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>callback_url</td>\n<td>否</td>\n<td>string</td>\n<td>当订单成功或过期，系统将发送通知给该地址，若商户配置了 Webhook，则通知只会往 Webhook 发送</td>\n</tr>\n<tr>\n<td>cancel_url</td>\n<td>否</td>\n<td>string</td>\n<td>当订单过期时，若用户访问了收银台链接，系统会将用户重定向到该地址</td>\n</tr>\n<tr>\n<td>success_url</td>\n<td>否</td>\n<td>string</td>\n<td>当订单成功时，若用户访问了收银台链接，系统会将用户重定向到该地址</td>\n</tr>\n<tr>\n<td>additional_data</td>\n<td>否</td>\n<td>string</td>\n<td>商户自定义数据，异步通知会包含该数据</td>\n</tr>\n<tr>\n<td>pay_currency</td>\n<td>否</td>\n<td>string</td>\n<td>支付货币，指定用户支付的数字货币</td>\n</tr>\n<tr>\n<td>discount_percent</td>\n<td>否</td>\n<td>int</td>\n<td>折扣或额外手续费的百分比： -99 ~ 100， 默认为 0；数值为正数时，为折扣；数值为负数时，为额外的手续费  <br />  <br />比如该字段值为 10，表示用户享受 10% 的折扣，商户创建 100 USDT 的订单，用户只需要支付 90 USDT，订单就会是 <code>paid</code> 状态  <br />  <br />比如该字段值为 -10，表示用户需要支付额外 10% 手续费，商户创建 100 USDT 的订单，用户需要支付 110 USDT，订单才会是 <code>paid</code> 状态  <br />  <br />用户实际付款的金额将添加进商户余额中</td>\n</tr>\n<tr>\n<td>lifetime</td>\n<td>否</td>\n<td>int</td>\n<td>订单的有效期，单位为秒：300 ~ 43200，默认为 3600</td>\n</tr>\n<tr>\n<td>percent_fee_paid_by_user</td>\n<td>否</td>\n<td>int</td>\n<td>用户承担手续费的比例：0 ~ 100，默认为 0  <br />  <br />比如商户的费率为 1%，商户创建 100 USDT 的订单手续费为 1 USDT，如果这时该字段值为 100（表示用户将支付 100% 的手续费），那么用户最终需要支付 101 USDT</td>\n</tr>\n<tr>\n<td>accuracy_payment_percent</td>\n<td>否</td>\n<td>float</td>\n<td>支付准确率： 0.00 ~ 10.00， 默认为 0  <br />  <br />比如该字段值为 5，那表示用户实际支付的金额只要在订单金额的 95% ~ 100% 订单都会是 <code>paid</code> 状态  <br />  <br />用户实际付款的金额将添加进商户余额中</td>\n</tr>\n<tr>\n<td>currencies</td>\n<td>否</td>\n<td>array</td>\n<td>指定用户支付时可使用的数字货币</td>\n</tr>\n<tr>\n<td>except_currencies</td>\n<td>否</td>\n<td>array</td>\n<td>指定用户支付时不可使用的数字货币</td>\n</tr>\n<tr>\n<td>mock_callback_status</td>\n<td>否</td>\n<td>string</td>\n<td>自定义订单在回调通知中的状态，仅适用于测试模式  <br />  <br />- paid: 支付成功  <br />- paid_over: 过度支付  <br />- partial_payment: 部分支付  <br />- cancel: 订单过期  <br />  <br />比如该字段值为 <code>paid</code> 时，商户在请求 API 成功后，Bit2Go 将会在 3s 后，自动发送 Webhook 到 <code>callback_url</code> 中，其中 <code>status</code> 字段将会是 <code>paid</code></td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>否</td>\n<td>string</td>\n<td>用于标识商户用户，相同 <code>customer_id</code> 的收单在同一币种和链路下会固定对应同一收款地址。</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"currencies-数据结构\"><em>currencies 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>数字货币</td>\n</tr>\n<tr>\n<td>network</td>\n<td>否</td>\n<td>区块链网络</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"except_currencies-数据结构\">except_currencies 数据结构</h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>数字货币</td>\n</tr>\n<tr>\n<td>network</td>\n<td>否</td>\n<td>区块链网络</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>订单金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>订单货币</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>additional_data</td>\n<td>string</td>\n<td>自定义数据</td>\n</tr>\n<tr>\n<td>discount_percent</td>\n<td>string</td>\n<td>折扣或额外手续费的百分比</td>\n</tr>\n<tr>\n<td>payment_id</td>\n<td>string</td>\n<td>Bit2Go 订单ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- unpaid: 未支付  <br />- paid: 支付成功  <br />- paid_over: 过度支付  <br />- partial_payment: 部分支付  <br />- cancel: 订单过期</td>\n</tr>\n<tr>\n<td>pay_currency</td>\n<td>string</td>\n<td>支付货币</td>\n</tr>\n<tr>\n<td>pay_amount</td>\n<td>string</td>\n<td>用户需要支付的金额，</td>\n</tr>\n<tr>\n<td>discount</td>\n<td>string</td>\n<td>折扣或者额外的手续费</td>\n</tr>\n<tr>\n<td>payurl</td>\n<td>string</td>\n<td>支付收银台链接</td>\n</tr>\n<tr>\n<td>expired_at</td>\n<td>int</td>\n<td>订单过期时间戳</td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>钱包地址</td>\n</tr>\n<tr>\n<td>network</td>\n<td>string</td>\n<td>区块链网络</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","payment"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"0120880b-5df0-4d55-abeb-85a22f4cf137","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USD\",\n    \"order_id\": \"123456\",\n    \"callback_url\": \"https://bit2go.io\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payment"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"amount\": \"100\",\n        \"currency\": \"USD\",\n        \"order_id\": \"17296654190207\",\n        \"additional_data\": null,\n        \"payment_id\": \"166c7120-f034-468a-88cf-52879d151c00\",\n        \"status\": \"unpaid\",\n        \"pay_currency\": null,\n        \"pay_amount\": null,\n        \"discount\": null,\n        \"discount_percent\": null,\n        \"payurl\": \"https://checkout.bit2go.com/order/166c7120-f034-468a-88cf-52879d151c00\",\n        \"network\": null,\n        \"address\": null,\n        \"icon\": null,\n        \"expired_at\": 1729669021\n    }\n}"},{"id":"d03f123f-b405-4fae-8373-84a16d2f2bc5","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"url":"https://openapi.bit2go.io/api/gateway/payment"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 400,\n    \"message\": \"Request data must be valid JSON.\",\n    \"result\": null\n}"}],"_postman_id":"42a55e5d-1312-4793-b25e-9d68ef5afaaa"},{"name":"Create Static Wallet","id":"2ca640ca-bba3-44c6-8e9a-30071d6e6838","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"networks\": [\"tron\", \"ethereum\", \"solana\"],\n    \"customer_id\": \"Aa123456\",\n    \"callback_url\": \"https://bit2go.io\",\n    \"fiat_currency\": \"USD\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/static/wallet","description":"<p>给用户创建静态钱包，Bit2Go 收到数字资产后，将通过异步通知地址通知商户</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>数值类型</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>networks</td>\n<td>是</td>\n<td>array</td>\n<td>区块链网络</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>是</td>\n<td>string</td>\n<td>用户 ID  <br />  <br />异步通知中会携带该参数</td>\n</tr>\n<tr>\n<td>callback_url</td>\n<td>否</td>\n<td>string</td>\n<td>Bit2Go 收到数字资产时，系统将发送通知给该地址，若商户配置了 Webhook，则通知只会往 Webhook 发送</td>\n</tr>\n<tr>\n<td>fiat_currency</td>\n<td>否</td>\n<td>string</td>\n<td>法币货币，默认为 USD  <br />  <br />异步通知中，Bit2Go 会将收到的数字资产按照最新汇率转换成该法币</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","static","wallet"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"e00e1d9a-27e0-43ab-88c6-1a29f32f4ded","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"networks\": [\"tron\", \"ethereum\", \"solana\"],\n    \"customer_id\": \"Aa123456\",\n    \"callback_url\": \"https://bit2go.io\",\n    \"fiat_currency\": \"USD\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/static/wallet"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"customer_id\": \"Aa123456\",\n        \"addresses\": [\n            {\n                \"network\": \"tron\",\n                \"address\": \"TDYWVSquy9VxtFVFvTB69ZwfXADwBJgeWJ\"\n            },\n            {\n                \"network\": \"ethereum\",\n                \"address\": \"0x78e4b4ba161DAd5151D81cC4068eF19BF57a4003\"\n            },\n            {\n                \"network\": \"solana\",\n                \"address\": \"7tXXKbQfS8TLVhCjqq4594te1fBoW7cwquJwKnJK8SPg\"\n            }\n        ]\n    }\n}"},{"id":"4f8edf31-b02a-4af1-895b-bd9655c9a879","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","type":"text"}],"url":"https://openapi.bit2go.io/api/gateway/static/wallet"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 400,\n    \"message\": \"Request data must be valid JSON.\",\n    \"result\": null\n}"}],"_postman_id":"2ca640ca-bba3-44c6-8e9a-30071d6e6838"},{"name":"Payment Webhook","id":"2ed09e7f-fc80-4b1e-a22c-b56a888a2198","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"payment.paid","description":"<p>通知事件类型: payment.paid；payment.cancel</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"2000\",\n    \"currency\": \"TRX\",\n    \"order_id\": \"CD172967356440JUZ\",\n    \"additional_data\": null,\n    \"payment_id\": \"da0a0642-aa94-4243-a191-5de65047378d\",\n    \"status\": \"paid\",\n    \"pay_currency\": \"TRX\",\n    \"pay_amount\": \"2000\",\n    \"discount\": \"0\",\n    \"txid\": \"9c8543294546f3924f49beea9f79fb63b0aa9fa4a3f02922ede6386ecf694224\",\n    \"fee\": \"40\",\n    \"network\": \"tron\",\n    \"paid_at\": 1729673720,\n    \"convert\": {\n        \"to_currency\": \"USDT\",\n        \"amount_received\": \"309.25125\",\n        \"fee\": \"3.12375\",\n        \"fee_currency\": \"USDT\",\n        \"rate\": \"0.159375\"\n    },\n    \"pay_amount_in_fiat\": {\n        \"rate\": \"6.27451\",\n        \"fiat_amount\": \"318.75\",\n        \"fiat_currency\": \"USD\"\n    },\n    \"pay_amount_in_usdt\": {\n        \"rate\": \"0.159375\",\n        \"usdt_amount\": \"318.75\",\n        \"to_currency\": \"USDT\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对创建订单时传递的 <strong>callback_url</strong> 或者在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>payment.paid</td>\n<td>订单成功</td>\n</tr>\n<tr>\n<td>payment.cancel</td>\n<td>订单过期</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>订单金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>订单货币</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>additional_data</td>\n<td>string</td>\n<td>自定义数据</td>\n</tr>\n<tr>\n<td>discount_percent</td>\n<td>string</td>\n<td>折扣或额外手续费的百分比</td>\n</tr>\n<tr>\n<td>payment_id</td>\n<td>string</td>\n<td>Bit2Go 订单ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- unpaid: 未支付  <br />- paid: 支付成功  <br />- paid_over: 过度支付  <br />- partial_payment: 部分支付  <br />- cancel: 订单过期</td>\n</tr>\n<tr>\n<td>pay_currency</td>\n<td>string</td>\n<td>用户支付的货币</td>\n</tr>\n<tr>\n<td>pay_amount</td>\n<td>string</td>\n<td>用户实际支付的金额</td>\n</tr>\n<tr>\n<td>network</td>\n<td>string</td>\n<td>区块链网络</td>\n</tr>\n<tr>\n<td>discount</td>\n<td>string</td>\n<td>折扣或者额外的手续费</td>\n</tr>\n<tr>\n<td>txid</td>\n<td>string</td>\n<td>交易Hash</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>订单手续费</td>\n</tr>\n<tr>\n<td>paid_at</td>\n<td>int</td>\n<td>支付时间戳</td>\n</tr>\n<tr>\n<td>expired_at</td>\n<td>int</td>\n<td>订单过期时间戳</td>\n</tr>\n<tr>\n<td>convert</td>\n<td>object</td>\n<td>支付金额自动转换成指定币种</td>\n</tr>\n<tr>\n<td>pay_amount_in_fiat</td>\n<td>object</td>\n<td>支付金额对应的等价法币</td>\n</tr>\n<tr>\n<td>pay_amount_in_usdt</td>\n<td>object</td>\n<td>支付金额对应的等价USDT</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string/null</td>\n<td>用于标识商户用户</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"convert-数据结构\">convert <em>数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>to_currency</td>\n<td>string</td>\n<td>目标币种，默认为 USDT</td>\n</tr>\n<tr>\n<td>amount_received</td>\n<td>string</td>\n<td>转化后的金额</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>转化手续费</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费货币</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>转化汇率</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"pay_amount_in_fiat-数据结构\">pay_amount_in_fiat <em>数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>fiat_currency</td>\n<td>string</td>\n<td>法币货币</td>\n</tr>\n<tr>\n<td>fiat_amount</td>\n<td>string</td>\n<td>法币金额</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>数字货币转换法币的汇率</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"pay_amount_in_usdt-数据结构\">pay_amount_in_usdt <em>数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>to_currency</td>\n<td>string</td>\n<td>默认为 USDT</td>\n</tr>\n<tr>\n<td>usdt_amount</td>\n<td>string</td>\n<td>支付货币转换成USDT金额</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>支付货币转换成USDT的汇率</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"b476ac03-a590-4c7d-96c3-a0060beabcdc","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","type":"text"},{"key":"Event","value":"payment.paid","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"2000\",\n    \"currency\": \"TRX\",\n    \"order_id\": \"CD172967356440JUZ\",\n    \"additional_data\": null,\n    \"payment_id\": \"da0a0642-aa94-4243-a191-5de65047378d\",\n    \"status\": \"paid\",\n    \"pay_currency\": \"TRX\",\n    \"pay_amount\": \"2000\",\n    \"discount\": \"0\",\n    \"txid\": \"9c8543294546f3924f49beea9f79fb63b0aa9fa4a3f02922ede6386ecf694224\",\n    \"fee\": \"40\",\n    \"network\": \"tron\",\n    \"paid_at\": 1729673720,\n    \"convert\": {\n        \"to_currency\": \"USDT\",\n        \"amount_received\": \"309.25125\",\n        \"fee\": \"3.12375\",\n        \"fee_currency\": \"USDT\",\n        \"rate\": \"0.159375\"\n    },\n    \"pay_amount_in_fiat\": {\n        \"rate\": \"6.27451\",\n        \"fiat_amount\": \"318.75\",\n        \"fiat_currency\": \"USD\"\n    },\n    \"pay_amount_in_usdt\": {\n        \"rate\": \"0.159375\",\n        \"usdt_amount\": \"318.75\",\n        \"to_currency\": \"USDT\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"2ed09e7f-fc80-4b1e-a22c-b56a888a2198"},{"name":"Payment History","id":"331be502-b8e6-499c-b2a6-42a9361bf952","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payment/list","description":"<p>查询历史订单</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>订单创建的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>订单创建的截止时间</td>\n</tr>\n<tr>\n<td>order_number</td>\n<td>否</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","payment","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"d990b76b-a0ed-4045-9397-df56652dc181","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payment/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"amount\": \"2000\",\n                \"currency\": \"TRX\",\n                \"order_id\": \"CD172967356440JUZ\",\n                \"additional_data\": null,\n                \"payment_id\": \"da0a0642-aa94-4243-a191-5de65047378d\",\n                \"status\": \"paid\",\n                \"pay_currency\": \"TRX\",\n                \"pay_amount\": \"2000\",\n                \"discount\": \"0\",\n                \"txid\": \"9c8543294546f3924f49beea9f79fb63b0aa9fa4a3f02922ede6386ecf694224\",\n                \"fee\": \"40\",\n                \"network\": \"tron\",\n                \"paid_at\": 1729673720,\n                \"convert\": {\n                    \"to_currency\": \"USDT\",\n                    \"amount_received\": \"309.25125\",\n                    \"fee\": \"3.12375\",\n                    \"fee_currency\": \"USDT\",\n                    \"rate\": \"0.159375\"\n                },\n                \"pay_amount_in_fiat\": {\n                    \"rate\": \"6.27451\",\n                    \"fiat_amount\": \"318.75\",\n                    \"fiat_currency\": \"USD\"\n                },\n                \"pay_amount_in_usdt\": {\n                    \"rate\": \"0.159375\",\n                    \"usdt_amount\": \"318.75\",\n                    \"to_currency\": \"USDT\"\n                }\n            }\n        ]\n    }\n}"}],"_postman_id":"331be502-b8e6-499c-b2a6-42a9361bf952"}],"id":"db767e6f-b825-40ff-9100-ded8b213e542","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"09b3ddc6-7f17-4628-ac7a-3d539499d5d7","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"6ed8b30d-8a0c-4449-b10c-3195d956cc2a","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"db767e6f-b825-40ff-9100-ded8b213e542","description":""},{"name":"Payout API","item":[{"name":"Create Payout","event":[{"listen":"test","script":{"id":"c7854cc7-591f-44b0-8889-9ab2de990f1d","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8303bb1f-91ac-421e-99d9-c4590944096d","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USDT\",\n    \"order_id\": \"123456\",\n    \"callback_url\": \"https://bit2go.io\",\n    \"network\": \"tron\",\n    \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payout","description":"<p>创建数字货币付款订单</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>说明</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>是</td>\n<td>string</td>\n<td>订单金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>string</td>\n<td>订单货币；可以是法币和数字货币</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>callback_url</td>\n<td>否</td>\n<td>string</td>\n<td>当订单状态变更时，系统将发送通知给该地址，若商户配置了 Webhook，则通知只会往 Webhook 发送</td>\n</tr>\n<tr>\n<td>network</td>\n<td>是</td>\n<td>string</td>\n<td>收款币种的网络</td>\n</tr>\n<tr>\n<td>address</td>\n<td>是</td>\n<td>string</td>\n<td>收款钱包地址</td>\n</tr>\n<tr>\n<td>pay_currency</td>\n<td>否</td>\n<td>string</td>\n<td>付款货币，只能是数字货币；若 currency 为法币，该字段必传</td>\n</tr>\n<tr>\n<td>additional_data</td>\n<td>否</td>\n<td>string</td>\n<td>商户自定义数据，异步通知会包含该数据</td>\n</tr>\n<tr>\n<td>is_fee_paid_by_receiver</td>\n<td>否</td>\n<td>boolean</td>\n<td>是否用户承担手续费，默认为 false  <br />  <br />比如商户的费率为 1%，商户创建 100 USDT 的订单手续费为 1 USDT，如果这时该字段值为 true（表示用户来承担手续费），那么用户最终收到 99 USDT</td>\n</tr>\n<tr>\n<td>mock_callback_status</td>\n<td>否</td>\n<td>string</td>\n<td>自定义订单在回调通知中的状态，仅适用于测试模式  <br />  <br />- paid: 支付成功  <br />- fail: 支付失败  <br />  <br />比如该字段值为 <code>paid</code> 时，商户在请求 API 成功后，Bit2Go 将会在 3s 后，自动发送 Webhook 到 <code>callback_url</code> 中，其中 <code>status</code> 字段将会是 <code>paid</code></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>订单金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>订单货币</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>network</td>\n<td>string</td>\n<td>收款币种的网络</td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>收款钱包地址</td>\n</tr>\n<tr>\n<td>payout_id</td>\n<td>string</td>\n<td>Bit2Go 订单ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>pay_currency</td>\n<td>string</td>\n<td>支付货币</td>\n</tr>\n<tr>\n<td>pay_amount</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>additional_data</td>\n<td>string</td>\n<td>自定义数据</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","payout"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"2c3be7f8-763d-48ca-8e56-2c7b54d52372","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USDT\",\n    \"order_id\": \"123456\",\n    \"callback_url\": \"https://bit2go.io\",\n    \"network\": \"tron\",\n    \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payout"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"amount\": \"100\",\n        \"currency\": \"USDT\",\n        \"order_id\": \"123456\",\n        \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\",\n        \"network\": \"tron\",\n        \"additional_data\": null,\n        \"pay_currency\": \"USDT\",\n        \"payout_id\": \"b869f1ad-1cf9-4512-a2d1-222ec4ba8b16\",\n        \"status\": \"process\",\n        \"pay_amount\": \"100\"\n    }\n}"},{"id":"43408f11-b54d-4c2b-88e0-f749b952db89","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Merchant","value":"{{Merchant}}","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","type":"text"},{"key":"Sign","value":"{{Sign}}","type":"text"},{"key":"Token","value":"{{Token}}","type":"text"}],"url":"https://openapi.bit2go.io/api/gateway/payout"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 400,\n    \"message\": \"Request data must be valid JSON.\",\n    \"result\": null\n}"}],"_postman_id":"8303bb1f-91ac-421e-99d9-c4590944096d"},{"name":"Payout Webhook","id":"e607c01c-519d-4be2-b4cf-c60461eef3e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"payout.paid","description":"<p>通知事件类型: payout.paid；payout.fail</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USDT\",\n    \"order_id\": \"123456\",\n    \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\",\n    \"network\": \"tron\",\n    \"additional_data\": null,\n    \"payout_id\": \"b869f1ad-1cf9-4512-a2d1-222ec4ba8b16\",\n    \"status\": \"paid\",\n    \"pay_amount\": \"100\",\n    \"pay_currency\": \"USDT\",\n    \"txid\": null,\n    \"fee\": \"2\",\n    \"paid_at\": 1729741071\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对创建订单时传递的 <strong>callback_url</strong> 或者在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>payout.paid</td>\n<td>订单成功</td>\n</tr>\n<tr>\n<td>payout.fail</td>\n<td>订单失败</td>\n</tr>\n<tr>\n<td>payout.confirmation</td>\n<td>二次确认（该事件只能与单个 Webhook 相关联）</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>订单金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>订单货币</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>network</td>\n<td>string</td>\n<td>收款币种的网络</td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>收款钱包地址</td>\n</tr>\n<tr>\n<td>payout_id</td>\n<td>string</td>\n<td>Bit2Go 订单ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- confirmation: 二次确认（若商户开启了出金二次确认，Bit2Go 将会在订单生成时发送回调通知，订单状态为 <em><strong>confirmation</strong></em> ，若商户没有响应 HTTP Response Status Code 2XX；Bit2Go 将会驳回本次出金申请）  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>pay_currency</td>\n<td>string</td>\n<td>支付货币</td>\n</tr>\n<tr>\n<td>pay_amount</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>additional_data</td>\n<td>string</td>\n<td>自定义数据</td>\n</tr>\n<tr>\n<td>txid</td>\n<td>string</td>\n<td>交易Hash</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>订单手续费</td>\n</tr>\n<tr>\n<td>pay_at</td>\n<td>int</td>\n<td>支付时间戳</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td>支付失败原因</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"43b42bdf-47e2-41c1-ab4d-2c9e4366e5cc","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"签名算法，支持 MD5 或 RSA","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"数据签名","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"},{"key":"Event","value":"payout.paid","description":"通知事件类型: payout.paid；payout.fail","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USDT\",\n    \"order_id\": \"123456\",\n    \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\",\n    \"network\": \"tron\",\n    \"additional_data\": null,\n    \"payout_id\": \"b869f1ad-1cf9-4512-a2d1-222ec4ba8b16\",\n    \"status\": \"paid\",\n    \"pay_amount\": \"100\",\n    \"pay_currency\": \"USDT\",\n    \"txid\": null,\n    \"fee\": \"2\",\n    \"paid_at\": 1729741071\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"e607c01c-519d-4be2-b4cf-c60461eef3e6"},{"name":"Payout History","id":"a2e44010-a874-4cf7-91d3-d7622ebca16d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payout/list","description":"<p>查询历史订单</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>订单创建的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>订单创建的截止时间</td>\n</tr>\n<tr>\n<td>order_number</td>\n<td>否</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","payout","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"eafc1d34-c8b6-4aa1-9a9e-9aac5d1d5374","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/payout/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"amount\": \"100\",\n                \"currency\": \"USDT\",\n                \"order_id\": \"123456\",\n                \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\",\n                \"network\": \"tron\",\n                \"additional_data\": null,\n                \"payout_id\": \"b869f1ad-1cf9-4512-a2d1-222ec4ba8b16\",\n                \"status\": \"paid\",\n                \"pay_amount\": \"100\",\n                \"pay_currency\": \"USDT\",\n                \"txid\": null,\n                \"fee\": \"2\",\n                \"paid_at\": 1729741071\n            }\n        ]\n    }\n}"}],"_postman_id":"a2e44010-a874-4cf7-91d3-d7622ebca16d"}],"id":"fe16aefc-677b-4866-9a3d-4e79ee56ca9f","_postman_id":"fe16aefc-677b-4866-9a3d-4e79ee56ca9f","description":""},{"name":"Card API","item":[{"name":"Get All Cards","id":"93d1ac0e-7596-458e-a2de-c59d85ef7732","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/list","description":"<p>查询卡片</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>卡创建的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>卡创建的截止时间</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>卡币种</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>否</td>\n<td>string</td>\n<td>卡ID；若多个卡ID，使用英文逗号连接，如: \"card_id_1,card_id_2\"</td>\n</tr>\n<tr>\n<td>status</td>\n<td>否</td>\n<td>string</td>\n<td>卡状态</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_number</td>\n<td>string</td>\n<td>掩码卡号</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>卡币种</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>卡状态  <br />- pending: 开卡处理中  <br />- active: 已激活  <br />- closed: 已销卡  <br />- blocked: 已冻结  <br />- expired: 已过期</td>\n</tr>\n<tr>\n<td>nickname</td>\n<td>string</td>\n<td>卡片昵称</td>\n</tr>\n<tr>\n<td>brand</td>\n<td>string</td>\n<td>卡组织  <br />- visa  <br />- mastercard</td>\n</tr>\n<tr>\n<td>card_balance</td>\n<td>string</td>\n<td>卡余额</td>\n</tr>\n<tr>\n<td>cardholder_info</td>\n<td>object</td>\n<td>持卡人信息</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n<tr>\n<td>card_bin</td>\n<td>string</td>\n<td>卡Bin</td>\n</tr>\n<tr>\n<td>failed_bill_count</td>\n<td>int</td>\n<td><strong>连续失败的交易次数</strong>：自最近一笔交易起，向前累计连续失败笔数；遇到第一笔成功即停止。无交易或最近一笔为成功时为 0</td>\n</tr>\n<tr>\n<td>monthly_failed_bill_count</td>\n<td>int</td>\n<td><strong>当月失败总笔数</strong>：统计当前自然月（按结算时区）内失败的交易笔数。跨月后归零重新累计</td>\n</tr>\n<tr>\n<td>last_failed_at</td>\n<td>int/null</td>\n<td>最近一次失败交易的时间，若从未失败则为 <code>null</code></td>\n</tr>\n<tr>\n<td>card_settings</td>\n<td>object</td>\n<td>卡配置信息</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"cardholder_info-数据结构\"><em>cardholder_info 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>名</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>姓</td>\n</tr>\n<tr>\n<td>email</td>\n<td>邮箱</td>\n</tr>\n<tr>\n<td>phone</td>\n<td>手机号</td>\n</tr>\n<tr>\n<td>phone_prefix</td>\n<td>手机区号</td>\n</tr>\n<tr>\n<td>country_code</td>\n<td>国家</td>\n</tr>\n<tr>\n<td>state</td>\n<td>州</td>\n</tr>\n<tr>\n<td>city</td>\n<td>城市</td>\n</tr>\n<tr>\n<td>address</td>\n<td>地址</td>\n</tr>\n<tr>\n<td>zipcode</td>\n<td>邮政编码</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"card_settingsnotifications-数据结构\"><em>card_settings.notifications 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>send_email_to_merchant</td>\n<td>boolean</td>\n<td>是否向<strong>商户账号邮箱</strong>发送交易通知</td>\n</tr>\n<tr>\n<td>send_email_to_cardholder</td>\n<td>boolean</td>\n<td>是否向<strong>持卡人邮箱</strong>发送交易通知</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"card_settingstermination-数据结构\"><em>card_settings.termination 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>payout_wallet_currency</td>\n<td>string</td>\n<td><strong>销卡时，卡余额将转入的目标商户钱包币种</strong>（如 <code>USD</code>、<code>USDT</code> 等）。默认为 <code>USD</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"eff6ed93-1142-4a78-a687-f4a146618e3b","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"card_number\": \"************3267\",\n                \"created_at\": 1750229855,\n                \"status\": \"active\",\n                \"nickname\": null,\n                \"brand\": \"visa\",\n                \"card_balance\": \"100\",\n                \"cardholder_info\": {\n                    \"first_name\": \"Lei\",\n                    \"last_name\": \"Li\",\n                    \"email\": \"test@gmail.com\",\n                    \"phone\": \"\",\n                    \"phone_prefix\": \"\",\n                    \"country_code\": \"AU\",\n                    \"state\": \"VIC\",\n                    \"city\": \"Melbourne\",\n                    \"address\": \"44 Gillespie St\",\n                    \"zipcode\": \"3121\"\n                },\n                \"card_settings\": {\n                    \"notifications\": {\n                        \"send_email_to_merchant\": true,\n                        \"send_email_to_cardholder\": false\n                    },\n                    \"termination\": {\n                        \"payout_wallet_currency\": \"USD\"\n                    }\n                },\n                \"card_id\": \"C2506181457350001\"\n            }\n        ]\n    }\n}"}],"_postman_id":"93d1ac0e-7596-458e-a2de-c59d85ef7732"},{"name":"Get Sensitive Card Details","id":"ea8e1520-434d-4994-8337-6a1d804e6dbf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/detail","description":"<p>查询卡片敏感信息（需联系管理员开通 API 权限）</p>\n<blockquote>\n<p><strong>说明：</strong> 考虑到数据安全和合规风险，商户不得在系统中或者日志中存储卡敏感信息（卡号、CVV、有效期） </p>\n</blockquote>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_id</td>\n<td>是</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_bin</td>\n<td>string</td>\n<td>卡Bin</td>\n</tr>\n<tr>\n<td>card_number</td>\n<td>string</td>\n<td>完整卡号</td>\n</tr>\n<tr>\n<td>card_cvv</td>\n<td>string</td>\n<td>卡CVV</td>\n</tr>\n<tr>\n<td>expiry_month</td>\n<td>int</td>\n<td>卡片过期的月份</td>\n</tr>\n<tr>\n<td>expiry_year</td>\n<td>int</td>\n<td>卡片过期的年份</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","detail"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"aed3aa7e-ec01-4fd1-ada7-40b06e7bf639","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/detail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"card_number\": \"4111111111111111\",\n        \"card_cvv\": \"123\",\n        \"expiry_month\": 1,\n        \"expiry_year\": 2025\n    }\n}"},{"id":"10d66a4e-c468-44d3-88dc-f9b8333b2d81","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/detail"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 400,\n    \"message\": \"Card sensitive information has already been viewed.\",\n    \"result\": null\n}"}],"_postman_id":"ea8e1520-434d-4994-8337-6a1d804e6dbf"},{"name":"Card Issue","id":"dbd749a6-a470-4ff6-a984-8c722fa41a2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"wallet_amount\": 30,\n    \"wallet_currency\": \"USDT\",\n    \"card_currency\": \"HKD\",\n    \"order_id\": \"d690c7f3535c\",\n    \"card_settings\": {\n        \"notifications\": {\n            \"send_email_to_merchant\": true,\n            \"send_email_to_cardholder\": false\n        }\n    },\n    \"card_holder_info\": {\n        \"first_name\": \"John\",\n        \"last_name\": \"Smith\",\n        \"email\": \"john@gmail.com\",\n        \"phone\": \"61432100100\",\n        \"phone_prefix\": \"1\"\n    }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/issue","description":"<p>创建虚拟卡（需联系管理员开通 API 权限）</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>quote_id</td>\n<td>否</td>\n<td>string</td>\n<td>报价 ID</td>\n</tr>\n<tr>\n<td>card_bin</td>\n<td>否</td>\n<td>string</td>\n<td>卡 BIN（Bank Identification Number）。如不传，系统将随机分配可用 BIN</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>否</td>\n<td>string</td>\n<td>卡片币种代码（ISO 4217，例如 <code>USD</code>、<code>SGD</code>）</td>\n</tr>\n<tr>\n<td>expiry_date</td>\n<td>否</td>\n<td>string</td>\n<td>卡有效期，必须满足以下条件：  <br />1. 日期格式：<code>YYYY-MM-DD</code>（如 <code>2027-08-31</code>）  <br />2. 日（DD）必须是该月的最后一天（如 <code>2025-02-28</code> 或闰年 <code>2028-02-29</code>）  <br />3. 有效期范围：必须在今天起满 1 个月（含）到今天起 2 年（含）之间  <br />4. 如不传，系统将按卡 BIN 对应的默认有效期生成</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>否</td>\n<td>string</td>\n<td>卡币种金额，与 <strong>付款钱包金额</strong> 二选一</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>否</td>\n<td>string</td>\n<td>付款钱包币种，若不传递，自动取商户当前资产最多的钱包币种</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>否</td>\n<td>string</td>\n<td>付款钱包金额，与 <strong>卡币种金额</strong> 二选一</td>\n</tr>\n<tr>\n<td>nickname</td>\n<td>否</td>\n<td>string</td>\n<td>卡片昵称</td>\n</tr>\n<tr>\n<td>card_holder_info</td>\n<td>是</td>\n<td>object</td>\n<td>持卡人信息</td>\n</tr>\n<tr>\n<td>card_settings</td>\n<td>否</td>\n<td>object</td>\n<td>卡配置信息</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"card_holder_info-数据结构\"><em>card_holder_info 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>是</td>\n<td>持卡人名</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>是</td>\n<td>持卡人姓</td>\n</tr>\n<tr>\n<td>email</td>\n<td>是</td>\n<td>邮箱</td>\n</tr>\n<tr>\n<td>phone</td>\n<td>是</td>\n<td>持卡人手机号</td>\n</tr>\n<tr>\n<td>phone_prefix</td>\n<td>是</td>\n<td>持卡人手机区号，不需要加 +</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"card_settingsnotifications-数据结构\"><em>card_settings.notifications 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>send_email_to_merchant</td>\n<td>boolean</td>\n<td>是否向<strong>商户账号邮箱</strong>发送交易通知</td>\n</tr>\n<tr>\n<td>send_email_to_cardholder</td>\n<td>boolean</td>\n<td>是否向<strong>持卡人邮箱</strong>发送交易通知</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string/null</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>操作订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>本次操作收取的手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>操作创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>商户钱包实际支付或收到的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>卡上增加或减少的金额（依据操作类型）</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>card_nickname</td>\n<td>string/null</td>\n<td>卡片昵称</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>钱包币种到卡币种的汇率，表示 wallet_currency ➝ card_currency</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型：card.issue</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","issue"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"96a775fe-984f-49a4-a396-75322ae76261","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"wallet_amount\": 30,\n    \"wallet_currency\": \"USDT\",\n    \"card_currency\": \"HKD\",\n    \"order_id\": \"d690c7f3535c\",\n    \"card_holder_info\": {\n        \"first_name\": \"John\",\n        \"last_name\": \"Smith\",\n        \"email\": \"john@gmail.com\",\n        \"phone\": \"61432100100\",\n        \"phone_prefix\": \"1\"\n    }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/issue"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": \"d690c7f3535c\",\n        \"bit2go_id\": \"02508141631400001\",\n        \"card_id\": \"C2508141631400001\",\n        \"status\": \"paid\",\n        \"fee\": \"5.12\",\n        \"fee_currency\": \"USD\",\n        \"created_at\": 1755160300,\n        \"wallet_amount\": \"12.5\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"100\",\n        \"card_currency\": \"HKD\",\n        \"card_nickname\": null,\n        \"exchange_rate\": \"8\",\n        \"operation_type\": \"card.issue\"\n    }\n}"}],"_postman_id":"dbd749a6-a470-4ff6-a984-8c722fa41a2c"},{"name":"Card Fee Quote","id":"9406243b-b7e0-4c87-be1f-c106c53d83e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_amount\": 100,\n    \"card_currency\": \"HKD\",\n    \"wallet_currency\": \"USDT\",\n    \"operation_type\": \"card.issue\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/fee","description":"<p>用于查询开卡 / 卡内转入 / 卡内转出的手续费与汇率，并返回报价 ID (quote_id)。下单时需携带该 quote_id 以锁定费用与汇率。</p>\n<blockquote>\n<p><strong>说明：</strong> 商户必须在 60 秒内完成下单，否则该报价失效，需要重新调用接口获取新的报价。 </p>\n</blockquote>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>operation_type</td>\n<td>是</td>\n<td>string</td>\n<td>操作类型：<code>card.issue</code>（开卡）、<code>card.topup</code>（转入）、<code>card.withdraw</code>（转出）</td>\n</tr>\n<tr>\n<td>card_bin</td>\n<td>开卡可选；转入/转出必填</td>\n<td>string</td>\n<td>卡 BIN。开卡可不传（系统可选 BIN）；<strong>转入/转出必须传</strong></td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>否</td>\n<td>string</td>\n<td>卡币种金额，与 <code>wallet_amount</code> 二选一</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>否</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>否</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>否</td>\n<td>string</td>\n<td>商户钱包币种金额，与 <code>card_amount</code> <strong>二选一</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>quote_id</td>\n<td>string</td>\n<td>报价 ID，用于后续下单锁价（<strong>有效期 60 秒</strong>）</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型：<code>card.issue</code> / <code>card.topup</code> / <code>card.withdraw</code></td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>商户钱包实际支付或收到的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>卡上增加或减少的金额（依据操作类型）</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>conversion_steps</td>\n<td>array</td>\n<td>汇率拆解步骤（可能为空）</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"conversion_steps-数据结构\"><em>conversion_steps 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>from_currency</td>\n<td>string</td>\n<td>原币种（例如：<code>USD</code>）</td>\n</tr>\n<tr>\n<td>to_currency</td>\n<td>string</td>\n<td>目标币种（例如：<code>HKD</code>）</td>\n</tr>\n<tr>\n<td>from_amount</td>\n<td>string</td>\n<td>原币种金额</td>\n</tr>\n<tr>\n<td>to_amount</td>\n<td>string</td>\n<td>转换后的目标币种金额</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>实际使用的汇率（<code>to_amount / from_amount</code>）</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费金额</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","fee"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"f3ebe61c-c2e4-439a-91bd-eeec9d798b79","name":"Card Issue Fee","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_amount\": 100,\n    \"card_currency\": \"HKD\",\n    \"wallet_currency\": \"USDT\",\n    \"operation_type\": \"card.issue\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/fee"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"quote_id\": \"4fe2656d-36f5-4ed1-a194-38d1a5a7435c\",\n        \"operation_type\": \"card.issue\",\n        \"fee\": \"5.12\",\n        \"fee_currency\": \"USD\",\n        \"wallet_amount\": \"17.726358\",\n        \"wallet_currency\": \"USDT\",\n        \"card_amount\": \"100\",\n        \"card_currency\": \"HKD\",\n        \"conversion_steps\": [\n            {\n                \"from_currency\": \"USDT\",\n                \"to_currency\": \"USD\",\n                \"from_amount\": \"17.726358\",\n                \"to_amount\": \"17.62\",\n                \"rate\": \"0.994\",\n                \"fee_currency\": \"USD\",\n                \"fee\": \"0\"\n            },\n            {\n                \"from_currency\": \"USD\",\n                \"to_currency\": \"HKD\",\n                \"from_amount\": \"12.5\",\n                \"to_amount\": \"100\",\n                \"rate\": \"8\",\n                \"fee_currency\": \"USD\",\n                \"fee\": \"0\"\n            }\n        ]\n    }\n}"},{"id":"8c6cda2c-e5b9-4f42-9046-27714058e5bf","name":"Card Top-up Fee","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_bin\": \"404038\",\n    \"card_amount\": 20,\n    \"card_currency\": \"HKD\",\n    \"wallet_currency\": \"USD\",\n    \"operation_type\": \"card.topup\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/fee"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"quote_id\": \"7c536b04-62cb-4427-b83c-0cd6f19a291f\",\n        \"operation_type\": \"card.topup\",\n        \"fee\": \"0.02\",\n        \"fee_currency\": \"USD\",\n        \"wallet_amount\": \"2.52\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"20\",\n        \"card_currency\": \"HKD\",\n        \"conversion_steps\": [\n            {\n                \"from_currency\": \"USD\",\n                \"to_currency\": \"HKD\",\n                \"from_amount\": \"2.5\",\n                \"to_amount\": \"20\",\n                \"rate\": \"8\",\n                \"fee_currency\": \"USD\",\n                \"fee\": \"0\"\n            }\n        ]\n    }\n}"},{"id":"dd4a1ea9-a989-43f8-9653-2c3f30cfd1d9","name":"Card Withdraw Fee","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_bin\": \"404038\",\n    \"card_amount\": 20,\n    \"card_currency\": \"HKD\",\n    \"operation_type\": \"card.withdraw\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/fee"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"quote_id\": \"9d4ae78d-c29e-465a-a345-2376647cb6f8\",\n        \"operation_type\": \"card.withdraw\",\n        \"fee\": \"0.01\",\n        \"fee_currency\": \"USD\",\n        \"wallet_amount\": \"2.49\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"20\",\n        \"card_currency\": \"HKD\",\n        \"conversion_steps\": [\n            {\n                \"from_currency\": \"HKD\",\n                \"to_currency\": \"USD\",\n                \"from_amount\": \"20\",\n                \"to_amount\": \"2.5\",\n                \"rate\": \"0.125\",\n                \"fee_currency\": \"USD\",\n                \"fee\": \"0\"\n            }\n        ]\n    }\n}"},{"id":"0a21bf82-8678-4c06-9f8e-1b20a1620829","name":"Card Terminate Fee","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_bin\": \"404038\",\n    \"card_amount\": 20,\n    \"card_currency\": \"HKD\",\n    \"operation_type\": \"card.terminate\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/fee"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"quote_id\": \"9d4ae78d-c29e-465a-a345-2376647cb6f8\",\n        \"operation_type\": \"card.terminate\",\n        \"fee\": \"0.01\",\n        \"fee_currency\": \"USD\",\n        \"wallet_amount\": \"2.49\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"20\",\n        \"card_currency\": \"HKD\",\n        \"conversion_steps\": [\n            {\n                \"from_currency\": \"HKD\",\n                \"to_currency\": \"USD\",\n                \"from_amount\": \"20\",\n                \"to_amount\": \"2.5\",\n                \"rate\": \"0.125\",\n                \"fee_currency\": \"USD\",\n                \"fee\": \"0\"\n            }\n        ]\n    }\n}"}],"_postman_id":"9406243b-b7e0-4c87-be1f-c106c53d83e3"},{"name":"Card Top-up","id":"406ef9de-a79c-48ce-95e9-f38da15a73d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_amount\": \"20\",\n    \"card_id\": \"C2506181457350001\",\n    \"order_id\": \"d690c7f3535c\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/topup","description":"<p>增加虚拟卡余额（需联系管理员开通 API 权限）</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_amount</td>\n<td>否</td>\n<td>string</td>\n<td>卡币种金额，与 <strong>付款钱包金额</strong> 二选一</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>是</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>否</td>\n<td>string</td>\n<td>付款钱包币种，若不传递，自动取商户当前资产最多的钱包币种</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>否</td>\n<td>string</td>\n<td>付款钱包金额，与 <strong>卡币种金额</strong> 二选一</td>\n</tr>\n<tr>\n<td>quote_id</td>\n<td>否</td>\n<td>string</td>\n<td>报价 ID</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>订单创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>商户支付金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户支付使用的钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>卡片充值金额</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>汇率，表示 wallet_currency 到 card_currency 的兑换比率</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型，本接口固定为 card.topup 表示卡充值</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","topup"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"76f4e961-c21e-4ad7-b009-ff2386eb015a","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_amount\": \"20\",\n    \"card_id\": \"C2506181635020001\",\n    \"order_id\": \"d690c7f3535c\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/topup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": \"d690c7f3535c\",\n        \"bit2go_id\": \"02506181635020002\",\n        \"card_id\": \"C2506181635020001\",\n        \"status\": \"process\",\n        \"fee\": \"0.02\",\n        \"fee_currency\": \"USD\",\n        \"created_at\": 1750235702,\n        \"wallet_amount\": \"2.52\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"20\",\n        \"card_currency\": \"HKD\",\n        \"exchange_rate\": \"8\",\n        \"operation_type\": \"card.topup\"\n    }\n}"}],"_postman_id":"406ef9de-a79c-48ce-95e9-f38da15a73d7"},{"name":"Card Withdrawal","id":"583e7a54-0c37-4976-8dc5-50d85b1aa526","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_amount\": \"20\",\n    \"card_id\": \"C2506181457350001\",\n    \"order_id\": \"d690c7f3535c\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/withdraw","description":"<p>转出虚拟卡余额（需联系管理员开通 API 权限）</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_amount</td>\n<td>是</td>\n<td>string</td>\n<td>卡币种金额</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>是</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>否</td>\n<td>string</td>\n<td>商户钱包币种。用于指定转出卡余额入账的钱包币种，<strong>若不传则默认转出至 USD 钱包</strong></td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>否</td>\n<td>string</td>\n<td>入账币种的金额，与 <strong>卡币种金额</strong> 二选一</td>\n</tr>\n<tr>\n<td>quote_id</td>\n<td>否</td>\n<td>string</td>\n<td>报价 ID</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>订单创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>转出后实际返回到商户钱包的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>从卡中扣除的金额</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>汇率，表示 card_currency 到 wallet_currency 的兑换比率</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型，本接口为 card.withdraw 表示卡转出</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","withdraw"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"d888e3ee-1e68-41b8-b682-d17b92745c4a","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_amount\": \"20\",\n    \"card_id\": \"C2506181635020001\",\n    \"order_id\": \"d690c7f3535c\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/withdraw"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": \"d690c7f3535c\",\n        \"bit2go_id\": \"02506181639450002\",\n        \"card_id\": \"C2506181635020001\",\n        \"status\": \"process\",\n        \"fee\": \"0.01\",\n        \"fee_currency\": \"USD\",\n        \"created_at\": 1750235985,\n        \"wallet_amount\": \"2.49\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"20\",\n        \"card_currency\": \"HKD\",\n        \"exchange_rate\": \"0.125\",\n        \"operation_type\": \"card.withdraw\"\n    }\n}"}],"_postman_id":"583e7a54-0c37-4976-8dc5-50d85b1aa526"},{"name":"Card Termination","id":"7e797ab3-71a9-46c2-af04-c87692a0ca19","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\",\n    \"order_id\": \"d690c7f3535c\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/terminate","description":"<p>销卡（需联系管理员开通 API 权限）</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_id</td>\n<td>是</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>否</td>\n<td>string</td>\n<td>指定卡余额将转入的目标商户钱包币种，<strong>优先级高于 card_settings 配置</strong>，如不传则按卡配置或默认为 <code>USD</code></td>\n</tr>\n<tr>\n<td>quote_id</td>\n<td>否</td>\n<td>string</td>\n<td>报价 ID</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string/null</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>销卡过程收取的手续费金额（如无费用则为 \"0\"）</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>操作创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>卡中退回到商户钱包的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>销卡前卡内余额金额</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>汇率，表示 card_currency 到 wallet_currency 的兑换比率</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型，本接口为 card.terminate 表示销卡操作</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","terminate"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"71ae6bff-e856-441c-83d5-df8586eaf18c","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181635020001\",\n    \"order_id\": \"d690c7f3535c\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/terminate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": null,\n        \"bit2go_id\": \"02506181641490002\",\n        \"card_id\": \"C2506181641490001\",\n        \"status\": \"process\",\n        \"fee\": \"0\",\n        \"fee_currency\": \"USD\",\n        \"created_at\": 1750236109,\n        \"wallet_amount\": \"12.5\",\n        \"wallet_currency\": \"USD\",\n        \"card_amount\": \"100\",\n        \"card_currency\": \"HKD\",\n        \"exchange_rate\": \"0.125\",\n        \"operation_type\": \"card.terminate\"\n    }\n}"}],"_postman_id":"7e797ab3-71a9-46c2-af04-c87692a0ca19"},{"name":"Get Card Operations","id":"763e6aa2-6aa0-4800-b6e7-e212f6b65302","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/operation","description":"<p>查询卡操作订单</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>截止时间</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>否</td>\n<td>string</td>\n<td>卡ID；若多个卡ID，使用英文逗号连接，如: \"card_id_1,card_id_2\"</td>\n</tr>\n<tr>\n<td>status</td>\n<td>否</td>\n<td>string</td>\n<td>交易状态</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>否</td>\n<td>string</td>\n<td>操作类型</td>\n</tr>\n<tr>\n<td>order_number</td>\n<td>否</td>\n<td>string</td>\n<td>商户订单号或者 Bit2Go订单号</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string/null</td>\n<td>商户订单号，部分操作不是通过 API 申请的则可能为空</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>操作订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>本次操作收取的手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>操作创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>商户钱包实际支付或收到的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>卡上增加或减少的金额（依据操作类型）</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>钱包币种到卡币种的汇率，表示 wallet_currency ➝ card_currency</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型：  <br />- card.issue 开卡  <br />- card.topup 卡充值  <br />- card.withdraw 卡转出  <br />- card.terminate 销卡</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","operation"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"d155b735-c8b5-421f-8299-3bb70f9bad8a","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/operation"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"order_id\": null,\n                \"bit2go_id\": \"02506181659400001\",\n                \"card_id\": \"C2506181659410001\",\n                \"status\": \"paid\",\n                \"fee\": \"5.12\",\n                \"fee_currency\": \"USD\",\n                \"created_at\": 1750237180,\n                \"wallet_amount\": \"12.5\",\n                \"wallet_currency\": \"USD\",\n                \"card_amount\": \"100\",\n                \"card_currency\": \"HKD\",\n                \"exchange_rate\": \"8\",\n                \"operation_type\": \"card.issue\"\n            }\n        ]\n    }\n}"}],"_postman_id":"763e6aa2-6aa0-4800-b6e7-e212f6b65302"},{"name":"Get Transactions","id":"62e337ea-1d2a-4d42-b091-213d14f472e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/transaction","description":"<p>查询卡交易</p>\n<hr />\n<h4 id=\"虚拟卡交易流程说明\">虚拟卡交易流程说明</h4>\n<ul>\n<li><p><strong>消费（拒绝）</strong> → <strong>结束</strong></p>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>消费（已清算，无清算差额）</strong> → <strong>结束</strong></p>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>消费（已清算，有清算差额）</strong> → <strong>清算差额（已清算）</strong> → <strong>结束</strong></p>\n</li>\n<li><p><strong>退款（已清算）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>通常在原交易清算后发起，但大多数无法关联原交易单号</em> </p>\n</blockquote>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>冲正（批准，全额冲正）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>全额冲正，原交易不会再清算</em> </p>\n</blockquote>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>冲正（批准，部分冲正）</strong> → <strong>消费（已清算）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>部分冲正，原交易会进行清算</em> </p>\n</blockquote>\n</li>\n<li><p><strong>强制清算（已清算）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>无授权直接清算的交易</em></p>\n</blockquote>\n</li>\n</ul>\n<hr />\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>交易的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>交易的截止时间</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>卡币种</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>否</td>\n<td>string</td>\n<td>卡ID；若多个卡ID，使用英文逗号连接，如: \"card_id_1,card_id_2\"</td>\n</tr>\n<tr>\n<td>status</td>\n<td>否</td>\n<td>string</td>\n<td>交易状态</td>\n</tr>\n<tr>\n<td>transaction_type</td>\n<td>否</td>\n<td>string</td>\n<td>交易类型</td>\n</tr>\n<tr>\n<td>order_number</td>\n<td>否</td>\n<td>string</td>\n<td>交易ID或原交易ID</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>transaction_date</td>\n<td>int</td>\n<td>交易时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>clearing_date</td>\n<td>int/null</td>\n<td>清算时间（Unix 时间戳，可能为空）</td>\n</tr>\n<tr>\n<td>card_nickname</td>\n<td>string/null</td>\n<td>卡片备注名</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>billing_amount</td>\n<td>string</td>\n<td>账单金额</td>\n</tr>\n<tr>\n<td>billing_currency</td>\n<td>string</td>\n<td>账单币种</td>\n</tr>\n<tr>\n<td>transaction_amount</td>\n<td>string</td>\n<td>交易金额</td>\n</tr>\n<tr>\n<td>transaction_currency</td>\n<td>string</td>\n<td>交易币种</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>交易状态  <br />- approved: 批准  <br />- fail: 拒绝  <br />- cleared: 已清算</td>\n</tr>\n<tr>\n<td>transaction_id</td>\n<td>string</td>\n<td>交易唯一标识 ID</td>\n</tr>\n<tr>\n<td>transaction_type</td>\n<td>string</td>\n<td>交易类型  <br />- authorization: 消费  <br />- net_clearing: 清算差额  <br />- reversal: 冲正  <br />- refund: 退款  <br />- clearing: 强制清算</td>\n</tr>\n<tr>\n<td>origin_transaction_id</td>\n<td>string/null</td>\n<td>原始交易 ID 或结算 ID  <br />- 退款场景中，指向被退款的原始交易ID  <br />- 冲正场景中，指向被冲正的原交易ID  <br />- 清算场景中，为结算 ID</td>\n</tr>\n<tr>\n<td>approval_code</td>\n<td>string</td>\n<td>授权码</td>\n</tr>\n<tr>\n<td>merchant_name</td>\n<td>string</td>\n<td>商户名称</td>\n</tr>\n<tr>\n<td>merchant_category_code</td>\n<td>string</td>\n<td>商户类别代码（MCC）</td>\n</tr>\n<tr>\n<td>failure_reason</td>\n<td>string</td>\n<td>失败原因代码（如存在）</td>\n</tr>\n<tr>\n<td>failure_reason_description</td>\n<td>string</td>\n<td>失败原因描述（如存在）</td>\n</tr>\n<tr>\n<td>fund_direction</td>\n<td>string/int</td>\n<td>资金方向：0 表示支出，1 表示收入</td>\n</tr>\n<tr>\n<td>reversal_amount</td>\n<td>string</td>\n<td>若消费存在冲正，该字段表示冲正金额，无冲正时为 0</td>\n</tr>\n<tr>\n<td>settlement_amount</td>\n<td>string</td>\n<td>最终结算金额（含手续费）  <br />- 支出类交易（如消费、清算差额、清算）为正数  <br />- 收入类交易（如退款、冲正）为负数，表示返还给卡的金额</td>\n</tr>\n<tr>\n<td>wallet_id</td>\n<td>string/null</td>\n<td>标识虚拟卡交易关联的钱包ID  <br />- 216: Google Pay  <br />- 103: Apple Pay</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","transaction"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"92441c4c-4aa3-47b1-b0ab-411576d89803","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"transaction_date\": 1738893795,\n                \"clearing_date\": null,\n                \"card_nickname\": null,\n                \"card_id\": \"C2506181547110001\",\n                \"billing_amount\": \"40\",\n                \"billing_currency\": \"HKD\",\n                \"transaction_amount\": \"5\",\n                \"transaction_currency\": \"USD\",\n                \"fee\": \"5.6\",\n                \"fee_currency\": \"HKD\",\n                \"status\": \"approved\",\n                \"transaction_id\": \"A1887683511972196354\",\n                \"transaction_type\": \"authorization\",\n                \"origin_transaction_id\": null,\n                \"approval_code\": \"209500\",\n                \"merchant_name\": \"HYATT REGENCY HK SHA T\",\n                \"merchant_category_code\": \"5311 Department Stores\",\n                \"failure_reason\": \"000000\",\n                \"failure_reason_description\": \"\",\n                \"fund_direction\": \"0\",\n                \"reversal_amount\": \"0\",\n                \"settlement_amount\": \"45.6\"\n            }\n        ]\n    }\n}"}],"_postman_id":"62e337ea-1d2a-4d42-b091-213d14f472e7"},{"name":"Freeze Card","id":"e8a59123-49a8-4487-8fac-7220d7d05b67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/freeze","description":"<p>冻结虚拟卡（需联系管理员开通 API 权限）</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_id</td>\n<td>是</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>卡状态</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","freeze"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"7c60d122-a714-4a79-a506-bf59427c1a28","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181635020001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/freeze"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"card_id\": \"C2506181635020001\",\n        \"status\": \"blocked\"\n    }\n}"},{"id":"d36a9487-a7e4-4dae-9e97-a2a01af01d76","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/freeze"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 400,\n    \"message\": \"Card freeze not allowed. Current status: blocked. Expected: active.\",\n    \"result\": null\n}"}],"_postman_id":"e8a59123-49a8-4487-8fac-7220d7d05b67"},{"name":"Unfreeze Card","id":"09c48f56-21ad-4b34-b6f5-418ce711fe4e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/unfreeze","description":"<p>解冻虚拟卡（需联系管理员开通 API 权限）</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_id</td>\n<td>是</td>\n<td>string</td>\n<td>卡ID</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>卡状态</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","card","unfreeze"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"2484c769-62ca-4759-a09a-558e85895b13","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181635020001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/unfreeze"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"card_id\": \"C2506181635020001\",\n        \"status\": \"active\"\n    }\n}"},{"id":"1ec204b0-256c-486b-be37-c149541c3ae8","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"card_id\": \"C2506181457350001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/card/unfreeze"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 400,\n    \"message\": \"Card unfreeze not allowed. Current status: active. Expected: blocked.\",\n    \"result\": null\n}"}],"_postman_id":"09c48f56-21ad-4b34-b6f5-418ce711fe4e"},{"name":"Card Operation Webhook","id":"fcf2b25b-a70d-46df-951f-9a4173263325","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"card.topup.success","description":"<p>通知事件类型</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"100\",\n    \"currency\": \"USDT\",\n    \"order_id\": \"123456\",\n    \"address\": \"TLpUWDzUU3XuRLWMaWCo6vyyjtAJyFcYXA\",\n    \"network\": \"tron\",\n    \"additional_data\": null,\n    \"payout_id\": \"b869f1ad-1cf9-4512-a2d1-222ec4ba8b16\",\n    \"status\": \"paid\",\n    \"pay_amount\": \"100\",\n    \"pay_currency\": \"USDT\",\n    \"txid\": null,\n    \"fee\": \"2\",\n    \"paid_at\": 1729741071\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card.issue.success</td>\n<td>卡片开通成功</td>\n</tr>\n<tr>\n<td>card.issue.fail</td>\n<td>卡片开通失败</td>\n</tr>\n<tr>\n<td>card.topup.success</td>\n<td>卡片充值成功</td>\n</tr>\n<tr>\n<td>card.topup.fail</td>\n<td>卡片充值失败</td>\n</tr>\n<tr>\n<td>card.withdraw.success</td>\n<td>卡片转出成功</td>\n</tr>\n<tr>\n<td>card.withdraw.fail</td>\n<td>卡片转出失败</td>\n</tr>\n<tr>\n<td>card.terminate.success</td>\n<td>卡片销卡成功</td>\n</tr>\n<tr>\n<td>card.terminate.fail</td>\n<td>卡片销卡失败</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string/null</td>\n<td>商户订单号，部分操作不是通过 API 申请的则可能为空</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>操作订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>本次操作收取的手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>操作创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>商户钱包实际支付或收到的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>card_amount</td>\n<td>string</td>\n<td>卡上增加或减少的金额（依据操作类型）</td>\n</tr>\n<tr>\n<td>card_currency</td>\n<td>string</td>\n<td>卡片币种</td>\n</tr>\n<tr>\n<td>card_nickname</td>\n<td>string/null</td>\n<td>卡片昵称</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>钱包币种到卡币种的汇率，表示 wallet_currency ➝ card_currency</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型：  <br />- card.issue 开卡  <br />- card.topup 卡充值  <br />- card.withdraw 卡转出  <br />- card.terminate 销卡</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"26da4aac-308a-4d13-8fee-c46a81a115c8","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"签名算法，支持 MD5 或 RSA","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"数据签名","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"},{"key":"Event","value":"card.topup.success","description":"通知事件类型","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"d690c7f3535c\",\n    \"bit2go_id\": \"02506181635020002\",\n    \"card_id\": \"C2506181635020001\",\n    \"status\": \"paid\",\n    \"fee\": \"0.02\",\n    \"fee_currency\": \"USD\",\n    \"created_at\": 1750235702,\n    \"wallet_amount\": \"2.52\",\n    \"wallet_currency\": \"USD\",\n    \"card_amount\": \"20\",\n    \"card_currency\": \"HKD\",\n    \"exchange_rate\": \"8\",\n    \"operation_type\": \"card.topup\"\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"fcf2b25b-a70d-46df-951f-9a4173263325"},{"name":"Card Transaction Webhook","id":"7a905ea3-1a10-45c9-9fb5-06e017d836e5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"card.transaction","description":"<p>通知事件类型</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"transaction_date\": 1738893795,\n    \"clearing_date\": null,\n    \"card_nickname\": null,\n    \"card_id\": \"C2506181547110001\",\n    \"billing_amount\": \"40\",\n    \"billing_currency\": \"HKD\",\n    \"transaction_amount\": \"5\",\n    \"transaction_currency\": \"USD\",\n    \"fee\": \"5.6\",\n    \"fee_currency\": \"HKD\",\n    \"status\": \"approved\",\n    \"transaction_id\": \"A1887683511972196354\",\n    \"transaction_type\": \"authorization\",\n    \"origin_transaction_id\": null,\n    \"approval_code\": \"209500\",\n    \"merchant_name\": \"HYATT REGENCY HK SHA T\",\n    \"merchant_category_code\": \"5311 Department Stores\",\n    \"failure_reason\": \"000000\",\n    \"failure_reason_description\": \"\",\n    \"fund_direction\": \"0\",\n    \"reversal_amount\": \"0\",\n    \"settlement_amount\": \"45.6\"\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<hr />\n<h4 id=\"虚拟卡交易流程说明\">虚拟卡交易流程说明</h4>\n<ul>\n<li><p><strong>消费（拒绝）</strong> → <strong>结束</strong></p>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>消费（已清算，无清算差额）</strong> → <strong>结束</strong></p>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>消费（已清算，有清算差额）</strong> → <strong>清算差额（已清算）</strong> → <strong>结束</strong></p>\n</li>\n<li><p><strong>退款（已清算）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>通常在原交易清算后发起，但大多数无法关联原交易单号</em> </p>\n</blockquote>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>冲正（批准，全额冲正）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>全额冲正，原交易不会再清算</em> </p>\n</blockquote>\n</li>\n<li><p><strong>消费（批准）</strong> → <strong>冲正（批准，部分冲正）</strong> → <strong>消费（已清算）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>部分冲正，原交易会进行清算</em> </p>\n</blockquote>\n</li>\n<li><p><strong>强制清算（已清算）</strong> → <strong>结束</strong></p>\n<blockquote>\n<p><em>无授权直接清算的交易</em></p>\n</blockquote>\n</li>\n</ul>\n<hr />\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>card.transaction</td>\n<td>卡交易</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>transaction_date</td>\n<td>int</td>\n<td>交易时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>clearing_date</td>\n<td>int/null</td>\n<td>清算时间（Unix 时间戳，可能为空）</td>\n</tr>\n<tr>\n<td>card_nickname</td>\n<td>string/null</td>\n<td>卡片昵称</td>\n</tr>\n<tr>\n<td>card_id</td>\n<td>string</td>\n<td>虚拟卡 ID</td>\n</tr>\n<tr>\n<td>billing_amount</td>\n<td>string</td>\n<td>账单金额</td>\n</tr>\n<tr>\n<td>billing_currency</td>\n<td>string</td>\n<td>账单币种</td>\n</tr>\n<tr>\n<td>transaction_amount</td>\n<td>string</td>\n<td>交易金额</td>\n</tr>\n<tr>\n<td>transaction_currency</td>\n<td>string</td>\n<td>交易币种</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>交易状态  <br />- approved: 批准  <br />- fail: 拒绝  <br />- cleared: 已清算</td>\n</tr>\n<tr>\n<td>transaction_id</td>\n<td>string</td>\n<td>交易唯一标识 ID</td>\n</tr>\n<tr>\n<td>transaction_type</td>\n<td>string</td>\n<td>交易类型  <br />- authorization: 消费  <br />- net_clearing: 清算差额  <br />- reversal: 冲正  <br />- refund: 退款  <br />- clearing: 强制清算</td>\n</tr>\n<tr>\n<td>origin_transaction_id</td>\n<td>string/null</td>\n<td>原始交易 ID（如退款或冲正时关联）</td>\n</tr>\n<tr>\n<td>approval_code</td>\n<td>string</td>\n<td>授权码</td>\n</tr>\n<tr>\n<td>merchant_name</td>\n<td>string</td>\n<td>商户名称</td>\n</tr>\n<tr>\n<td>merchant_category_code</td>\n<td>string</td>\n<td>商户类别代码（MCC）</td>\n</tr>\n<tr>\n<td>failure_reason</td>\n<td>string</td>\n<td>失败原因代码（如存在）</td>\n</tr>\n<tr>\n<td>failure_reason_description</td>\n<td>string</td>\n<td>失败原因描述（如存在）</td>\n</tr>\n<tr>\n<td>fund_direction</td>\n<td>string/int</td>\n<td>资金方向：0 表示支出，1 表示收入</td>\n</tr>\n<tr>\n<td>reversal_amount</td>\n<td>string</td>\n<td>若消费存在冲正，该字段表示冲正金额，无冲正时为 0</td>\n</tr>\n<tr>\n<td>settlement_amount</td>\n<td>string</td>\n<td>最终结算金额（含手续费）  <br />- 支出类交易（如消费、清算差额、清算）为正数  <br />- 收入类交易（如退款、冲正）为负数，表示返还给卡的金额</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"0cce0fc9-37fe-47fa-ba07-2cb7daf30b5b","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"签名算法，支持 MD5 或 RSA","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"数据签名","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"},{"key":"Event","value":"card.transaction","description":"通知事件类型","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"transaction_date\": 1738893795,\n    \"clearing_date\": null,\n    \"card_nickname\": null,\n    \"card_id\": \"C2506181547110001\",\n    \"billing_amount\": \"40\",\n    \"billing_currency\": \"HKD\",\n    \"transaction_amount\": \"5\",\n    \"transaction_currency\": \"USD\",\n    \"fee\": \"5.6\",\n    \"fee_currency\": \"HKD\",\n    \"status\": \"approved\",\n    \"transaction_id\": \"A1887683511972196354\",\n    \"transaction_type\": \"authorization\",\n    \"origin_transaction_id\": null,\n    \"approval_code\": \"209500\",\n    \"merchant_name\": \"HYATT REGENCY HK SHA T\",\n    \"merchant_category_code\": \"5311 Department Stores\",\n    \"failure_reason\": \"000000\",\n    \"failure_reason_description\": \"\",\n    \"fund_direction\": \"0\",\n    \"reversal_amount\": \"0\",\n    \"settlement_amount\": \"45.6\"\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"7a905ea3-1a10-45c9-9fb5-06e017d836e5"}],"id":"2711d246-b40d-4c09-a489-40f118a7f0eb","_postman_id":"2711d246-b40d-4c09-a489-40f118a7f0eb","description":""},{"name":"Connect API","item":[{"name":"Connect Merchant","item":[{"name":"Create Connect Merchant","event":[{"listen":"prerequest","script":{"id":"fdc7b5e7-c648-4e27-964c-7a9a2f604ad2","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"6b764d0a-a20e-4928-b43f-1ee0193301dc","exec":["pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response has merchant info', function () {","    const jsonData = pm.response.json();","    pm.expect(jsonData.result).to.have.property('name');","    pm.expect(jsonData.result).to.have.property('email');","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"4897fe17-09a3-4d71-931b-deb6d32ffbb0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"name\": \"Sub Merchant Name\",\n    \"email\": \"submerchant@example.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/merchant","description":"<p>创建一个 Connect 子商户。</p>\n<p>成功后将返回Bit2Go子商户ID <code>merchant_no</code>，用于后续在请求 Header 中指定 Connect 商户身份。</p>\n<hr />\n<h3 id=\"请求字段：\">请求字段：</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>custom_id</td>\n<td>是</td>\n<td>string</td>\n<td>子商户在商户端的唯一请求码。</td>\n</tr>\n<tr>\n<td>name</td>\n<td>是</td>\n<td>string</td>\n<td>子商户名称</td>\n</tr>\n<tr>\n<td>email</td>\n<td>是</td>\n<td>string</td>\n<td>子商户邮箱</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"请求成功的响应字段：\">请求成功的响应字段：</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>数值类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>custom_id</td>\n<td>string</td>\n<td>客户请求唯一ID</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>Bit2Go商户ID</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>商户名</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>商户邮箱</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>商户创建时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","connect","merchant"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"b865bc1d-f107-479f-84c7-7174bcb19613","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"custom_id\": \"custom_merchant_0001\",\n    \"name\": \"Connect-A\",\n    \"email\": \"Connect-A@bit2go.io\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/merchants"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"custom_id\": \"custom_merchant_0001\",\n    \"merchant_no\": \"test_MZ00001\",\n    \"name\": \"Connect-A\",\n    \"email\": \"Connect-A@bit2go.io\",\n    \"created_at\": 1765522593\n}"}],"_postman_id":"4897fe17-09a3-4d71-931b-deb6d32ffbb0"},{"name":"Update Connect Merchant","event":[{"listen":"prerequest","script":{"id":"1d3ba2e4-9ba2-488c-bc22-8752fc7093ab","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"06008276-f60b-4504-8a7b-fc5d9deb00a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"merchant_no\": \"sub_merchant_no\",\n    \"name\": \"Updated Merchant Name\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/merchant/update","description":"<p>更新 Connect 子商户信息。</p>\n<p>仅支持修改子商户名称。请求需包含 <code>merchant_no</code> 作为商户唯一标识。</p>\n<hr />\n<h3 id=\"请求字段：\">请求字段：</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>merchant_no</td>\n<td>否</td>\n<td>string</td>\n<td>Bit2Go 商户ID</td>\n</tr>\n<tr>\n<td>name</td>\n<td>是</td>\n<td>string</td>\n<td>更新后的子商户名称</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"请求成功的响应字段：\">请求成功的响应字段：</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>数值类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>custom_id</td>\n<td>string</td>\n<td>客户请求唯一ID</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>Bit2Go商户ID</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>商户名</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>商户邮箱</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>商户创建时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","connect","merchant","update"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"70d94586-00f8-4ddc-b489-6fdee03cb131","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"merchant_no\": \"test_MZ00001\",\n    \"name\": \"Connect-A-Updated\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/merchants/update"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"custom_id\": \"custom_merchant_0001\",\n    \"merchant_no\": \"test_MZ00001\",\n    \"name\": \"Connect-A-Updated\",\n    \"email\": \"Connect-A@bit2go.io\",\n    \"created_at\": 1765523324\n}"}],"_postman_id":"06008276-f60b-4504-8a7b-fc5d9deb00a8"},{"name":"List Connect Merchants","event":[{"listen":"prerequest","script":{"id":"455fb4f2-ff6d-4779-8730-49a1e95ef269","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"ccbbdf4f-b6ed-438c-9c8a-30e174e7e79b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"MD5","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"merchant_no\": null,\n    \"email\": null,\n    \"start_time\": null,\n    \"end_time\": null\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/merchant/list","description":"<p>查看自己创建的Connect商户</p>\n<hr />\n<h2 id=\"请求字段\">请求字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>custom_id</td>\n<td>否</td>\n<td>string</td>\n<td>Connect 商户唯一编号</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>否</td>\n<td>string</td>\n<td>Bit2Go 商户ID</td>\n</tr>\n<tr>\n<td>email</td>\n<td>否</td>\n<td>string</td>\n<td>商户邮箱</td>\n</tr>\n<tr>\n<td>name</td>\n<td>否</td>\n<td>string</td>\n<td>商户名称</td>\n</tr>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>商户创建的时间查询 - 启始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>商户创建的时间查询 - 结束时间</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"响应字段\">响应字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>数值类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>custom_id</td>\n<td>string</td>\n<td>客户请求唯一ID</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>Bit2Go商户ID</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>商户名</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>商户邮箱</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>商户创建时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","connect","merchant","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"b223127e-14ab-49d5-ba4e-4177d3785fd4","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"MD5","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"merchant_no\": \"test_MZ00001\",\n    \"email\": null,\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/merchants/list"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n   \"code\":200,\n   \"message\":\"\",\n   \"result\":{\n      \"count\":1,\n      \"next\":null,\n      \"previous\":null,\n      \"page_size\":20,\n      \"page\":1,\n      \"results\":[\n         {\n            \"custom_id\":\"custom_merchant_0001\",\n            \"merchant_no\":\"test_MZ00001\",\n            \"name\":\"Connect-A\",\n            \"email\":\"Connect-A@bit2go.io\",\n            \"created_at\":1765524360,\n            \"status\":1\n         }\n      ]\n   }\n}"}],"_postman_id":"ccbbdf4f-b6ed-438c-9c8a-30e174e7e79b"}],"id":"704f8dd3-9c02-44e9-9d5b-5bef37715637","description":"<p>Connect Merchant 用于管理主商户与其子商户之间的链接关系。</p>\n<blockquote>\n<p>该模块仅限主商户使用。</p>\n</blockquote>\n","_postman_id":"704f8dd3-9c02-44e9-9d5b-5bef37715637"},{"name":"Connect Transfer","item":[{"name":"Create Connect Transfer","event":[{"listen":"prerequest","script":{"id":"fdb053ae-420a-4eab-87b5-9239ffc3a87d","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"4d055078-1ffd-4e06-9154-76b249667a30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"destination\": \"Connect Merchant ID\",\n    \"currency\": \"USD\",\n    \"amount\": \"100.00\",\n    \"remarks\": \"Transfer Remarks\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/transfer","description":"<p>创建一笔 Connect 内部转账时，支持以下两种操作模式：</p>\n<p><strong>1. 主商户向子商户转账（主 → 子）</strong><br />系统会默认将主账号视为付款方。你只需在请求体中填写目标子商户的商户 ID 作为接收方。</p>\n<p><strong>2. 子商户向主商户转账（子 → 主）</strong><br />你可以在请求头中通过 <code>ConnectMerchant</code> 指定代替操作的子商户。系统会将该子商户视为付款方，同时在请求体中填写主商户的商户 ID 作为接收方，即可完成子商户向主账号的转账。</p>\n<p>在请求之前，您可以先查看一下当前请求的<strong>行为主体</strong>，避免转账异常。</p>\n<hr />\n<h2 id=\"请求字段\">请求字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>是</td>\n<td>string</td>\n<td>接收方商户ID。</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>string</td>\n<td>币种，例如 <code>USD</code></td>\n</tr>\n<tr>\n<td>amount</td>\n<td>是</td>\n<td>string</td>\n<td>转账金额</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>否</td>\n<td>string</td>\n<td>备注说明，用于标记转账用途</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"响应字段\">响应字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>转账金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>币种</td>\n</tr>\n<tr>\n<td>source</td>\n<td>string</td>\n<td>付款方商户ID</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>string</td>\n<td>收款方商户ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>string</td>\n<td>备注（若未设置则为空）</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>生成订单时间</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","connect","transfer"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"6fd0f397-3ef0-48f8-b7db-369540d6c8c1","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"custom_order_0001\",\n    \"destination\": \"test_MZ00001\",\n    \"currency\": \"USD\",\n    \"amount\": 100,\n    \"remarks\": \"Connect transfer to connect merchant\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/transfer"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": \"custom_order_0001\",\n        \"bit2go_id\": \"02512120739120001\",\n        \"source\": \"test_MY00001\",\n        \"destination\": \"test_MR00001\",\n        \"currency\": \"USD\",\n        \"amount\": \"100.00\",\n        \"status\": \"paid\",\n        \"remarks\": \"Connect transfer to connect merchant\",\n        \"created_at\": 1765525152\n    }\n}"}],"_postman_id":"4d055078-1ffd-4e06-9154-76b249667a30"},{"name":"Connect Transfers History","event":[{"listen":"prerequest","script":{"id":"e67de458-1dee-4815-9893-dbb46435bb38","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"d4bd0c0b-6d9a-431b-b677-6626cd42a29d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/transfer/list","description":"<p>查询自己作为付款商户发起的Connect 转账记录。</p>\n<hr />\n<h2 id=\"请求字段\">请求字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>否</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>否</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>否</td>\n<td>string</td>\n<td>接收方商户ID。</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>币种，例如 <code>USD</code></td>\n</tr>\n<tr>\n<td>status</td>\n<td>否</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>Connect 转账的起始时间戳</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>Connect 转账的截止时间戳</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"响应字段\">响应字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>payout_id</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>转账金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>币种</td>\n</tr>\n<tr>\n<td>source</td>\n<td>string</td>\n<td>付款商户ID</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>string</td>\n<td>收款商户ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>string</td>\n<td>备注（若未设置则为空）</td>\n</tr>\n<tr>\n<td>create_at</td>\n<td>string</td>\n<td>生成订单时间</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","connect","transfer","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"ba409168-3e93-4403-9b52-4f301f078070","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key的令牌","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/connect/transfer/list"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"order_id\": \"custom_order_0001\",\n                \"bit2go_id\": \"02512120739120001\",\n                \"source\": \"test_MY00001\",\n                \"destination\": \"test_MR00001\",\n                \"currency\": \"USD\",\n                \"amount\": \"100.00\",\n                \"status\": \"paid\",\n                \"remarks\": \"Connect transfer to connect merchant\",\n                \"created_at\": 1765525152\n            }\n        ]\n    }\n}"}],"_postman_id":"d4bd0c0b-6d9a-431b-b677-6626cd42a29d"}],"id":"d8e5c94e-a819-46eb-b1dd-af9922a6c51b","description":"<p>Connect Transfer 支持主商户与子商户之间的双向资金划转。</p>\n","_postman_id":"d8e5c94e-a819-46eb-b1dd-af9922a6c51b"}],"id":"f6559681-0d14-47ae-bdce-65d84b5a2177","description":"<p>Connect 模块用于构建 Connect 商户体系，使主商户能够创建并管理多个子商户，并在主商户与子商户之间实现内部资金划转。</p>\n<hr />\n<p>在开始之前，Bit2Go需要跟您明确当前请求<strong>行为主体</strong>的规则。这会对接下来关于<code>Connect</code>相关功能的开发非常有帮助。</p>\n<p><strong>主商户</strong></p>\n<blockquote>\n<p>当您想要以主商户进行业务行为时。需要在请求的<code>Headers</code>中<strong>仅需要包含</strong><code>Merchant</code>。<br />Bit2Go会将本次请求的 <strong>行为主体视为主商户</strong> ，所有资金与业务行为均由主商户的名义发起。 </p>\n</blockquote>\n<p><strong>代子商户</strong></p>\n<blockquote>\n<p>当您想要代替子商户(<code>Connect Merchant</code>)进行业务行为时候；<br />需要在请求的<code>Headers</code>中包含<code>Merchant</code>和<code>ConnectMerchant</code>。<br />Bit2Go会将本次请求的 <strong>行为主体视为子商户</strong> ，资金和业务行为由子商户的名义发起。 </p>\n</blockquote>\n<hr />\n<p>在明确请求的<strong>行为主体</strong>后，您可以更方便的开始使用<code>Connect</code>模块。</p>\n<p>Connect Merchant - <strong>商户账户管理</strong></p>\n<blockquote>\n<p>创建与维护子商户信息。 仅限当前<strong>行为主体</strong> 为主商户的请求进行业务行为。 </p>\n</blockquote>\n<p>Connect Transfer - <strong>商户之间资金转账</strong></p>\n<blockquote>\n<p>支持主商户与子商户之间的双向资金划转。<strong>行为主体</strong>可以是主/子商户。 </p>\n</blockquote>\n<hr />\n<p>当您需要获取 <strong>子商户</strong> 的账户余额时，可通过 <strong>Balance</strong> 接口完成。</p>\n<blockquote>\n<p>Balance 接口同样支持 Connect 请求规则，行为主体的判定方式与 Connect 模块保持一致。</p>\n</blockquote>\n","_postman_id":"f6559681-0d14-47ae-bdce-65d84b5a2177"},{"name":"KYC API","item":[{"name":"Get KYC Auth Link","event":[{"listen":"prerequest","script":{"id":"cfb78a42-b2dd-4d3d-8bd6-ff66b565334c","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"505c1c86-963b-4289-a709-090f2d7637b9","exec":["pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response has KYC url', function () {","    const jsonData = pm.response.json();","    pm.expect(jsonData.result).to.have.property('url');","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"192b12f5-d3a7-4c48-b32b-c9a5b3ef3600","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户 ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"MD5","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/kyc/link","description":"<p>当商户处于如下情况时，可以获取或重新获取链接：</p>\n<ul>\n<li><p>初次申请 KYC 验证。</p>\n</li>\n<li><p>KYC 状态被提醒补充材料。</p>\n</li>\n<li><p>KYC 验证被意外结束，需要继续进行验证。</p>\n</li>\n</ul>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>ttl_in_secs</td>\n<td>否</td>\n<td>int</td>\n<td>生成的链接的有效期（以秒为单位）。默认值为 30 分钟。</td>\n</tr>\n<tr>\n<td>redirect_success_url</td>\n<td>否</td>\n<td>string</td>\n<td>完成后的跳转链接。  <br />可传空单独打开页面，操作完成后即可关闭。</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>url</td>\n<td>url</td>\n<td>用于 KYC 验证的链接。</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>Bit2Go 商户ID。  <br />用于二次确认 KYC 验证链接的商户。</td>\n</tr>\n<tr>\n<td>ttl_in_secs</td>\n<td>int</td>\n<td>生成的链接的有效期（以秒为单位）。</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>生成的时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","kyc","link"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"850bd48e-de48-4343-8910-49498a704ab8","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户 ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"MD5","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/kyc/link"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"ttl_in_secs\": 1800,\n    \"merchant_no\": \"test_MX00001\",\n    \"url\": \"https: //in.sumsub.com/websdk/p/VM1WreMdt0cJQ1BW\",\n    \"created_at\": 1765521404\n}"}],"_postman_id":"192b12f5-d3a7-4c48-b32b-c9a5b3ef3600"},{"name":"Get KYC Status","event":[{"listen":"prerequest","script":{"id":"06439658-446f-4879-b15e-cfc0961cfde2","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"f5bf849f-0dc2-40d3-86c3-6274832ff935","exec":["pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response has KYC status', function () {","    const jsonData = pm.response.json();","    pm.expect(jsonData.result).to.have.property('status');","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"2b130421-c0f6-4bc0-a867-1ae049864fbd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/kyc/status","description":"<p>用于查询当前登录商户KYC的验证状态</p>\n<h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>int</td>\n<td>KYC状态：</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>KYC的商户ID。用于二次确认kyc链接是主商户还是子商户</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"kyc状态说明：\">KYC状态说明：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>数值</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>0</td>\n<td>初始状态（未申请过url）</td>\n</tr>\n<tr>\n<td>1</td>\n<td>开始认证（已经申请url，未提交资料）</td>\n</tr>\n<tr>\n<td>2</td>\n<td>认证中（提交部分资料）</td>\n</tr>\n<tr>\n<td>3</td>\n<td>审核中（已提交资料，等待平台合规审核）</td>\n</tr>\n<tr>\n<td>10</td>\n<td>成功</td>\n</tr>\n<tr>\n<td>11</td>\n<td>拒绝</td>\n</tr>\n<tr>\n<td>12</td>\n<td>补充材料（重新获取url，补充提交资料）</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","kyc","status"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"69e1bfbc-28d2-4038-abba-422a1fceebe5","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/kyc/status"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": 1,\n    \"merchant_no\": \"test_MS00001\",\n    \"timestamp\": 1765522044\n}"}],"_postman_id":"2b130421-c0f6-4bc0-a867-1ae049864fbd"},{"name":"KYC Webhook","id":"6383842e-df30-4b17-8cd8-8617a6985883","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"payout.paid","description":"<p>通知事件类型: payout.paid；payout.fail</p>\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>kyc.status</td>\n<td>kyc状态</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"kyc状态说明：\">KYC状态说明：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>数值</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>0</td>\n<td>初始状态（未申请过url）</td>\n</tr>\n<tr>\n<td>1</td>\n<td>开始认证（已经申请url，未提交资料）</td>\n</tr>\n<tr>\n<td>2</td>\n<td>认证中（提交部分资料）</td>\n</tr>\n<tr>\n<td>3</td>\n<td>审核中</td>\n</tr>\n<tr>\n<td>10</td>\n<td>成功</td>\n</tr>\n<tr>\n<td>11</td>\n<td>拒绝</td>\n</tr>\n<tr>\n<td>12</td>\n<td>补充材料（重新获取url，补充提交资料）</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>Bit2Go商户ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>KYC状态</td>\n</tr>\n<tr>\n<td>timestamp</td>\n<td>int</td>\n<td>通知时间戳(秒级)</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"066cbaa0-683b-4b0a-9bf3-c43434a2f704","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"},{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Event","value":"payout.paid","description":"通知事件类型: payout.paid；payout.fail","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"merchant_no\": \"test_MS00001\",\n    \"status\": 1,\n    \"timestamp\": 1765522044,\n    \"operation_type\": \"kyc.status\"\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"6383842e-df30-4b17-8cd8-8617a6985883"}],"id":"606755eb-9c1b-45a7-bf5e-08891a0add83","description":"<p>KYC 是平台提供的合规能力。当商户使用涉及合规要求的功能时，必须完成 KYC 验证后才能继续使用相关服务。</p>\n<hr />\n<p>你可通过以下的步骤完成KYC验证</p>\n<p><strong>获取KYC链接</strong></p>\n<blockquote>\n<p>商户可以代子商户获取子商户的 KYC 验证链接，子商户需通过该链接完成实名验证流程。 </p>\n</blockquote>\n<p><strong>填写KYC资料</strong></p>\n<blockquote>\n<p>商户在页面中提交身份与业务信息。需根据平台要求提供企业/个人信息、证件资料或经营说明等内容。 </p>\n</blockquote>\n<p><strong>等待审核</strong></p>\n<blockquote>\n<p>平台将对商户提交的资料进行合规审核。<br />审核时间依国家与类型而不同。 </p>\n</blockquote>\n<p><strong>获取审核结果</strong></p>\n<blockquote>\n<p>当审核完成后，Bit2Go将主动发送 <code>Webhook</code>到商户，也可以通过<code>主动查询</code> 接口来查询KYC状态。<br />审核状态的完整映射表请参考对应的接口文档。 </p>\n</blockquote>\n<p><strong>根据审核结果进行后续处理</strong></p>\n<blockquote>\n<p>当获取到审核结果后，以下三种情况需要区分进行后续的操作</p>\n</blockquote>\n","_postman_id":"606755eb-9c1b-45a7-bf5e-08891a0add83"},{"name":"GlobalTransfer","item":[{"name":"Benficiary APIs","item":[{"name":"Get Transfer Methods","event":[{"listen":"prerequest","script":{"id":"89bbfa7f-c945-4409-bf4e-10e7d2c2008b","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"eb78e739-f25a-40af-953e-763f173e13b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key令牌</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"country\": null,\n    \"currency\": null,\n    \"method\": null\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/methods","description":"<p>获取 Bit2Go 支持的转账场景列表。</p>\n<p>通过指定的银行国家代码、转账方式（如 <code>LOCAL</code>、<code>SWIFT</code>），返回可用的转账方式。</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>货币编码</td>\n</tr>\n<tr>\n<td>country</td>\n<td>否</td>\n<td>string</td>\n<td>2位国家/地区编码</td>\n</tr>\n<tr>\n<td>method</td>\n<td>否</td>\n<td>string</td>\n<td>转账方式,仅限<code>LOCAL</code>/<code>SWIFT</code>/<code>WALLET</code></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>货币编码</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>2位国家/地区编码</td>\n</tr>\n<tr>\n<td>method</td>\n<td>string</td>\n<td>转账方式  <br /><code>LOCAL</code>/<code>SWIFT</code>/<code>WALLET</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","methods"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"e7ce076d-c9e9-4aad-94f5-e51498da68e3","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"},{"key":"Token","value":"","description":"API Key令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"country\": \"HK\",\n    \"currency\": \"USD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/methods"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": [\n        {\n            \"country\": \"HK\",\n            \"currency\": \"USD\",\n            \"method\": \"SWIFT\"\n        }\n    ]\n}"}],"_postman_id":"eb78e739-f25a-40af-953e-763f173e13b2"},{"name":"Get Beneficiary Schema","event":[{"listen":"prerequest","script":{"id":"de9d4253-4390-43b6-899a-1925b9a0a2de","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"53e7d018-2073-41bf-86c6-a6493644cced","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"country\": \"US\",\n    \"currency\": \"USD\",\n    \"method\": \"LOCAL\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiary-schema","description":"<h4 id=\"受益人规则\">受益人规则</h4>\n<p>请选择Bit2Go支持的转账场景，获取创建受益人所需要的动态要求。</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>货币编码</td>\n</tr>\n<tr>\n<td>country</td>\n<td>否</td>\n<td>string</td>\n<td>2位国家/地区编码</td>\n</tr>\n<tr>\n<td>method</td>\n<td>否</td>\n<td>string</td>\n<td>转账方式,仅限<code>LOCAL</code>/<code>SWIFT</code>/<code>WALLET</code></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>货币编码</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>2位国家/地区编码</td>\n</tr>\n<tr>\n<td>method</td>\n<td>string</td>\n<td>支付方式  <br /><code>LOCAL</code>/<code>SWIFT</code>/<code>WALLET</code></td>\n</tr>\n<tr>\n<td>beneficiary_fields</td>\n<td>list</td>\n<td>当前转账方案中创建受益人所需要的动态字段要求的列表</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"动态字段要求返回格式：\">动态字段要求返回格式：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>字段名</td>\n</tr>\n<tr>\n<td>rule</td>\n<td>objects</td>\n<td>字段规则</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>字段规则格式:</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>上传类型</td>\n</tr>\n<tr>\n<td>required</td>\n<td>string</td>\n<td><code>Y</code>为必填</td>\n</tr>\n<tr>\n<td>regex</td>\n<td>string</td>\n<td>验证正则，如空则无需验证</td>\n</tr>\n<tr>\n<td>maxLength</td>\n<td>string</td>\n<td>最大长度</td>\n</tr>\n<tr>\n<td>enumContent</td>\n<td>list</td>\n<td>如有值，需要在提供的列表里面选择。  <br /><code>[{ \"label\": xx, \"value\": xx }]</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","beneficiary-schema"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"c85d2718-2472-446b-8267-80fb6fb294ca","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID\n","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"country\": \"HK\",\n    \"currency\": \"USD\",\n    \"method\": \"SWIFT\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiary-schema"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"country\": \"HK\",\n        \"currency\": \"USD\",\n        \"method\": \"SWIFT\",\n        \"beneficiary_fields\": [\n            {\n                \"name\": \"account_no\",\n                \"rule\": {\n                    \"type\": \"string\",\n                    \"regex\": \"\",\n                    \"required\": \"Y\",\n                    \"maxLength\": \"33\",\n                    \"enumContent\": []\n                }\n            }\n        ]\n    }\n}"}],"_postman_id":"53e7d018-2073-41bf-86c6-a6493644cced"},{"name":"Create Beneficiary","event":[{"listen":"prerequest","script":{"id":"66e64dac-66fb-424e-9965-b9840a9d2d27","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"0cc09c99-9261-4ecd-b3df-dbc6edbdfc0b","exec":["pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response has beneficiary id', function () {","    const jsonData = pm.response.json();","    pm.expect(jsonData.result).to.have.property('id');","    pm.collectionVariables.set('beneficiary_id', jsonData.result.id);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"1b62b499-b3db-40f8-8dc9-809c6b2241a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"country\": \"US\",\n    \"currency\": \"USD\",\n    \"method\": \"WIRE\",\n    \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiaries","description":"<p>创建具体的受益人。</p>\n<p>根据 <strong>受益人规则</strong>（Get Beneificary Schema）中要求的字段来提交受益人材料；该模式是动态的。</p>\n<hr />\n<h2 id=\"请求参数：\">请求参数：</h2>\n<blockquote>\n<p>本文档中以一种方式举例说明，数据为模拟数据。<br />仅供参考，实际情况根据如下步骤进行验证和提交资料。 </p>\n</blockquote>\n<h4 id=\"获取受益人规则\">获取受益人规则</h4>\n<p>请求 <strong>创建受益人规则</strong> 付款方式为 <code>HK</code> + <code>USD</code> + <code>SWIFT</code>；<br />返回信息中<code>beneficiary_fields</code>会有具体的字段要求，例如：</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"beneficiary_fields\":[\n     {\n        \"name\":\"account_no\",\n        \"rule\":{\n           \"type\":\"string\",\n           \"regex\":\"^(?:\\\\w{3,33}|[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\\\\.[a-zA-Z0-9-.]+)$\",\n           \"required\":\"Y\",\n           \"maxLength\":\"33\",\n           \"enumContent\":[],\n        }\n     }\n  ]\n}\n\n</code></pre>\n<h4 id=\"请求字段\">请求字段</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>string</td>\n<td>货币编码</td>\n</tr>\n<tr>\n<td>country</td>\n<td>是</td>\n<td>string</td>\n<td>2位国家/地区编码</td>\n</tr>\n<tr>\n<td>method</td>\n<td>是</td>\n<td>string</td>\n<td>转账方式,仅限<code>LOCAL</code>/<code>SWIFT</code>/<code>WALLET</code></td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>是</td>\n<td>object</td>\n<td>受益人规则中要求的具体字段的值</td>\n</tr>\n</tbody>\n</table>\n</div><p><code>beneficiary</code> 中根据<strong>创建受益人规则</strong>中返回的<code>beneficiary_fields</code>中要求的具体字段创建受益人，如：</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_no</td>\n<td>是</td>\n<td>string</td>\n</tr>\n<tr>\n<td>...</td>\n<td></td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>int</td>\n<td>受益人状态  <br /><code>0</code> - 待审核  <br /><code>2</code> - 审核中  <br /><code>1</code> - 通过  <br /><code>-1</code> - 拒绝</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>创建受益人的商户ID。</td>\n</tr>\n<tr>\n<td>transfer_method</td>\n<td>object</td>\n<td>受益人的支付方式</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>创建的受益人信息</td>\n</tr>\n<tr>\n<td>beneficiary_fields</td>\n<td>object</td>\n<td>受益人规则要求的字段明细</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>创建时间戳。</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","beneficiaries"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"addbe205-434b-49dd-94db-d43ae75d00cc","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"数据签名","type":"text"},{"key":"Sign","value":"","description":"API Key 的令牌","type":"text"},{"key":"Token","value":"","description":"请求时间戳","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"country\": \"HK\",\n    \"method\": \"SWIFT\",\n    \"beneficiary\": {\n        \"account_no\": \"123\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiaries"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"id\": 64,\n        \"merchant_no\": \"test_MD00001\",\n        \"name\": \"-\",\n        \"account_type\": \"individual\",\n        \"transfer_method\": {\n            \"country\": \"HK\",\n            \"currency\": \"USD\",\n            \"method\": \"SWIFT\"\n        },\n        \"beneficiary_fields\": [\n            {\n                \"name\": \"account_no\",\n                \"rule\": {\n                    \"type\": \"string\",\n                    \"regex\": \"\",\n                    \"required\": \"Y\",\n                    \"maxLength\": \"33\",\n                    \"enumContent\": []\n                }\n            }\n        ],\n        \"beneficiary\": {\n            \"account_no\": \"123\"\n        },\n        \"status\": 2,\n        \"created_at\": 1765611218\n    }\n}"}],"_postman_id":"1b62b499-b3db-40f8-8dc9-809c6b2241a7"},{"name":"Update Beneficiary","event":[{"listen":"prerequest","script":{"id":"dda51268-9f40-42ae-a5b6-23b320e3029f","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"7eb8fc07-043b-4aee-99c3-e4b1221ad8d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"beneficiary\": \"{{beneficiary_id}}\",\n    \"first_name\": \"Jane\",\n    \"address_detail\": \"456 New St\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiaries/update","description":"<p>修改已经存在的受益人。</p>\n<p>根据 <strong>受益人规则</strong>（Get Beneificary Schema）中要求的字段来提交受益人材料；</p>\n<blockquote>\n<p>受益人在<code>已通过</code>或<code>审核中</code>时，不可修改。 </p>\n</blockquote>\n<hr />\n<h4 id=\"修改受益人\">修改受益人</h4>\n<p>根据<strong>创建受益人模式</strong>中返回的<code>beneficiary_fields</code>中要求的具体字段创建受益人，如：</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>说明</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>beneficiary_id</td>\n<td>是</td>\n<td>string</td>\n<td>受益人ID</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>是</td>\n<td>object</td>\n<td>修改的受益人的相关字段</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>int</td>\n<td>受益人状态  <br /><code>0</code> - 待审核  <br /><code>2</code> - 审核中  <br /><code>1</code> - 通过  <br /><code>-1</code> - 拒绝</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>创建受益人的商户ID。</td>\n</tr>\n<tr>\n<td>transfer_method</td>\n<td>object</td>\n<td>受益人的支付方式</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>创建的受益人信息</td>\n</tr>\n<tr>\n<td>beneficiary_fields</td>\n<td>object</td>\n<td>受益人规则要求的字段明细</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>创建时间戳。</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","beneficiaries","update"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"ae7b6dc5-79cd-462b-8bd5-e72481ca6e4b","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"beneficiary_id\": 2,\n    \"beneficiary\": {\n        \"account_no\": \"321\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiaries/update"},"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":""}],"_postman_id":"7eb8fc07-043b-4aee-99c3-e4b1221ad8d9"},{"name":"List Beneficiaries","event":[{"listen":"prerequest","script":{"id":"360aaa04-b8d1-4714-b794-8cfbdf4e3a7f","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"5317bf72-8278-4524-a55e-f7194349ffa6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"page\": 1,\n    \"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiaries/list","description":"<p>已创建的受益人列表。</p>\n<hr />\n<h2 id=\"请求字段\">请求字段</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>字段</th>\n<th>必选</th>\n<th>类型</th>\n<th>描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>2位货币编码</td>\n</tr>\n<tr>\n<td>country</td>\n<td>否</td>\n<td>string</td>\n<td>3位国家编码</td>\n</tr>\n<tr>\n<td>method</td>\n<td>否</td>\n<td>string</td>\n<td>转账方式；<code>SWIFT</code>, <code>LOCAL</code>,<code>WALLET</code></td>\n</tr>\n<tr>\n<td>account_no</td>\n<td>否</td>\n<td>string</td>\n<td>受益人账号</td>\n</tr>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>Connect 转账的起始时间戳</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>Connect 转账的截止时间戳</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"返回字段：\">返回字段：</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>int</td>\n<td>受益人状态  <br /><code>0</code> - 待审核  <br /><code>2</code> - 审核中  <br /><code>1</code> - 通过  <br /><code>-1</code> - 拒绝</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>创建受益人的商户ID。</td>\n</tr>\n<tr>\n<td>transfer_method</td>\n<td>object</td>\n<td>受益人的支付方式</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>创建的受益人信息</td>\n</tr>\n<tr>\n<td>beneficiary_fields</td>\n<td>object</td>\n<td>受益人规则要求的字段明细</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>创建时间戳。</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","beneficiaries","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"89f58a46-ada8-4a5e-bdb6-8b7cdcce6f89","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"page\": 1,\n    \"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/beneficiaries/list"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"id\": 4,\n                \"merchant_no\": \"test_MD00001\",\n                \"name\": \"-\",\n                \"account_type\": \"individual\",\n                \"transfer_method\": {\n                    \"country\": \"HK\",\n                    \"currency\": \"USD\",\n                    \"method\": \"SWIFT\"\n                },\n                \"beneficiary_fields\": [\n                    {\n                        \"name\": \"account_no\",\n                        \"rule\": {\n                            \"type\": \"string\",\n                            \"regex\": \"\",\n                            \"required\": \"Y\",\n                            \"maxLength\": \"33\",\n                            \"enumContent\": []\n                        }\n                    }\n                ],\n                \"status\": 2,\n                \"created_at\": 1765788962,\n                \"beneficiary\": {\n                    \"account_no\": \"123\"\n                }\n            }\n        ]\n    }\n}"}],"_postman_id":"5317bf72-8278-4524-a55e-f7194349ffa6"},{"name":"Beneficiary Webhook","id":"003102cc-da87-4cf6-b70f-e2198e46036d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"payout.paid","description":"<p>通知事件类型: payout.paid；payout.fail</p>\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>beneificiary.status</td>\n<td>受益人状态</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"kyc状态说明：\">KYC状态说明：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>数值</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>0</td>\n<td>待审核</td>\n</tr>\n<tr>\n<td>1</td>\n<td>通过</td>\n</tr>\n<tr>\n<td>2</td>\n<td>审核中</td>\n</tr>\n<tr>\n<td>-1</td>\n<td>拒绝</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>受益人号</td>\n</tr>\n<tr>\n<td>merchant_no</td>\n<td>string</td>\n<td>创建受益人的Bit2Go商户号</td>\n</tr>\n<tr>\n<td>status</td>\n<td>int</td>\n<td>受益人状态</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>创建时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"c1338f29-9597-4ade-bff7-551df657756f","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"},{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Event","value":"payout.paid","description":"通知事件类型: payout.paid；payout.fail","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"id\": \"10\",\n    \"merchant_no\": \"test_MS00001\",\n    \"status\": 1,\n    \"operation_type\": \"beneficiary.status\"\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"003102cc-da87-4cf6-b70f-e2198e46036d"}],"id":"939d09eb-8455-471e-b353-bef489fd8a5c","description":"<p>在使用全球速汇款之前，需要创建 <strong>受益人</strong>。受益人提前申明被付款的个人的银行信息和付款方式。</p>\n<p>受益人在创建后需要审核，当审核成功后，可以对受益人进行付款。</p>\n<hr />\n<p>以下信息或许可以帮助您更好的了解<strong>创建受益人</strong>的流程</p>\n<p><strong>获取Bit2Go支持的转账场景</strong></p>\n<blockquote>\n<p>了解Bit2Go是否已经支持您想要付款的转账场景。 </p>\n</blockquote>\n<p><strong>获取受益人规则</strong></p>\n<blockquote>\n<p>不同的转账场景下所需的字段和相应的验证规则是不一样的。<br />从这里可以得到在特定的转账场景下，创建受益人需要的字段和验证规则。 </p>\n</blockquote>\n<p><strong>创建受益人</strong></p>\n<blockquote>\n<p>您确认转账场景和获取到明确受益人规则后，可以根据受益人的字段提交受益人资料。例如银行卡号、银行、SWIFT信息等。<br />提交资料后，Bit2Go会确认您的受益人信息，当受益人状态是<code>通过</code>后，即可发起速汇订单。 </p>\n</blockquote>\n<p><strong>更新受益人</strong></p>\n<blockquote>\n<p>当Bit2Go无法确认您的受益人(状态为<code>拒绝</code>)。您可以修改或者部分修改您的受益人信息,我们会针对您重新提交的信息再次核对信息。</p>\n</blockquote>\n","_postman_id":"939d09eb-8455-471e-b353-bef489fd8a5c"},{"name":"Global Transfer APIs","item":[{"name":"Get Transfer Fee Quote","event":[{"listen":"prerequest","script":{"id":"5ea27013-0464-434b-80be-6c807c02a2a0","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"d461fb53-91b0-476a-b269-c89faeceeeb3","exec":["pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response has quote_id', function () {","    const jsonData = pm.response.json();","    pm.expect(jsonData.result).to.have.property('quote_id');","    pm.collectionVariables.set('transfer_quote_id', jsonData.result.quote_id);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"a8ecacc8-e76e-43cd-a25b-1003f90e25ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"pay_currency\": \"USD\",\n    \"pay_amount\": \"1000.00\",\n    \"currency\": \"CNY\",\n    \"withdraw_type\": \"ALIPAY\",\n    \"from_currency\": \"USD\",\n    \"channel_code\": \"futurepay\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/fee","description":"<p>在发起全球速汇前，您可以在此获取全球速汇报价以确认您的全球速汇订单的具体金额和费率。</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<p>你可以在确定 支付货币(<code>source_currency</code>) 和 实收货币(<code>transfer_currency</code>) ， 选择填写 支付金额(<code>source_amount</code>) 和 实收金额(<code>transfer_amount</code>) 其中一项，<strong>不可都为空</strong>。</p>\n<p>报价会自动计算 <strong>全球速汇</strong> 的中间手续费已经确认 支付金额 和 实收金额。</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>source_currency</td>\n<td>是</td>\n<td>string</td>\n<td>支付货币(2位编码)</td>\n</tr>\n<tr>\n<td>source_amount</td>\n<td>否</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>transfer_currency</td>\n<td>是</td>\n<td>string</td>\n<td>实收货币(2位编码)</td>\n</tr>\n<tr>\n<td>transfer_amount</td>\n<td>否</td>\n<td>string</td>\n<td>实收金额</td>\n</tr>\n<tr>\n<td>transfer_method</td>\n<td>是</td>\n<td>string</td>\n<td>转账方式  <br /><code>SWIFT</code>/<code>WALLET</code>/<code>LOCAL</code></td>\n</tr>\n<tr>\n<td>swift_charge_option</td>\n<td>否</td>\n<td>string</td>\n<td>SWIFT手续费类型;  <br /><code>SHA</code>(default) 和 <code>OUR.</code>  <br />如转账方式不是SWIFT, 配置失效。</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>quote_id</td>\n<td>string</td>\n<td>报价ID</td>\n</tr>\n<tr>\n<td>source_currency</td>\n<td>string</td>\n<td>支付货币</td>\n</tr>\n<tr>\n<td>source_amount</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>transfer_currency</td>\n<td>string</td>\n<td>实收货币</td>\n</tr>\n<tr>\n<td>transfer_amount</td>\n<td>string</td>\n<td>实收金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费货币</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费金额</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>换汇汇率；  <br /><code>transfer_amount</code>/<code>source_amount</code></td>\n</tr>\n<tr>\n<td>swift_charge_option</td>\n<td>string</td>\n<td>SWIFT手续费类型;</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","fee"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"03ac82e7-f08d-4349-bf04-bff96be98552","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"source_currency\": \"USDT\",\n    \"source_amount\": \"100\",\n    \"transfer_currency\": \"USD\",\n    \"transfer_method\": \"SWIFT\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/fee"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"quote_id\": \"c2ca9831-74c8-42c4-a385-5edcf8b59204\",\n        \"source_amount\": \"100\",\n        \"source_currency\": \"USDT\",\n        \"transfer_amount\": \"83.36\",\n        \"transfer_currency\": \"USD\",\n        \"fee\": \"26.64\",\n        \"fee_currency\": \"USD\",\n        \"rate\": \"1.1\",\n        \"swift_charge_option\": \"SHA\"\n    }\n}"}],"_postman_id":"a8ecacc8-e76e-43cd-a25b-1003f90e25ba"},{"name":"Create Transfer Order","event":[{"listen":"prerequest","script":{"id":"1d3234c4-3991-4af1-bbc8-b276a60e5161","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"5aad43eb-ed81-4f0c-9562-21b2b6026c32","exec":["pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response has ordernumber', function () {","    const jsonData = pm.response.json();","    pm.expect(jsonData.result).to.have.property('ordernumber');","    pm.collectionVariables.set('transfer_order_number', jsonData.result.ordernumber);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"1f1f5968-b7ee-4f75-b380-3005003b480f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"beneficiary\": \"{{beneficiary_id}}\",\n    \"quote_id\": \"{{transfer_quote_id}}\",\n    \"purpose\": \"goods_payment\",\n    \"source_of_founds\": \"business_income\",\n    \"remarks\": \"Payment for services\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/order","description":"<p><strong>向受益人创建新的全球速汇转账</strong></p>\n<p><em>你可以提前获取报价单，确认报价单金额后根据报价单ID</em> <code>quote_id</code> <em>发起转账。</em></p>\n<p><em>当支付货币与实收货币不同时，转账包含换汇，并且会产生相应的费率。</em></p>\n<p>你的报价单必须和你选择的受益人接受的收款方式是一致的。例如你的受益人配置的是<code>US</code> + <code>USD</code> + <code>LOCAL</code>。 你选择其他收款方式发起订单是无效的。</p>\n<hr />\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>quote_id</td>\n<td>否</td>\n<td>string</td>\n<td>报价单ID</td>\n</tr>\n<tr>\n<td>source_currency</td>\n<td>是</td>\n<td>string</td>\n<td>支付货币(2位编码)</td>\n</tr>\n<tr>\n<td>source_amount</td>\n<td>否</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>transfer_amount</td>\n<td>否</td>\n<td>string</td>\n<td>实收金额</td>\n</tr>\n<tr>\n<td>swift_charge_option</td>\n<td>否</td>\n<td>string</td>\n<td>SWIFT手续费类型;  <br /><code>SHA</code>(default) 和 <code>OUR.</code>  <br />如转账方式不是SWIFT, 配置失效。</td>\n</tr>\n<tr>\n<td>beneficiary_id</td>\n<td>是</td>\n<td>string</td>\n<td>受益人ID; 需审核通过。</td>\n</tr>\n<tr>\n<td>transfer_purpose</td>\n<td>是</td>\n<td>string</td>\n<td>转账目的。  <br />枚举值看转账目的表。</td>\n</tr>\n<tr>\n<td>source_of_founds</td>\n<td>是</td>\n<td>string</td>\n<td>资金来源；  <br />请在如下选项中选择：  <br /><code>Salary</code> - 工资  <br /><code>Personal Savings</code> - 个人储蓄  <br /><code>Personal Wealth</code> -个人财富  <br /><code>Personal Account</code> - 个人账户  <br /><code>Retirement Funds</code> - 退休基金  <br /><code>Loan Facility</code> - 贷款资金</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>否</td>\n<td>string</td>\n<td>全球速汇订单备注</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>转账目的表</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>枚举值</th>\n<th>中文描述</th>\n<th>英文描述</th>\n<th>转账方式</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>01</td>\n<td>合同服务</td>\n<td>Contracted Services</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>02</td>\n<td>计算机与互联网服务</td>\n<td>Computer &amp; Internet Services</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>03</td>\n<td>转入自有帐户</td>\n<td>Transfer to own account</td>\n<td><code>SWIFT</code> / <code>LOCAL</code> / <code>WALLET</code></td>\n</tr>\n<tr>\n<td>04</td>\n<td>工资</td>\n<td>Salary</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>05</td>\n<td>一般货物贸易</td>\n<td>General Goods Trades</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>06</td>\n<td>货物运输费用</td>\n<td>Transportation fees for goods</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>07</td>\n<td>货物交付费用</td>\n<td>Delivery fees for goods</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>08</td>\n<td>出口货款支付</td>\n<td>For payment of exported goods</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>09</td>\n<td>购买住宅</td>\n<td>Purchase of Residential Property</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>10</td>\n<td>海外租赁</td>\n<td>Leasing abroad</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>11</td>\n<td>教育支出</td>\n<td>Educational Support</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>12</td>\n<td>共同基金投资</td>\n<td>Mutual fund investment</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>13</td>\n<td>代表处费用</td>\n<td>Representative office expenses</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>14</td>\n<td>广告与公共关系相关费用</td>\n<td>Advertising &amp; Public relations-related expenses</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>15</td>\n<td>信息服务费</td>\n<td>Information Service Charges</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>16</td>\n<td>特许权使用费、商标费、专利费和版权费</td>\n<td>Royalty, trademark, patent and copyright fees</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>17</td>\n<td>顾问费、技术协助及学术知识费用，包括专家的酬金</td>\n<td>Fees for advisors, technical assistance, and academic knowledge, including remuneration for specialists</td>\n<td><code>SWIFT</code> / <code>LOCAL</code> / <code>WALLET</code></td>\n</tr>\n<tr>\n<td>18</td>\n<td>其他专业咨询</td>\n<td>Other Professional Consulting</td>\n<td><code>SWIFT</code> / <code>LOCAL</code> / <code>WALLET</code></td>\n</tr>\n<tr>\n<td>19</td>\n<td>纳税</td>\n<td>Tax payment</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>20</td>\n<td>慈善捐款</td>\n<td>Charitable Contributions</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>21</td>\n<td>货款偿还</td>\n<td>Repayment of Loans</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>22</td>\n<td>保险费</td>\n<td>Insurance premium</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>23</td>\n<td>公用事业账单支付</td>\n<td>Utility Bill Payments</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>24</td>\n<td>医疗费用</td>\n<td>Medical Treatment</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>25</td>\n<td>建筑成本/费用</td>\n<td>Construction costs/expenses</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>26</td>\n<td>电信服务</td>\n<td>Telecommunications services</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>27</td>\n<td>旅行</td>\n<td>Travel</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n<tr>\n<td>28</td>\n<td>家庭支出</td>\n<td>Family Support</td>\n<td><code>SWIFT</code> / <code>LOCAL</code></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>受益人信息</td>\n</tr>\n<tr>\n<td>source_currency</td>\n<td>string</td>\n<td>支付货币(2位编码)</td>\n</tr>\n<tr>\n<td>source_amount</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>transfer_currency</td>\n<td>string</td>\n<td>收款货币</td>\n</tr>\n<tr>\n<td>transfer_amount</td>\n<td>string</td>\n<td>收款金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费货币</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费</td>\n</tr>\n<tr>\n<td>payer_fee</td>\n<td>string</td>\n<td>付款方承担手续费</td>\n</tr>\n<tr>\n<td>beneficiary_fee</td>\n<td>string</td>\n<td>受益人承担手续费</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>汇率</td>\n</tr>\n<tr>\n<td>transfer_purpose</td>\n<td>string</td>\n<td>提现目的</td>\n</tr>\n<tr>\n<td>source_of_founds</td>\n<td>string</td>\n<td>资金来源</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>string</td>\n<td>备注</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>订单创建时间戳</td>\n</tr>\n<tr>\n<td>success_time</td>\n<td>int</td>\n<td>订单成功时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","order"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"2e1c269a-61f2-4968-b051-90e73f9662c3","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"420909a4-33fa-4c02-afea-e9a06291b7b6\",\n    \"source_currency\": \"USDT\",\n    \"source_amount\": \"100\",\n    \"beneficiary_id\": 6,\n    \"transfer_purpose\": \"07\",\n    \"source_of_founds\": \"Salary\",\n    \"remarks\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/order"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": \"420909a4-33fa-4c02-afea-e9a06291b7b6\",\n        \"bit2go_id\": \"02512150900480001\",\n        \"beneficiary\": {\n            \"id\": 6,\n            \"merchant_no\": \"test_MQ00001\",\n            \"name\": \"K Adioo\",\n            \"account_type\": \"individual\",\n            \"transfer_method\": {\n                \"country\": \"HK\",\n                \"currency\": \"USD\",\n                \"method\": \"SWIFT\"\n            },\n            \"beneficiary_fields\": [\n                {\n                    \"name\": \"account_no\",\n                    \"rule\": {\n                        \"type\": \"string\",\n                        \"regex\": \"\",\n                        \"required\": \"Y\",\n                        \"maxLength\": \"33\",\n                        \"enumContent\": []\n                    }\n                }\n            ],\n            \"created_at\": 1765789248,\n            \"beneficiary\": {\n                \"account_no\": \"test123\"\n            }\n        },\n        \"rate\": \"1\",\n        \"source_amount\": \"100.00000000000000000000\",\n        \"source_currency\": \"USDT\",\n        \"transfer_amount\": \"63.65000000000000000000\",\n        \"transfer_currency\": \"USD\",\n        \"transfer_method\": \"SWIFT\",\n        \"swift_charge_option\": \"SHA\",\n        \"fee\": \"25.45\",\n        \"fee_currency\": \"USD\",\n        \"exchange_rate\": \"0.90000000000000000000\",\n        \"transfer_purpose\": \"07\",\n        \"source_of_founds\": \"Salary\",\n        \"remarks\": \"\",\n        \"status\": \"process\",\n        \"created_at\": 1765789248\n    }\n}"}],"_postman_id":"1f1f5968-b7ee-4f75-b380-3005003b480f"},{"name":"List Transfer Orders","event":[{"listen":"prerequest","script":{"id":"d2091701-69e8-4b2f-bd27-254f61582f66","exec":["const timestamp = new Date().toISOString();","pm.environment.set('timestamp', timestamp);","","const body = pm.request.body.raw;","const apiKey = pm.collectionVariables.get('api_key');","const signString = body + timestamp + apiKey;","const sign = CryptoJS.MD5(signString).toString();","pm.environment.set('sign', sign);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"51507654-f829-4d96-bbe7-63cc1bc88c79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"ConnectMerchant","value":"","description":"<p>子商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递JSON数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"page\": 1,\n    \"page_size\": 20,\n    \"start_time\": \"2025-01-01T00:00:00Z\",\n    \"end_time\": \"2025-12-31T23:59:59Z\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/order/list","description":"<p>全球速汇款历史数据</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>订单创建的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>订单创建的截止时间</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>否</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>payout_id</td>\n<td>否</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>source_currency</td>\n<td>否</td>\n<td>string</td>\n<td>支付货币</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"返回字段：\">返回字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>受益人信息</td>\n</tr>\n<tr>\n<td>source_currency</td>\n<td>string</td>\n<td>支付货币(2位编码)</td>\n</tr>\n<tr>\n<td>source_amount</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>transfer_currency</td>\n<td>string</td>\n<td>收款货币</td>\n</tr>\n<tr>\n<td>transfer_amount</td>\n<td>string</td>\n<td>收款金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费货币</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>汇率; 涉及到换汇的时候的实际汇率</td>\n</tr>\n<tr>\n<td>transfer_method</td>\n<td>string</td>\n<td>支付方式</td>\n</tr>\n<tr>\n<td>swift_charge_option</td>\n<td>string</td>\n<td>SWIFT付款方式</td>\n</tr>\n<tr>\n<td>transfer_purpose</td>\n<td>string</td>\n<td>提现目的</td>\n</tr>\n<tr>\n<td>source_of_founds</td>\n<td>string</td>\n<td>资金来源</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>string</td>\n<td>备注</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>订单创建时间戳</td>\n</tr>\n<tr>\n<td>success_time</td>\n<td>int</td>\n<td>订单成功时间戳</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-transfer","order","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"e64756ae-a594-480b-adf0-1168ad54b447","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"ConnectMerchant","value":"","description":"子商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Content-Type","value":"application/json","description":"传递JSON数据","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"page\": 1,\n    \"page_size\": 20,\n    \"start_time\": \"2025-01-01T00:00:00Z\",\n    \"end_time\": \"2025-12-31T23:59:59Z\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-transfer/order/list"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"order_id\": \"6dbcc08e-5a2e-40cc-9284-96356c12f37b\",\n                \"bit2go_id\": \"02512150939340001\",\n                \"beneficiary\": {\n                    \"id\": 36,\n                    \"merchant_no\": \"test_MV00001\",\n                    \"name\": \"K Adioo\",\n                    \"account_type\": \"individual\",\n                    \"transfer_method\": {\n                        \"country\": \"HK\",\n                        \"currency\": \"USD\",\n                        \"method\": \"SWIFT\"\n                    },\n                    \"beneficiary_fields\": [\n                        {\n                            \"name\": \"account_no\",\n                            \"rule\": {\n                                \"type\": \"string\",\n                                \"regex\": \"\",\n                                \"required\": \"Y\",\n                                \"maxLength\": \"33\",\n                                \"enumContent\": []\n                            }\n                        }\n                    ],\n                    \"created_at\": 1765791574,\n                    \"beneficiary\": {\n                        \"account_no\": \"test123\"\n                    }\n                },\n                \"rate\": \"1\",\n                \"source_amount\": \"100.00000000000000000000\",\n                \"source_currency\": \"USDT\",\n                \"transfer_amount\": \"63.65000000000000000000\",\n                \"transfer_currency\": \"USD\",\n                \"transfer_method\": \"SWIFT\",\n                \"swift_charge_option\": \"SHA\",\n                \"fee\": \"25.45\",\n                \"fee_currency\": \"USD\",\n                \"exchange_rate\": \"0.90000000000000000000\",\n                \"transfer_purpose\": \"07\",\n                \"source_of_founds\": \"Salary\",\n                \"remarks\": \"\",\n                \"status\": \"process\",\n                \"created_at\": 1765791574\n            }\n        ]\n    }\n}"}],"_postman_id":"51507654-f829-4d96-bbe7-63cc1bc88c79"},{"name":"Transfer Webhook","id":"340c282f-3997-48e5-a887-0cd4eef6811a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"payout.paid","description":"<p>通知事件类型: payout.paid；payout.fail</p>\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>global_transfer.paid</td>\n<td>订单成功</td>\n</tr>\n<tr>\n<td>global_transfer.fail</td>\n<td>订单失败</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：opera\">请求字段：opera</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go订单号</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>受益人信息</td>\n</tr>\n<tr>\n<td>source_currency</td>\n<td>string</td>\n<td>支付货币(2位编码)</td>\n</tr>\n<tr>\n<td>source_amount</td>\n<td>string</td>\n<td>支付金额</td>\n</tr>\n<tr>\n<td>transfer_currency</td>\n<td>string</td>\n<td>收款货币</td>\n</tr>\n<tr>\n<td>transfer_amount</td>\n<td>string</td>\n<td>收款金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费货币</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>手续费</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>string</td>\n<td>汇率; 涉及到换汇的时候的实际汇率</td>\n</tr>\n<tr>\n<td>transfer_method</td>\n<td>string</td>\n<td>支付方式</td>\n</tr>\n<tr>\n<td>swift_charge_option</td>\n<td>string</td>\n<td>SWIFT付款方式</td>\n</tr>\n<tr>\n<td>transfer_purpose</td>\n<td>string</td>\n<td>提现目的</td>\n</tr>\n<tr>\n<td>source_of_founds</td>\n<td>string</td>\n<td>资金来源</td>\n</tr>\n<tr>\n<td>remarks</td>\n<td>string</td>\n<td>备注</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- process: 处理中  <br />- paid: 支付成功  <br />- fail: 支付失败</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>int</td>\n<td>订单创建时间戳</td>\n</tr>\n<tr>\n<td>success_time</td>\n<td>int</td>\n<td>订单成功时间戳</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型:  <br />- global_transfer.paid 全球速汇成功  <br />- global_transfer.fail 全球速汇失败</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"6bb1794e-ef49-4b05-8ec2-42683614173f","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"传递 JSON 数据","type":"text"},{"key":"Merchant","value":"","description":"商户ID","type":"text"},{"key":"Timestamp","value":"","description":"请求时间戳","type":"text"},{"key":"Token","value":"","description":"API Key 的令牌","type":"text"},{"key":"Sign","value":"","description":"数据签名","type":"text"},{"key":"Event","value":"payout.paid","description":"通知事件类型: payout.paid；payout.fail","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"6dbcc08e-5a2e-40cc-9284-96356c12f37b\",\n    \"bit2go_id\": \"02512150939340001\",\n    \"beneficiary\": {\n        \"id\": 36,\n        \"merchant_no\": \"test_MV00001\",\n        \"name\": \"K Adioo\",\n        \"account_type\": \"individual\",\n        \"transfer_method\": {\n            \"country\": \"HK\",\n            \"currency\": \"USD\",\n            \"method\": \"SWIFT\"\n        },\n        \"beneficiary_fields\": [\n            {\n                \"name\": \"account_no\",\n                \"rule\": {\n                    \"type\": \"string\",\n                    \"regex\": \"\",\n                    \"required\": \"Y\",\n                    \"maxLength\": \"33\",\n                    \"enumContent\": []\n                }\n            }\n        ],\n        \"created_at\": 1765791574,\n        \"beneficiary\": {\n            \"account_no\": \"test123\"\n        }\n    },\n    \"rate\": \"1\",\n    \"source_amount\": \"100.00000000000000000000\",\n    \"source_currency\": \"USDT\",\n    \"transfer_amount\": \"63.65000000000000000000\",\n    \"transfer_currency\": \"USD\",\n    \"transfer_method\": \"SWIFT\",\n    \"swift_charge_option\": \"SHA\",\n    \"fee\": \"25.45\",\n    \"fee_currency\": \"USD\",\n    \"exchange_rate\": \"0.90000000000000000000\",\n    \"transfer_purpose\": \"07\",\n    \"source_of_founds\": \"Salary\",\n    \"remarks\": \"\",\n    \"status\": \"process\",\n    \"created_at\": 1765791574,\n    \"operation_type\": \"global_transfer.paid\"\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"340c282f-3997-48e5-a887-0cd4eef6811a"}],"id":"7ff43038-92b6-4cc9-94a8-07cd695908d5","description":"<p>用于在Bit2Go发起全球速汇，包括查询实时报价、创建转账订单以及接收转账结果回调通知。<br />在发起速汇前，请确保您已创建受益人并完成审核。</p>\n<hr />\n<p><strong>获取报价</strong></p>\n<blockquote>\n<p>在创建全球速汇前，您可以先根据您想要转账的信息查询转账报价，包含手续费、汇率(如涉及到换汇的情况)、扣款金额和到账金额等。 </p>\n</blockquote>\n<p><strong>全球速汇</strong></p>\n<blockquote>\n<p>您可以向已经通过的受益人发起全球速汇。<br />发起全球速汇时。可以凭借已经确认过的报价单；或者直接输入金额发起。 </p>\n</blockquote>\n<p>可以先获取报价，然后由报价为收费标准发起全球速汇。<br />或者可以直接发起全球速汇，我们会在订单内附带具体的信息。</p>\n","_postman_id":"7ff43038-92b6-4cc9-94a8-07cd695908d5"}],"id":"e26891cc-87ac-40d6-b206-0bad03772bcf","description":"<p>以下流程描述商户代子商户执行 KYC、创建收款方、获取汇款报价以及创建速汇订单的完整生命周期。</p>\n<hr />\n<p><strong>1. 创建子商户</strong></p>\n<blockquote>\n<p>商户通过 <code>Connect API</code> 创建子商户。 </p>\n</blockquote>\n<p><strong>2. 进行 KYC</strong></p>\n<p>获取 KYC 链接</p>\n<blockquote>\n<p>商户可以代子商户获取子商户的 KYC 验证链接，子商户需通过该链接完成实名验证流程。 </p>\n</blockquote>\n<p>查询 KYC 状态</p>\n<blockquote>\n<p>商户可以等待 Webhook 通知，并且可代子商户查询子商户的 KYC 审核进度。 </p>\n</blockquote>\n<p><strong>3. 创建受益人</strong></p>\n<p>为确保收款信息合法有效，收款方创建流程包含以下步骤：</p>\n<blockquote>\n<p>查询Bit2Go支持的收款方案 -&gt; 查询受益人规则 -&gt; 提交受益人 -&gt; 等待审核 </p>\n</blockquote>\n<p><strong>4. 发起全球速汇订单</strong></p>\n<p>查询速汇报价</p>\n<blockquote>\n<p>商户请求实时汇款报价，并返回 <code>报价 ID (quote_id)</code>。<br />该 ID 可作为生成正式订单的费率凭证。 </p>\n</blockquote>\n<p>发起订单</p>\n<blockquote>\n<p>通过已经确认的报价单或者通过金额发起全球速汇 </p>\n</blockquote>\n<p>状态查询</p>\n<blockquote>\n<p>商户可查询速汇订单状态，直到订单完成或失败。 </p>\n</blockquote>\n<hr />\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>┌───────────────────────────┐\n│   【商户】创建子商户         │\n└───────────────┬───────────┘\n                v\n┌───────────────────────────┐\n│ 【代子商户】获取 KYC 链接    │\n└───────────────┬───────────┘\n                v\n┌───────────────────────────┐\n│ 【代子商户】查询 KYC 状态     │\n└───────────────┬───────────┘\n                v\n        ┌─────────────────────┐\n        │     KYC 状态？       │\n        └──────────┬──────────┘\n                   │\n   ┌───────────────┼────────────────────────────────┐\n   │               │                                │\n   v               v                                v\n(补件)       (最终拒绝)                          (通过)\n   │               │                                │\n   │               │                                │\n   │      ┌────────────────────────┐                │\n   │      │      流程终止           │                │\n   │      └────────────────────────┘                │\n   │                                                v\n   │                                   ┌───────────────────────────┐\n   └───────────→ 返回获取 KYC 链接 ←──── │ 【代子商户】查询支持的收款方式 │\n                                       └───────────┬──────────────┘\n                                                   v\n                             ┌────────────────────────────────────────┐\n                             │     【代子商户】查看Bit2Go支持的收款场景    │\n                             └───────────────┬────────────────────────┘\n                                             v                    \n                             ┌────────────────────────────────────────┐\n                             │       【代子商户】查询受益人规则           │\n                             └───────────────┬────────────────────────┘\n                                             v\n                             ┌────────────────────────────────────────┐\n                             │         【代子商户】提交受益人             │\n                             └───────────────┬────────────────────────┘\n                                             v\n                             ┌────────────────────────────────────────┐\n                             │        【代子商户】查询收款方审核状态       │\n                             └───────────────┬────────────────────────┘\n                                             v\n                                ┌──────────────────────────────┐\n                                │        收款方审核结果？         │\n                                └────────────┬─────────────────┘\n                                             │\n                 ┌───────────────────────────┼───────────────────────────┐\n                 │                           │                           │\n                 v                           v                           v\n        (审核拒绝：重新创建)                (审核通过)                   (其它状态)\n                 │                           │                           │\n                 │                           │                           │\n                 └──────────────→ 返回支持的收款方式                  （继续轮询）\n                                             │\n                                             v\n                             ┌────────────────────────────────────────┐\n                             │      【代子商户】查询订单报价 Quote        │\n                             └───────────────┬────────────────────────┘\n                                             v\n                             ┌────────────────────────────────────────┐\n                             │        【代子商户】创建速汇订单            │\n                             └───────────────┬────────────────────────┘\n                                             v\n                             ┌────────────────────────────────────────┐\n                             │        【代子商户】查询速汇订单状态         │\n                             └───────────────┬────────────────────────┘\n                                             v\n                                ┌───────────────────────────────┐\n                                │          订单状态？             │\n                                └────────────┬──────────────────┘\n                                             │\n                   ┌─────────────────────────┼─────────────────────────┐\n                   │                         │                         │\n                   v                         v                         v\n         (处理中：继续轮询)                 (订单完成)               (订单失败)\n                   │                         │                         │\n                   │                         │                         │\n                   └──────────────→ 轮询继续  │            ┌─────────────────────┐\n                                             │            │   记录原因、流程结束   │\n                                             v            └─────────────────────┘\n                                  ┌──────────────────────────────┐\n                                  │        🎉 流程结束            │\n                                  └──────────────────────────────┘\n\n</code></pre>","_postman_id":"e26891cc-87ac-40d6-b206-0bad03772bcf"},{"name":"Global Account","item":[{"name":"Get All Global Accounts","id":"f53efaca-7b5e-443c-b1c5-a77d1c4a25c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-account/list","description":"<p>全球收款账户列表</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>卡创建的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>卡创建的截止时间</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>否</td>\n<td>string</td>\n<td>账户币种</td>\n</tr>\n<tr>\n<td>account_id</td>\n<td>否</td>\n<td>string</td>\n<td>收款账户 ID，精确匹配</td>\n</tr>\n<tr>\n<td>account_no</td>\n<td>否</td>\n<td>string</td>\n<td>收款账户号</td>\n</tr>\n<tr>\n<td>status</td>\n<td>否</td>\n<td>string</td>\n<td>账户状态</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>创建时间，Unix 时间戳</td>\n</tr>\n<tr>\n<td>nickname</td>\n<td>string</td>\n<td>账户昵称</td>\n</tr>\n<tr>\n<td>account_no</td>\n<td>string</td>\n<td>收款账户号</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>账户名称</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>账户所属国家/地区代码</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>账户状态  <br />- active: 已激活  <br />- closed: 已关闭  <br />- fail: 开户失败  <br />- process: 开户中</td>\n</tr>\n<tr>\n<td>account_id</td>\n<td>string</td>\n<td>收款账户 ID</td>\n</tr>\n<tr>\n<td>bank_swift_code</td>\n<td>string</td>\n<td>银行 SWIFT Code</td>\n</tr>\n<tr>\n<td>bank_name</td>\n<td>string / null</td>\n<td>银行名称</td>\n</tr>\n<tr>\n<td>bank_country</td>\n<td>string</td>\n<td>银行国家代码</td>\n</tr>\n<tr>\n<td>bank_address</td>\n<td>string</td>\n<td>银行地址</td>\n</tr>\n<tr>\n<td>bank_sort_code</td>\n<td>string</td>\n<td>银行 Sort Code</td>\n</tr>\n<tr>\n<td>bank_ach_code</td>\n<td>string</td>\n<td>银行 ACH Code</td>\n</tr>\n<tr>\n<td>bank_fedwire_code</td>\n<td>string</td>\n<td>银行 Fedwire Code</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-account","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"92dbeae0-3184-4b97-beb7-1f04d54de8ed","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-account/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"created_at\": 1772781304,\n                \"nickname\": \"test11\",\n                \"account_no\": \"8950939081\",\n                \"account_name\": \"Government of Singapore Investment Corp\",\n                \"country\": \"NG\",\n                \"status\": \"active\",\n                \"account_id\": \"28\",\n                \"bank_swift_code\": \"\",\n                \"bank_name\": null,\n                \"bank_country\": \"NG\",\n                \"bank_address\": \"\",\n                \"bank_sort_code\": \"\",\n                \"bank_ach_code\": \"\",\n                \"bank_fedwire_code\": \"\"\n            }\n        ]\n    }\n}"}],"_postman_id":"f53efaca-7b5e-443c-b1c5-a77d1c4a25c3"},{"name":"Global Account Transactions","id":"f6294676-01c6-4b31-9807-3aaa101a0e29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-account/list","description":"<p>全球收款账户收款订单列表</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_id</td>\n<td>否</td>\n<td>string</td>\n<td>收款账户 ID</td>\n</tr>\n<tr>\n<td>order_number</td>\n<td>否</td>\n<td>string</td>\n<td>订单号</td>\n</tr>\n<tr>\n<td>status</td>\n<td>否</td>\n<td>string</td>\n<td>订单状态</td>\n</tr>\n<tr>\n<td>transaction_currency</td>\n<td>否</td>\n<td>string</td>\n<td>到账币种</td>\n</tr>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>integer</td>\n<td>查询开始时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>integer</td>\n<td>查询结束时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>integer</td>\n<td>页码，默认 1</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>integer</td>\n<td>每页数量，默认 20</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>transaction_amount</td>\n<td>decimal</td>\n<td>到账金额</td>\n</tr>\n<tr>\n<td>transaction_currency</td>\n<td>string</td>\n<td>到账币种</td>\n</tr>\n<tr>\n<td>gross_amount</td>\n<td>decimal</td>\n<td>入账金额</td>\n</tr>\n<tr>\n<td>settlement_currency</td>\n<td>string</td>\n<td>入账币种</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>decimal</td>\n<td>手续费</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>decimal</td>\n<td>汇率，用于将到账币种转换为入账币种。计算方式：<code>gross_amount = transaction_amount × exchange_rate</code></td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- success: 已入账  <br />- process: 待入账  <br />- fail: 已退回  <br />- reversal: 已召回</td>\n</tr>\n<tr>\n<td>transaction_date</td>\n<td>integer</td>\n<td>交易时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>account_id</td>\n<td>string</td>\n<td>收款账户 ID</td>\n</tr>\n<tr>\n<td>account_nickname</td>\n<td>string</td>\n<td>收款账户备注</td>\n</tr>\n<tr>\n<td>payer</td>\n<td>object</td>\n<td>付款方信息</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"payer-数据结构\"><em>payer 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>付款人名称</td>\n</tr>\n<tr>\n<td>account</td>\n<td>string</td>\n<td>付款账户</td>\n</tr>\n<tr>\n<td>bank</td>\n<td>string</td>\n<td>付款银行</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>付款国家</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-account","list"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"22e4b0ac-ef7b-488d-a237-9a36ed55a1d6","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-account/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"bit2go_id\": \"GC2603060717460001\",\n                \"transaction_amount\": \"100\",\n                \"transaction_currency\": \"USD\",\n                \"gross_amount\": \"100\",\n                \"settlement_currency\": \"USDT\",\n                \"fee\": \"5.5\",\n                \"fee_currency\": \"USDT\",\n                \"status\": \"success\",\n                \"transaction_date\": 1772781466,\n                \"account_id\": \"29\",\n                \"account_nickname\": null,\n                \"exchange_rate\": \"1\"\n            }\n        ]\n    }\n}"}],"_postman_id":"f6294676-01c6-4b31-9807-3aaa101a0e29"},{"name":"Create Global Account","id":"f4622716-4a47-44cf-92b9-9d3c7374f0b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"GBP\",\n    \"nickname\": \"SDl9H\",\n    \"order_id\": \"4ghRc\",\n    \"wallet_currency\": \"USDT\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-account","description":"<p>创建全球收款账户</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>是</td>\n<td>string</td>\n<td>收款账户币种</td>\n</tr>\n<tr>\n<td>nickname</td>\n<td>否</td>\n<td>string</td>\n<td>收款账户昵称</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>是</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>是</td>\n<td>string</td>\n<td>扣费钱包币种</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>account_id</td>\n<td>string</td>\n<td>收款账户 ID</td>\n</tr>\n<tr>\n<td>account_currency</td>\n<td>string</td>\n<td>收款账户币种</td>\n</tr>\n<tr>\n<td>account_nickname</td>\n<td>string / null</td>\n<td>收款账户昵称</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>订单状态  <br />- paid: 已完成  <br />- process: 处理中  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>decimal</td>\n<td>创建收款账户手续费</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>创建时间，Unix 时间戳</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>decimal</td>\n<td>钱包扣款金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>钱包扣款币种</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","global-account"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"6fa71472-4309-4bb3-b668-13281f021d07","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"GBP\",\n    \"nickname\": \"SDl9H\",\n    \"order_id\": \"4ghRc\",\n    \"wallet_currency\": \"USDT\"\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/global-account"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"order_id\": \"4ghRc\",\n        \"bit2go_id\": \"GC2603060745350001\",\n        \"account_id\": \"30\",\n        \"account_currency\": \"GBP\",\n        \"account_nickname\": null,\n        \"status\": \"process\",\n        \"fee\": \"10\",\n        \"fee_currency\": \"USDT\",\n        \"created_at\": 1772783135,\n        \"wallet_amount\": \"10\",\n        \"wallet_currency\": \"USDT\"\n    }\n}"}],"_postman_id":"f4622716-4a47-44cf-92b9-9d3c7374f0b7"},{"name":"Global Account Operation Webhook","id":"9a55aff7-813f-49ab-88db-8731cc35717a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"card.topup.success","description":"<p>通知事件类型</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": null,\n    \"bit2go_id\": \"GC2601230309170001\",\n    \"account_id\": \"31\",\n    \"account_currency\": \"EUR\",\n    \"account_nickname\": null,\n    \"status\": \"paid\",\n    \"fee\": \"10\",\n    \"fee_currency\": \"USDT\",\n    \"created_at\": 1769137757,\n    \"wallet_amount\": \"10\",\n    \"wallet_currency\": \"USDT\"\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>global_account.active.success</td>\n<td>创建全球账户成功</td>\n</tr>\n<tr>\n<td>global_account.active.fail</td>\n<td>创建全球账户失败</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string/null</td>\n<td>商户订单号，部分操作不是通过 API 申请的则可能为空</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>account_id</td>\n<td>string</td>\n<td>收款账户 ID</td>\n</tr>\n<tr>\n<td>account_currency</td>\n<td>string</td>\n<td>收款账户币种</td>\n</tr>\n<tr>\n<td>account_nickname</td>\n<td>string / null</td>\n<td>收款账户昵称</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>操作订单状态  <br />- process: 处理中  <br />- paid: 成功  <br />- fail: 失败</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>本次操作收取的手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>操作创建时间，Unix 时间戳格式</td>\n</tr>\n<tr>\n<td>wallet_amount</td>\n<td>string</td>\n<td>商户钱包实际支付的金额</td>\n</tr>\n<tr>\n<td>wallet_currency</td>\n<td>string</td>\n<td>商户钱包币种</td>\n</tr>\n<tr>\n<td>operation_type</td>\n<td>string</td>\n<td>操作类型：  <br />- global_account.active 开户</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"50874bef-b910-4348-8d4b-0058a3dca76b","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"签名算法，支持 MD5 或 RSA","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"数据签名","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"},{"key":"Event","value":"card.topup.success","description":"通知事件类型","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": null,\n    \"bit2go_id\": \"GC2601230309170001\",\n    \"account_id\": \"31\",\n    \"account_currency\": \"EUR\",\n    \"account_nickname\": null,\n    \"status\": \"paid\",\n    \"fee\": \"10\",\n    \"fee_currency\": \"USDT\",\n    \"created_at\": 1769137757,\n    \"wallet_amount\": \"10\",\n    \"wallet_currency\": \"USDT\"\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"9a55aff7-813f-49ab-88db-8731cc35717a"},{"name":"Global Account Transaction Webhook","id":"55cc7298-0924-4326-b5d1-26727ec616e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"card.topup.success","description":"<p>通知事件类型</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"bit2go_id\": \"GC2603100900480001\",\n    \"transaction_amount\": \"60\",\n    \"transaction_currency\": \"AED\",\n    \"gross_amount\": \"16.254814\",\n    \"settlement_currency\": \"USDT\",\n    \"fee\": \"50\",\n    \"fee_currency\": \"USDT\",\n    \"status\": \"reversal\",\n    \"transaction_date\": 1773133248,\n    \"account_id\": \"33\",\n    \"account_nickname\": null,\n    \"payer\": {\n        \"name\": \"Name\",\n        \"address\": \"\",\n        \"country\": \"GB\",\n        \"bank_name\": \"BANK Name\",\n        \"narration\": null,\n        \"account_no\": \"1122\",\n        \"swift_code\": \"\",\n        \"bank_address\": \"\",\n        \"bank_country\": \"GB\"\n    },\n    \"exchange_rate\": \"0.270913566\"\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>global_account.transaction</td>\n<td>全球收款交易</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>操作订单状态  <br />- process: 待入账  <br />- success: 已入账  <br />- fail: 已退回  <br />- reversal: 已召回</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>本次操作收取的手续费金额</td>\n</tr>\n<tr>\n<td>fee_currency</td>\n<td>string</td>\n<td>手续费币种</td>\n</tr>\n<tr>\n<td>transaction_date</td>\n<td>integer</td>\n<td>交易时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>transaction_amount</td>\n<td>decimal</td>\n<td>到账金额</td>\n</tr>\n<tr>\n<td>transaction_currency</td>\n<td>string</td>\n<td>到账币种</td>\n</tr>\n<tr>\n<td>gross_amount</td>\n<td>decimal</td>\n<td>入账金额</td>\n</tr>\n<tr>\n<td>settlement_currency</td>\n<td>string</td>\n<td>入账币种</td>\n</tr>\n<tr>\n<td>account_id</td>\n<td>string</td>\n<td>收款账户 ID</td>\n</tr>\n<tr>\n<td>account_nickname</td>\n<td>string / null</td>\n<td>收款账户备注</td>\n</tr>\n<tr>\n<td>exchange_rate</td>\n<td>string</td>\n<td>到账币种到入账币种的汇率</td>\n</tr>\n<tr>\n<td>payer</td>\n<td>object</td>\n<td>付款人信息</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"payer-数据结构\"><em>payer 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>名称</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>国家</td>\n</tr>\n<tr>\n<td>account_no</td>\n<td>string</td>\n<td>账号</td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>地址</td>\n</tr>\n<tr>\n<td>bank_country</td>\n<td>string</td>\n<td>银行国家</td>\n</tr>\n<tr>\n<td>bank_address</td>\n<td>string</td>\n<td>银行地址</td>\n</tr>\n<tr>\n<td>swift_code</td>\n<td>string</td>\n<td>swift代码</td>\n</tr>\n<tr>\n<td>bank_name</td>\n<td>string</td>\n<td>银行名</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>交易附言</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"0e358e1c-151a-4981-8456-2f7bd6947107","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"签名算法，支持 MD5 或 RSA","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"数据签名","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"},{"key":"Event","value":"card.topup.success","description":"通知事件类型","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"bit2go_id\": \"GC2603100900480001\",\n    \"transaction_amount\": \"60\",\n    \"transaction_currency\": \"AED\",\n    \"gross_amount\": \"16.254814\",\n    \"settlement_currency\": \"USDT\",\n    \"fee\": \"50\",\n    \"fee_currency\": \"USDT\",\n    \"status\": \"reversal\",\n    \"transaction_date\": 1773133248,\n    \"account_id\": \"33\",\n    \"account_nickname\": null,\n    \"payer\": {\n        \"name\": \"Name\",\n        \"address\": \"\",\n        \"country\": \"GB\",\n        \"bank_name\": \"BANK Name\",\n        \"narration\": null,\n        \"account_no\": \"1122\",\n        \"swift_code\": \"\",\n        \"bank_address\": \"\",\n        \"bank_country\": \"GB\"\n    },\n    \"exchange_rate\": \"0.270913566\"\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"55cc7298-0924-4326-b5d1-26727ec616e7"}],"id":"b9a7c2d1-3385-4646-ac5f-050120c7f172","description":"<p><strong>全球收款账户（Global Account）</strong> 是一种外币收款账户，其功能类似于本地银行账户。  </p>\n<p>通过全球收款账户，您可以获取对应国家的银行账户信息，从而接收来自全球的银行转账。</p>\n<p>您可以使用该账户从 <strong>Amazon、eBay、Shopify 等电商平台</strong>收款，也可以用于向您的平台账户充值资金。</p>\n","_postman_id":"b9a7c2d1-3385-4646-ac5f-050120c7f172"},{"name":"Request for Information (RFI)","item":[{"name":"List RFIs","id":"c9e99649-6158-4a4d-b2fa-bb0d7d5d8280","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/rfi","description":"<p>补充信息请求（RFI）列表</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>start_time</td>\n<td>否</td>\n<td>int</td>\n<td>创建时间的起始时间</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>否</td>\n<td>int</td>\n<td>创建时间的截止时间</td>\n</tr>\n<tr>\n<td>id</td>\n<td>否</td>\n<td>string</td>\n<td>RFI ID，精确匹配</td>\n</tr>\n<tr>\n<td>page</td>\n<td>否</td>\n<td>int</td>\n<td>分页页数，从 1 开始</td>\n</tr>\n<tr>\n<td>page_size</td>\n<td>否</td>\n<td>int</td>\n<td>分页数据，最大为 50</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>integer</td>\n<td>RFI ID</td>\n</tr>\n<tr>\n<td>rfi_type</td>\n<td>string</td>\n<td>RFI 类型  <br />- transaction: 交易相关  <br />- kyc:账户/身份相关</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td>触发原因  <br />- banking_partner_inquiry: 银行/上游机构要求补充信息  <br />- required_documents: 需要补充材料</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>RFI 状态  <br />- required: 待提交  <br />- answered: 审核中  <br />- finish: 已完成</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>创建时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>expired_at</td>\n<td>integer</td>\n<td>过期时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>submission_url</td>\n<td>string</td>\n<td>提交补充信息的网页链接</td>\n</tr>\n<tr>\n<td>related_obj</td>\n<td>object</td>\n<td>被 RFI 的对象信息</td>\n</tr>\n<tr>\n<td>questions</td>\n<td>array/null</td>\n<td>问卷信息，只有当 RFI 状态为 <strong>required</strong> 该字段才有值</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"related_obj-数据结构\"><em>related_obj 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>obj_type</td>\n<td>string</td>\n<td>是</td>\n<td>关联对象类型  <br />- global_account.transaction: 全球账户收款  <br />- global_transfer: 全球速汇  <br />- global_account.active: 创建全球收款账户</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>否</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>string / null</td>\n<td>否</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>decimal</td>\n<td>否</td>\n<td>交易金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>否</td>\n<td>币种</td>\n</tr>\n<tr>\n<td>payer</td>\n<td>object</td>\n<td>否</td>\n<td>付款方信息</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>否</td>\n<td>收款方信息</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"payer-数据结构\"><em>payer 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_no</td>\n<td>string</td>\n<td>否</td>\n<td>付款方账户号</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>否</td>\n<td>付款人名称</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"beneficiary-数据结构\"><em>beneficiary 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_no</td>\n<td>string</td>\n<td>否</td>\n<td>收款方账户号</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>否</td>\n<td>收款人名称</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"场景一：全球收款（global_accounttransaction）\">场景一：全球收款（global_account.transaction）</h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"obj_type\": \"global_account.transaction\",\n    \"bit2go_id\": \"GC2603220341550001\",\n    \"order_id\": null,\n    \"amount\": \"100\",\n    \"currency\": \"USD\",\n    \"payer\": {\n        \"account_no\": \"\",\n        \"account_name\": \"XXX\"\n    },\n    \"beneficiary\": {\n        \"account_no\": \"00092378\",\n        \"account_name\": \"YYY\"\n    }\n}\n\n</code></pre>\n<h5 id=\"场景二：全球速汇（global_transfer）\">场景二：全球速汇（global_transfer）</h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"obj_type\": \"global_transfer\",\n    \"bit2go_id\": \"GC2603220341550001\",\n    \"order_id\": null,\n    \"amount\": \"100\",\n    \"currency\": \"USD\",\n    \"payer\": {\n        \"account_no\": \"\",\n        \"account_name\": \"XXX\"\n    },\n    \"beneficiary\": {\n        \"account_no\": \"00092378\",\n        \"account_name\": \"YYY\"\n    }\n}\n\n</code></pre>\n<h5 id=\"场景二：创建全球收款账户（global_accountactive）\">场景二：创建全球收款账户（global_account.active）</h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"obj_type\": \"global_account.active\",\n    \"bit2go_id\": \"GC2603220341550001\",\n    \"order_id\": null,\n    \"currency\": \"USD\"\n}\n\n</code></pre>\n<h5 id=\"questions-数据结构\"><em>questions 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>RFI Question ID</td>\n</tr>\n<tr>\n<td>question</td>\n<td>object</td>\n<td>RFI Question</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"question-数据结构\"><em>question 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>是</td>\n<td>字段标识</td>\n</tr>\n<tr>\n<td>label</td>\n<td>object</td>\n<td>是</td>\n<td>字段名（多语言）</td>\n</tr>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>否</td>\n<td>字段配置信息</td>\n</tr>\n<tr>\n<td>children</td>\n<td>array / null</td>\n<td>否</td>\n<td>子字段</td>\n</tr>\n<tr>\n<td>required</td>\n<td>string</td>\n<td>是</td>\n<td>是否必填，<code>1</code> 表示必填</td>\n</tr>\n<tr>\n<td>fieldType</td>\n<td>string</td>\n<td>是</td>\n<td>字段类型</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"labelregextipsplaceholder-数据结构\"><em>label/regexTips/placeholder 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>en-US</td>\n<td>string</td>\n<td>否</td>\n<td>英文</td>\n</tr>\n<tr>\n<td>zh-CN</td>\n<td>string</td>\n<td>否</td>\n<td>简体中文</td>\n</tr>\n<tr>\n<td>zh-TW</td>\n<td>string</td>\n<td>否</td>\n<td>繁体中文</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"config-数据结构\"><em>config 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>regex</td>\n<td>string</td>\n<td>否</td>\n<td>输入校验正则</td>\n</tr>\n<tr>\n<td>regexTips</td>\n<td>object</td>\n<td>否</td>\n<td>正则校验失败提示（多语言）</td>\n</tr>\n<tr>\n<td>placeholder</td>\n<td>object</td>\n<td>否</td>\n<td>输入提示（多语言）</td>\n</tr>\n<tr>\n<td>min</td>\n<td>integer / string</td>\n<td>否</td>\n<td>最小日期，<code>DATE</code>/<code>DATE_RANGE</code> 场景返回时间戳</td>\n</tr>\n<tr>\n<td>max</td>\n<td>integer / string</td>\n<td>否</td>\n<td>最大日期，<code>DATE</code>/<code>DATE_RANGE</code> 场景返回时间戳</td>\n</tr>\n<tr>\n<td>maxCount</td>\n<td>integer / string</td>\n<td>否</td>\n<td>文件最大上传数量</td>\n</tr>\n<tr>\n<td>options</td>\n<td>array</td>\n<td>否</td>\n<td>枚举选项，适用于选择类字段</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>object</td>\n<td>否</td>\n<td>金额字段配置，适用于 <code>AMOUNT</code> 类型</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"options-数据结构\"><em>options 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>value</td>\n<td>string</td>\n<td>是</td>\n<td>选项值</td>\n</tr>\n<tr>\n<td>label</td>\n<td>object</td>\n<td>是</td>\n<td>标题（多语言）</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","rfi"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"4a8f77f8-a73c-4768-b898-beee67f8a4a0","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"start_time\": 1729693483,\n    \"end_time\": 1730693483\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/rfi"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"count\": 1,\n        \"next\": null,\n        \"previous\": null,\n        \"page_size\": 20,\n        \"page\": 1,\n        \"results\": [\n            {\n                \"expired_at\": 1774255625,\n                \"rfi_type\": \"transaction\",\n                \"reason\": \"banking_partner_inquiry\",\n                \"status\": \"required\",\n                \"created_at\": 1774255625,\n                \"id\": 90,\n                \"related_obj\": {\n                    \"bit2go_id\": \"GC2603230847050001\",\n                    \"order_id\": null,\n                    \"amount\": \"100\",\n                    \"currency\": \"USD\",\n                    \"payer\": {\n                        \"account_no\": \"FR29NWBK60161331926819\",\n                        \"account_name\": \"JI YOU X\"\n                    },\n                    \"beneficiary\": {\n                        \"account_no\": \"00092378\",\n                        \"account_name\": null\n                    }\n                },\n                \"submission_url\": \"https://submission_url\",\n                \"questions\": [\n                    {\n                        \"question\": {\n                            \"field\": \"LONG\",\n                            \"label\": {\n                                \"en-US\": \"LONG\",\n                                \"zh-CN\": \"LONG\",\n                                \"zh-TW\": \"LONG\"\n                            },\n                            \"config\": {\n                                \"regex\": \"\\\\d+\",\n                                \"regexTips\": {\n                                    \"en-US\": \"\",\n                                    \"zh-CN\": \"\",\n                                    \"zh-TW\": \"\"\n                                },\n                                \"placeholder\": {\n                                    \"en-US\": \"\",\n                                    \"zh-CN\": \"\",\n                                    \"zh-TW\": \"\"\n                                }\n                            },\n                            \"children\": null,\n                            \"required\": \"1\",\n                            \"fieldType\": \"LONG\"\n                        },\n                        \"id\": 89\n                    }\n                ]\n            }\n        ]\n    }\n}"}],"_postman_id":"c9e99649-6158-4a4d-b2fa-bb0d7d5d8280"},{"name":"Submit RFI","id":"26a42b1d-ae92-4186-9116-66bed4198ef8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"id\": 91,\n    \"questions\": [\n        {\n            \"id\": 90,\n            \"answer\": {\n                \"LONG\": \"8663\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/rfi/submit","description":"<p>补充信息接口</p>\n<h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>必选</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>是</td>\n<td>integer</td>\n<td>RFI ID</td>\n</tr>\n<tr>\n<td>questions</td>\n<td>是</td>\n<td>array</td>\n<td>RFI Question</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"questions-数据结构\"><em>questions 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>是</td>\n<td>RFI Question ID</td>\n</tr>\n<tr>\n<td>answer</td>\n<td>string</td>\n<td>是</td>\n<td>问卷回复</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"fieldtype-数据结构\"><em>fieldType 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>fieldType</strong></th>\n<th><strong>answer 格式</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>TEXT</td>\n<td>string</td>\n<td>单行文本</td>\n</tr>\n<tr>\n<td>MUL_TEXT</td>\n<td>string</td>\n<td>多行文本</td>\n</tr>\n<tr>\n<td>DECIMAL</td>\n<td>string</td>\n<td>数值字符串</td>\n</tr>\n<tr>\n<td>LONG</td>\n<td>string</td>\n<td>长整数字符串</td>\n</tr>\n<tr>\n<td>AMOUNT</td>\n<td>object</td>\n<td>金额对象</td>\n</tr>\n<tr>\n<td>DATE</td>\n<td>integer</td>\n<td>时间戳</td>\n</tr>\n<tr>\n<td>DATE_RANGE</td>\n<td>object</td>\n<td>时间区间</td>\n</tr>\n<tr>\n<td>SELECT</td>\n<td>string</td>\n<td>单选</td>\n</tr>\n<tr>\n<td>MULTI_SELECT</td>\n<td>array</td>\n<td>多选</td>\n</tr>\n<tr>\n<td>CHECKBOX</td>\n<td>array</td>\n<td>复选</td>\n</tr>\n<tr>\n<td>CASCADER</td>\n<td>array</td>\n<td>级联选择</td>\n</tr>\n<tr>\n<td>TREE_SELECT</td>\n<td>array</td>\n<td>树形选择</td>\n</tr>\n<tr>\n<td>FILE</td>\n<td>array</td>\n<td>文件列表</td>\n</tr>\n<tr>\n<td>IMAGE</td>\n<td>array</td>\n<td>图片列表</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"answer-格式说明\"><em>answer 格式说明</em></h5>\n<h5 id=\"text--mul_text--decimal--long\"><em>TEXT / MUL_TEXT / DECIMAL / LONG</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": \"value\"\n}\n\n</code></pre>\n<h5 id=\"amount\"><em>AMOUNT</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": {\n        \"amount\": \"100.00\",\n        \"currency\": \"USD\"\n    }\n}\n\n</code></pre>\n<h5 id=\"date\"><em>DATE</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": \"value\"\n}\n\n</code></pre>\n<h5 id=\"date_range\"><em>DATE_RANGE</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": {\n        \"dateS\": 1774150915,\n        \"dateE\": 1774237315\n    }\n}\n\n</code></pre>\n<h5 id=\"select\"><em>SELECT</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": \"option_value\"\n}\n\n</code></pre>\n<h5 id=\"multi_select--checkbox--cascader--tree_select\"><em>MULTI_SELECT / CHECKBOX / CASCADER / TREE_SELECT</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": [\"option_1\", \"option_2\"]\n}\n\n</code></pre>\n<h5 id=\"file--image\"><em>FILE / IMAGE</em></h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"field\": [\"file_key_1\", \"file_key_2\"]\n}\n\n</code></pre>\n<h4 id=\"请求成功的响应字段：\">请求成功的响应字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>integer</td>\n<td>RFI ID</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>RFI 状态, 一般为 <strong>answered</strong></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","gateway","rfi","submit"],"host":["openapi","bit2go","io"],"query":[],"variable":[]}},"response":[{"id":"e303ca4c-c7f2-49f2-9c15-3e713855e1f7","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"数据签名","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"传递 JSON 数据","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"id\": 90,\n    \"questions\": [\n        {\n            \"id\": 190,\n            \"answer\": {\n                \"LONG\": \"8663\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://openapi.bit2go.io/api/gateway/rfi/submit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:17:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-frame-options","value":"DENY"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"vary","value":"origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=sN8Q4FDAHUxmjReXH%2BQxbPFV889fvkBd3jWpbeErIAEEVGOL96lBzqTHyblAsX%2FWoDSedZq8rSQfHbb%2BcGA7QXNVynzkTEPQ3grizE3rHGGYzZWN8GIy44WyfcJEWZnW2Ck4\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d725945bfa23dfa-SIN"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": 200,\n    \"message\": \"\",\n    \"result\": {\n        \"id\": 90,\n        \"status\": \"answered\"\n    }\n}"}],"_postman_id":"26a42b1d-ae92-4186-9116-66bed4198ef8"},{"name":"RFI Webhook","id":"68a956bd-953f-4fae-8424-7082af70228c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"<p>传递 JSON 数据</p>\n","type":"text"},{"key":"Merchant","value":"","description":"<p>商户ID</p>\n","type":"text"},{"key":"Timestamp","value":"","description":"<p>请求时间戳</p>\n","type":"text"},{"key":"Token","value":"","description":"<p>API Key 的令牌</p>\n","type":"text"},{"key":"Sign","value":"","description":"<p>数据签名</p>\n","type":"text"},{"key":"Event","value":"card.topup.success","description":"<p>通知事件类型</p>\n","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"expired_at\": 1774255625,\n    \"rfi_type\": \"transaction\",\n    \"reason\": \"banking_partner_inquiry\",\n    \"status\": \"required\",\n    \"created_at\": 1774255625,\n    \"id\": 90,\n    \"related_obj\": {\n        \"bit2go_id\": \"GC2603230847050001\",\n        \"order_id\": null,\n        \"amount\": \"100\",\n        \"currency\": \"USD\",\n        \"payer\": {\n            \"account_no\": \"FR29NWBK60161331926819\",\n            \"account_name\": \"JI YOU X\",\n            \"narration\": \"narration\"\n        },\n        \"beneficiary\": {\n            \"account_no\": \"00092378\",\n            \"account_name\": null\n        }\n    },\n    \"submission_url\": \"https://submission_url\",\n    \"questions\": [\n        {\n            \"question\": {\n                \"field\": \"LONG\",\n                \"label\": {\n                    \"en-US\": \"LONG\",\n                    \"zh-CN\": \"LONG\",\n                    \"zh-TW\": \"LONG\"\n                },\n                \"config\": {\n                    \"regex\": \"\\\\d+\",\n                    \"regexTips\": {\n                        \"en-US\": \"\",\n                        \"zh-CN\": \"\",\n                        \"zh-TW\": \"\"\n                    },\n                    \"placeholder\": {\n                        \"en-US\": \"\",\n                        \"zh-CN\": \"\",\n                        \"zh-TW\": \"\"\n                    }\n                },\n                \"children\": null,\n                \"required\": \"1\",\n                \"fieldType\": \"LONG\"\n            },\n            \"id\": 89\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"Webhook URL","description":"<ol>\n<li><p>订单成功后，Bit2Go 将对在开发者菜单配置的 <strong>Webhook</strong> 发送订单成功通知</p>\n</li>\n<li><p>Bit2Go 在发送 <strong>Webhook</strong> 通知时，会在 <strong>HTTP Header</strong> 中包含一个名为 <strong>Event</strong> 的字段，用于标识当前通知的事件类型，便于商户快速识别并路由处理</p>\n</li>\n<li><p>Bit2Go 发送通知请求的 Content-Type 为 <strong>application/json</strong></p>\n</li>\n<li><p>商户接收到异步请求后，需要先验证签名，方可提取数据</p>\n</li>\n<li><p>商户端收到通知并处理完成后需要返回 <strong>HTTP Response Status Code 2XX（200、201、202、204）</strong>；若是其它的响应状态码，平台会判定本次通知失败</p>\n</li>\n<li><p>平台通知超时时间设置为 10 秒，从建立连接到商户应答时间若超过 10 秒，平台将会自动断开连接，判定本次通知失败</p>\n</li>\n<li><p>通知失败后，会在 10秒、20秒、40秒、80秒、160秒 等时间重试通知，最多通知 10 次</p>\n</li>\n</ol>\n<h4 id=\"通知事件-event：\">通知事件 Event：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>事件类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>rfi.status</td>\n<td>调单通知</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"请求字段：\">请求字段：</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>integer</td>\n<td>RFI ID</td>\n</tr>\n<tr>\n<td>rfi_type</td>\n<td>string</td>\n<td>RFI 类型  <br />- transaction: 交易相关  <br />- kyc:账户/身份相关</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td>触发原因  <br />- banking_partner_inquiry: 银行/上游机构要求补充信息  <br />- required_documents: 需要补充材料</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>RFI 状态  <br />- required: 待提交  <br />- answered: 审核中  <br />- finish: 已完成</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>integer</td>\n<td>创建时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>expired_at</td>\n<td>integer</td>\n<td>过期时间（Unix 时间戳）</td>\n</tr>\n<tr>\n<td>submission_url</td>\n<td>string</td>\n<td>提交补充信息的网页链接</td>\n</tr>\n<tr>\n<td>related_obj</td>\n<td>object</td>\n<td>被 RFI 的对象信息</td>\n</tr>\n<tr>\n<td>questions</td>\n<td>array/null</td>\n<td>问卷信息，只有当 RFI 状态为 <strong>required</strong> 该字段才有值</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"related_obj-数据结构\"><em>related_obj 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>obj_type</td>\n<td>string</td>\n<td>是</td>\n<td>关联对象类型  <br />- global_account.transaction: 全球账户收款  <br />- global_transfer: 全球速汇  <br />- global_account.active: 创建全球收款账户</td>\n</tr>\n<tr>\n<td>bit2go_id</td>\n<td>string</td>\n<td>否</td>\n<td>Bit2Go 订单号</td>\n</tr>\n<tr>\n<td>order_id</td>\n<td>string / null</td>\n<td>否</td>\n<td>商户订单号</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>decimal</td>\n<td>否</td>\n<td>交易金额</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>否</td>\n<td>币种</td>\n</tr>\n<tr>\n<td>payer</td>\n<td>object</td>\n<td>否</td>\n<td>付款方信息</td>\n</tr>\n<tr>\n<td>beneficiary</td>\n<td>object</td>\n<td>否</td>\n<td>收款方信息</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"payer-数据结构\"><em>payer 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_no</td>\n<td>string</td>\n<td>否</td>\n<td>付款方账户号</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>否</td>\n<td>付款人名称</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>否</td>\n<td>交易附言</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"beneficiary-数据结构\"><em>beneficiary 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_no</td>\n<td>string</td>\n<td>否</td>\n<td>收款方账户号</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>否</td>\n<td>收款人名称</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"场景一：全球收款（global_accounttransaction）\">场景一：全球收款（global_account.transaction）</h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"obj_type\": \"global_account.transaction\",\n    \"bit2go_id\": \"GC2603220341550001\",\n    \"order_id\": null,\n    \"amount\": \"100\",\n    \"currency\": \"USD\",\n    \"payer\": {\n        \"account_no\": \"\",\n        \"account_name\": \"XXX\"\n    },\n    \"beneficiary\": {\n        \"account_no\": \"00092378\",\n        \"account_name\": \"YYY\"\n    }\n}\n\n</code></pre>\n<h5 id=\"场景二：全球速汇（global_transfer）\">场景二：全球速汇（global_transfer）</h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"obj_type\": \"global_transfer\",\n    \"bit2go_id\": \"GC2603220341550001\",\n    \"order_id\": null,\n    \"amount\": \"100\",\n    \"currency\": \"USD\",\n    \"payer\": {\n        \"account_no\": \"\",\n        \"account_name\": \"XXX\"\n    },\n    \"beneficiary\": {\n        \"account_no\": \"00092378\",\n        \"account_name\": \"YYY\"\n    }\n}\n\n</code></pre>\n<h5 id=\"场景二：创建全球收款账户（global_accountactive）\">场景二：创建全球收款账户（global_account.active）</h5>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"obj_type\": \"global_account.active\",\n    \"bit2go_id\": \"GC2603220341550001\",\n    \"order_id\": null,\n    \"currency\": \"USD\"\n}\n\n</code></pre>\n<h5 id=\"questions-数据结构\"><em>questions 数据结构</em></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>数值类型</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>RFI Question ID</td>\n</tr>\n<tr>\n<td>question</td>\n<td>object</td>\n<td>RFI Question</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"question-数据结构\"><em>question 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>是</td>\n<td>字段标识</td>\n</tr>\n<tr>\n<td>label</td>\n<td>object</td>\n<td>是</td>\n<td>字段名（多语言）</td>\n</tr>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>否</td>\n<td>字段配置信息</td>\n</tr>\n<tr>\n<td>children</td>\n<td>array / null</td>\n<td>否</td>\n<td>子字段</td>\n</tr>\n<tr>\n<td>required</td>\n<td>string</td>\n<td>是</td>\n<td>是否必填，<code>1</code> 表示必填</td>\n</tr>\n<tr>\n<td>fieldType</td>\n<td>string</td>\n<td>是</td>\n<td>字段类型</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"labelregextipsplaceholder-数据结构\"><em>label/regexTips/placeholder 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>en-US</td>\n<td>string</td>\n<td>否</td>\n<td>英文</td>\n</tr>\n<tr>\n<td>zh-CN</td>\n<td>string</td>\n<td>否</td>\n<td>简体中文</td>\n</tr>\n<tr>\n<td>zh-TW</td>\n<td>string</td>\n<td>否</td>\n<td>繁体中文</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"config-数据结构\"><em>config 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>regex</td>\n<td>string</td>\n<td>否</td>\n<td>输入校验正则</td>\n</tr>\n<tr>\n<td>regexTips</td>\n<td>object</td>\n<td>否</td>\n<td>正则校验失败提示（多语言）</td>\n</tr>\n<tr>\n<td>placeholder</td>\n<td>object</td>\n<td>否</td>\n<td>输入提示（多语言）</td>\n</tr>\n<tr>\n<td>min</td>\n<td>integer / string</td>\n<td>否</td>\n<td>最小日期，<code>DATE</code>/<code>DATE_RANGE</code> 场景返回时间戳</td>\n</tr>\n<tr>\n<td>max</td>\n<td>integer / string</td>\n<td>否</td>\n<td>最大日期，<code>DATE</code>/<code>DATE_RANGE</code> 场景返回时间戳</td>\n</tr>\n<tr>\n<td>maxCount</td>\n<td>integer / string</td>\n<td>否</td>\n<td>文件最大上传数量</td>\n</tr>\n<tr>\n<td>options</td>\n<td>array</td>\n<td>否</td>\n<td>枚举选项，适用于选择类字段</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>object</td>\n<td>否</td>\n<td>金额字段配置，适用于 <code>AMOUNT</code> 类型</td>\n</tr>\n</tbody>\n</table>\n</div><h6 id=\"options-数据结构\"><em>options 数据结构</em></h6>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>字段</strong></th>\n<th><strong>类型</strong></th>\n<th><strong>必填</strong></th>\n<th><strong>描述</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>value</td>\n<td>string</td>\n<td>是</td>\n<td>选项值</td>\n</tr>\n<tr>\n<td>label</td>\n<td>object</td>\n<td>是</td>\n<td>标题（多语言）</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"host":["Webhook URL"],"query":[],"variable":[]}},"response":[{"id":"3cfc68fc-8614-41fd-b641-14c47f22bfd9","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"商户ID","type":"text"},{"key":"Merchant","value":"{{Merchant}}","description":"请求时间戳","type":"text"},{"key":"Timestamp","value":"{{Timstamp}}","description":"签名算法，支持 MD5 或 RSA","type":"text"},{"key":"Sign","value":"{{Sign}}","description":"数据签名","type":"text"},{"key":"Token","value":"{{Token}}","description":"API Key 的令牌","type":"text"},{"key":"Event","value":"card.topup.success","description":"通知事件类型","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"expired_at\": 1774255625,\n    \"rfi_type\": \"transaction\",\n    \"reason\": \"banking_partner_inquiry\",\n    \"status\": \"required\",\n    \"created_at\": 1774255625,\n    \"id\": 90,\n    \"related_obj\": {\n        \"bit2go_id\": \"GC2603230847050001\",\n        \"order_id\": null,\n        \"amount\": \"100\",\n        \"currency\": \"USD\",\n        \"payer\": {\n            \"account_no\": \"FR29NWBK60161331926819\",\n            \"account_name\": \"JI YOU X\",\n            \"narration\": \"narration\"\n        },\n        \"beneficiary\": {\n            \"account_no\": \"00092378\",\n            \"account_name\": null\n        }\n    },\n    \"submission_url\": \"https://submission_url\",\n    \"questions\": [\n        {\n            \"question\": {\n                \"field\": \"LONG\",\n                \"label\": {\n                    \"en-US\": \"LONG\",\n                    \"zh-CN\": \"LONG\",\n                    \"zh-TW\": \"LONG\"\n                },\n                \"config\": {\n                    \"regex\": \"\\\\d+\",\n                    \"regexTips\": {\n                        \"en-US\": \"\",\n                        \"zh-CN\": \"\",\n                        \"zh-TW\": \"\"\n                    },\n                    \"placeholder\": {\n                        \"en-US\": \"\",\n                        \"zh-CN\": \"\",\n                        \"zh-TW\": \"\"\n                    }\n                },\n                \"children\": null,\n                \"required\": \"1\",\n                \"fieldType\": \"LONG\"\n            },\n            \"id\": 89\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"Callbck URL"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"success"}],"_postman_id":"68a956bd-953f-4fae-8424-7082af70228c"}],"id":"61998fa7-0490-4cf7-ae0e-6356acf6a78c","description":"<p>为满足合规与风控要求，系统在审核账户或交易时，可能会发起<strong>补充信息请求（RFI）</strong>。</p>\n<p>RFI 用于向商户收集额外信息或材料，以核实资金来源、交易背景或账户信息。每个 RFI 可能包含一个或多个问题，并根据实际情况进行追加，以完成审核流程。</p>\n","_postman_id":"61998fa7-0490-4cf7-ae0e-6356acf6a78c"}],"event":[{"listen":"prerequest","script":{"id":"b78fc3a9-15a7-4209-b015-15e412b27b13","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2ecb3c79-992d-4d19-bf7b-e06bfafbe319","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://farming-simulator.pstmn.io"}]}