支付历史记录

post https://api.cryptomus.com/v1/payout/list 复制

要求

查询参数

姓名	参数类型	默认值	定义
date_from	stringformat: YYYY-MM-DD H:mm:ss	null	通过创建日期过滤，从
date_to	stringformat: YYYY-MM-DD H:mm:ss	null	通过创建日期过滤，

: 参数类型
stringformat: YYYY-MM-DD H:mm:ss
默认值
null
定义
通过创建日期过滤，从
: 参数类型
stringformat: YYYY-MM-DD H:mm:ss
默认值
null
定义
通过创建日期过滤，

请求示例


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json'

复制

从5月4日至5月16日的创建日期过滤支出。


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
	"date_from": "2023-05-04 00:00:00",
	"date_to": "2023-05-16 23:59:59"
}'

复制

响应参数

姓名	参数类型	定义
merchant_uuid	string	商人的uuid
items		付款阵列。结构
paginate		分页的数据。结构

: 参数类型
string
定义
商人的uuid
: 定义
付款阵列。结构
: 定义
分页的数据。结构

结构物品

姓名	参数类型	定义
uuid	string	支付的UUID
amount	string	支付金额currency
currency	string	支付的货币代码
network	string\|null	支出的区块链网络的代码
payer_currency	string\|null	加密货币代码实际上是在其中支付。支付地址将获得支出货币。
payer_amount	string\|null	支付的付费数付费中的金额。
address	string	付款的钱包的地址
txid	string\|null	区块链中的事务ID
status	string	支付状态状态
payment_status	string	支付状态
is_final	boolean	支出是否最终确定支付过程一旦成功付款或失败，就可以将其视为最终确定。如果发生支付失败，则资金将退还给您的余额，要求您再次启动支出流程。
balance	string\|null	商人钱包上的其余资金。
order_id	string\|null	在您的系统中订购ID
commission	string\|null	加密委员会金额
merchant_amount	string\|null	从商人的余额中扣除的金额，包括所有佣金。
created_at	string\|null	创建支出日期。时区是UTC+3
updated_at	string\|null	最后支付更新日期。时区是UTC+3
convert		有关将自动转换付款的货币的信息。转换是从 payer_currency 到USDT执行的如果传递了 from_currency 参数，则存在。
convert.to_currency	string\|null	将转换付款的货币代码
convert.from_currency	string	从货币
convert.commission	string	转换费
convert.rate	string\|null	兑换率
convert.from_amount	string\|null	金额从

: 参数类型
string
定义
支付的UUID
: 参数类型
string
定义
支付金额currency
: 参数类型
string
定义
支付的货币代码
: 参数类型
string|null
定义
支出的区块链网络的代码
: 参数类型
string|null
定义
加密货币代码实际上是在其中支付。支付地址将获得支出货币。
: 参数类型
string|null
定义
支付的付费数付费中的金额。
: 参数类型
string
定义
付款的钱包的地址
: 参数类型
string|null
定义
区块链中的事务ID
: 参数类型
string
定义
支付状态状态
: 参数类型
string
定义
支付状态
: 参数类型
boolean
定义
支出是否最终确定支付过程一旦成功付款或失败，就可以将其视为最终确定。如果发生支付失败，则资金将退还给您的余额，要求您再次启动支出流程。
: 参数类型
string|null
定义
商人钱包上的其余资金。
: 参数类型
string|null
定义
在您的系统中订购ID
: 参数类型
string|null
定义
加密委员会金额
: 参数类型
string|null
定义
从商人的余额中扣除的金额，包括所有佣金。
: 参数类型
string|null
定义
创建支出日期。时区是UTC+3
: 参数类型
string|null
定义
最后支付更新日期。时区是UTC+3
: 定义
有关将自动转换付款的货币的信息。转换是从 payer_currency 到USDT执行的如果传递了 from_currency 参数，则存在。
: 参数类型
string|null
定义
将转换付款的货币代码
: 参数类型
string
定义
从货币
: 参数类型
string
定义
转换费
: 参数类型
string|null
定义
兑换率
: 参数类型
string|null
定义
金额从

要获取下一个/上一页条目，请在查询参数中指定下一个/上一个光标哈希 (?cursor=nextCursorHash)

例子：


1curl https://api.cryptomus.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6

复制

响应示例


1{
2"state": 0,
3"result": {
4	"merchant_uuid": "8b03432e-385b-4670-8d06-064591096795",
5	"items": [{
6		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
7		"amount": "3",
8		"currency": "USDT",
9		"network": "TRON",
10		"payer_currency": "USDT",
11		"payer_amount": "3",
12		"address": "TJ...",
13		"txid": null,
14		"status": "process",
15		"payment_status": "process",
16		"is_final": false,
17		"balance": "129.00000000",
18		"order_id": "1",
19		"commission": null,
20		"merchant_amount": null,
21		"created_at": "2023-06-21T17:25:55+03:00",
22		"updated_at": "2023-06-21T17:34:38+03:00"
23	}, {
24		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
25		"amount": "5.40000000",
26		"currency": "DOGE",
27		"network": "doge",
28		"payer_currency": "DOGE",
29		"payer_amount": "5.40000000",
30		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
31		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
32		"status": "paid",
33		"payment_status": "paid",
34		"is_final": true,
35		"balance": "26.77966652",
36		"order_id": null,
37		"commission": "0.00000000",
38		"merchant_amount": "5.40000000",
39		"created_at": "2023-07-21T17:25:55+03:00",
40		"updated_at": "2023-07-21T17:34:38+03:00"
41	},
42	...
43	],
44	"paginate": {
45		"count": 15,
46		"hasPages": true,
47		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
48		"previousCursor": null,
49		"perPage": 15
50	}
51}
52}

复制

可能的错误

验证错误

代码 : 422

示例回复：

如果以错误的格式传递date_tro或date_to参数。


1{
2	"state": 1,
3	"errors": {
4	"date_from": ["validation.regex"]
5	}
6}

复制

支付历史记录

要求

查询参数

请求示例

回复

响应参数

结构 物品

例子：

响应示例

可能的错误

验证错误

结构物品