支払い履歴

post
https://api.cryptomus.com/v1/payout/list
コピー

リクエスト

クエリパラメーター

名前パラメータータイプデフォルト値意味
date_fromstringformat: YYYY-MM-DD H:mm:ssnullから作成された日付によるフィルタリング
date_tostringformat: YYYY-MM-DD H:mm:ssnull作成日までにフィルタリング

パラメータータイプ

stringformat: YYYY-MM-DD H:mm:ss

意味

から作成された日付によるフィルタリング

パラメータータイプ

stringformat: YYYY-MM-DD H:mm:ss

意味

作成日までにフィルタリング

リクエスト例


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商人のuuid
itemsペイアウトの配列。 構造
paginateページネーションのためのデータ。 構造

意味

商人のuuid

意味

ペイアウトの配列。 構造

意味

ページネーションのためのデータ。 構造

の構造 アイテム

名前意味
uuid支払いのuuid
amount通貨での支払いcurrency
currency支払いの通貨コード
network支払いが行われるブロックチェーンネットワークのコード
address支払いが行われるウォレットの住所
txidブロックチェーンのトランザクションID
status支払いステータス ステータス
is_final支払いが確定されているかどうか支払いプロセスは、正常に支払われた場合、または失敗した場合に完了したと見なされます。支払いの失敗が発生した場合、資金は残高に返還され、ペイアウトプロセスを再度開始する必要があります。
balance商人の財布の残りの資金。
created_at支払いの作成日。タイムゾーンはUTC+3です
updated_at最後のペイアウトの更新日。タイムゾーンはUTC+3です

意味

支払いのuuid

意味

通貨での支払いcurrency

意味

支払いの通貨コード

意味

支払いが行われるブロックチェーンネットワークのコード

意味

支払いが行われるウォレットの住所

意味

ブロックチェーンのトランザクションID

意味

支払いステータス ステータス

意味

支払いが確定されているかどうか支払いプロセスは、正常に支払われた場合、または失敗した場合に完了したと見なされます。支払いの失敗が発生した場合、資金は残高に返還され、ペイアウトプロセスを再度開始する必要があります。

意味

商人の財布の残りの資金。

意味

支払いの作成日。タイムゾーンはUTC+3です

意味

最後のペイアウトの更新日。タイムゾーンはUTC+3です
次/前のページのエントリを取得するには、クエリパラメーターで次/以前のカーソルハッシュを指定します (?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	"items": [{
5		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
6		"amount": "3",
7		"currency": "USDT",
8		"network": "TRON",
9		"address": "TJ...",
10		"txid": null,
11		"status": "process",
12		"is_final": false,
13		"balance": "129.00000000",
14		"created_at": "2023-06-21T17:25:55+03:00",
15		"updated_at": "2023-06-21T17:34:38+03:00"
16	}, {
17		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
18		"amount": "5.40000000",
19		"currency": "DOGE",
20		"network": "doge",
21		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
22		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
23		"order_id": null,
24		"payment_status": null,
25		"status": "paid",
26		"is_final": true,
27		"balance": "26.77966652",
28		"created_at": "2023-07-21T17:25:55+03:00",
29		"updated_at": "2023-07-21T17:34:38+03:00"
30	},
31	...
32	],
33	"paginate": {
34		"count": 15,
35		"hasPages": true,
36		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
37		"previousCursor": null,
38		"perPage": 15
39	}
40}
41}
コピー

可能なエラー

検証エラー

コード : 422

回答の例:

date_fromまたはdate_toパラメーターが間違った形式で渡された場合。


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