區塊靜態錢包

post

https://api.cryptomus.com/v1/wallet/block-address

複製

當您需要凍結客戶的靜態錢包時，所有後續付款將不會記入客戶的餘額。您只能退款一次。資金將退回到其原始地址。

要求

查詢參數

姓名	參數類型	預設值	定義
uuid	stringuuidrequired_without: order_id		靜態錢包的 uuid
order_id	stringmin:1max:32alpha_dashrequired_without: uuid		靜態錢包的訂單ID
is_force_refund	boolean	false	將所有收到的付款退還至付款人的地址

參數類型

stringuuidrequired_without: order_id

定義

靜態錢包的 uuid

參數類型

stringmin:1max:32alpha_dashrequired_without: uuid

定義

靜態錢包的訂單ID

參數類型

boolean

定義

將所有收到的付款退還至付款人的地址

您需要傳遞其中一個必需參數，如果同時傳遞兩個參數，則該帳戶將透過 order_id

請求範例


curl https://api.cryptomus.com/v1/wallet/block-address \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "order_id": "1"
}'

複製

回覆

響應參數

姓名	定義
uuid	靜態錢包的uuid
status	靜態錢包的狀態。可用選項：• blocked• active• in_active

: 定義
靜態錢包的uuid
: 定義
靜態錢包的狀態。可用選項：- blocked- active- in_active

回應範例


1{
2	"state": 0,
3	"result": {
4		"uuid": "fcc40793-39f9-4fa9-85b2-93148039a72b",
5		"status": "blocked"
6	}
7}

複製

可能的錯誤

驗證錯誤

程式碼 : 422

範例回覆：


1{
2	"state": 1
3}

複製


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}

複製

內部伺服器錯誤

程式碼 : 500

範例回覆：


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}

複製