商户
获取法币流水
以复式记账视图获取商户的所有法币余额变动，包括交易明细、手续费条目和回滚事件。
GET
/
v2
/
merchant
/
fiat
/
flows
获取法币流水
curl --request GET \
--url https://api-test.velafi.com/v2/merchant/fiat/flows \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/merchant/fiat/flows"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/merchant/fiat/flows', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/merchant/fiat/flows")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"currentPage": 123,
"size": 123,
"total": 123,
"record": [
{
"id": 123,
"merchantId": 123,
"settingsId": 123,
"txId": "<string>",
"category": "<string>",
"flowType": "<string>",
"fiat": "<string>",
"changed": 123,
"total": 123,
"extId": "<string>",
"createTime": "<string>"
}
]
}
}使用此端点获取商户账户法币余额变动的细粒度账本。与资金记录（显示汇总交易）不同，法币流水记录会展示各条复式记账明细——包括单独的手续费条目、回滚事件和转账变动。这是构建实时余额对账和会计导出的推荐端点。
所有请求都必须包含
X-BH-TOKEN 请求头，其中包含通过 GET /v2/token/generate 获取的业务令牌。端点
GET https://api.velafi.com/v2/merchant/fiat/flows
查询参数
integer
按商户 ID 筛选。
string
按法币代码筛选。
integer
按特定资金交易 ID 筛选。
string
按流水类型筛选。可接受的值：
ALL— 所有类型（默认）DEPOSIT— 入账存款WITHDRAW— 出账提现WITHDRAW_ROLLBACK— 提现撤销BUY_CRYPTO— 购买加密货币扣款BUY_CRYPTO_ROLLBACK— 购买加密货币撤销REFUND— 退款入账REFUND_ROLLBACK— 退款撤销TRANSFER_IN— 内部转账入账TRANSFER_OUT— 内部转账出账
integer
日期范围的开始时间，以毫秒为单位的 Unix 时间戳。
integer
日期范围的结束时间，以毫秒为单位的 Unix 时间戳。
integer
要获取的页码（从 1 开始）。默认为
1。integer
每页记录数。默认为
10，最大为 1000。响应字段
number
HTTP 风格的响应码。
200 表示成功。string
人类可读的状态消息，例如
SUCCESS。object
显示 data 字段
显示 data 字段
number
返回的当前页码。
number
本页的记录数。
number
符合查询条件的流水记录总数。
示例
cURL
curl -G https://api.velafi.com/v2/merchant/fiat/flows \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=3" \
--data-urlencode "fiat=MXN" \
--data-urlencode "flowType=DEPOSIT" \
--data-urlencode "pageSize=10"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"currentPage": 1,
"size": 10,
"total": 100,
"record": [
{
"id": 282,
"merchantId": 3,
"settingsId": 3,
"txId": "573901321954934784",
"category": "TRADE",
"flowType": "DEPOSIT",
"fiat": "MXN",
"changed": 105.61,
"total": 37042.07,
"extId": "573901321434841088",
"createTime": "1737452292000"
}
]
}
}
每笔交易通常会生成至少两条流水明细——一条用于本金的
TRADE 明细和一条用于手续费的 FEE 明细。在会计流程中可按 category 筛选以将二者区分开。⌘I
获取法币流水
curl --request GET \
--url https://api-test.velafi.com/v2/merchant/fiat/flows \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/merchant/fiat/flows"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/merchant/fiat/flows', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/merchant/fiat/flows")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"currentPage": 123,
"size": 123,
"total": 123,
"record": [
{
"id": 123,
"merchantId": 123,
"settingsId": 123,
"txId": "<string>",
"category": "<string>",
"flowType": "<string>",
"fiat": "<string>",
"changed": 123,
"total": 123,
"extId": "<string>",
"createTime": "<string>"
}
]
}
}