退還已屏蔽地址的款項
post https://api.cryptomus.com/v1/wallet/blocked-address-refund 複製
您只能退款一次。
要求
查詢參數
| 姓名 | 參數類型 | 定義 |
|---|---|---|
| uuid | stringuuidrequired_without: order_id | 靜態錢包的 uuid |
| order_id | stringmin:1max:32alpha_dashrequired_without: uuid | 靜態錢包的訂單ID |
| address* | stringmin:10max:128alpha_dash | 將所有凍結資金退還至此地址 |
參數類型
stringuuidrequired_without: order_id定義
靜態錢包的 uuid參數類型
stringmin:1max:32alpha_dashrequired_without: uuid定義
靜態錢包的訂單ID參數類型
stringmin:10max:128alpha_dash定義
將所有凍結資金退還至此地址
* - 必需參數
要退款，您需要傳遞 uuid 或 order_id，如果同時傳遞這兩個，則靜態錢包將通過 uuid
請求範例
curl https://api.cryptomus.com/v1/wallet/blocked-address-refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"order_id": "1",
"address": "TK8..."
}'回覆
響應參數
| 姓名 | 定義 |
|---|---|
| commission | 退款佣金 |
| amount | 退款金額 |
定義
退款佣金定義
退款金額
回應範例
1{
2 "state": 0,
3 "result": {
4 "commission": "0.50",
5 "amount": "9.50"
6 }
7}可能的錯誤
驗證錯誤
程式碼 : 422
範例回覆：
如果您不傳遞 uuid 和 order_id，您將收到此訊息。這意味著至少需要一個參數。
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}如果沒有找到靜態錢包：
1{
2 "state": 1,
3 "message": "Not found"
4}只要從被封鎖的靜態錢包提款只允許一次，如果已經提款，您將收到此錯誤訊息：
1{
2 "state": 1,
3 "message": "You can withdraw only once"
4}只要從被封鎖的靜態錢包提款只允許一次，如果您使用參數is_force_refund=true阻止了靜態錢包，則提款已經完成，您將收到此錯誤訊息：
1{
2 "state": 1,
3 "message": "You can withdraw only once"
4}如果退款已在進行中：
1{
2 "state": 1,
3 "message": "Refund is in process"
4}如果您的商家或用戶的付款被凍結，您將收到此錯誤訊息。例如，當您更改密碼導致付款凍結 24 小時時，就會發生這種情況。
1{
2 "state": 1,
3 "message": "You are forbidden"
4}如果沒有向靜態錢包付款：
1{
2 "state": 1,
3 "message": "Nothing to withdraw"
4}如果支付金額低於加密貨幣支援的最低金額，您將收到此錯誤訊息：
1{
2 "state": 1,
3 "message": "The amount is too small"
4}如果出現技術問題或暫時無法付款，您將收到以下錯誤訊息：
1{
2 "state": 1,
3 "message": "Server error"
4}
1{
2 "state": 1,
3 "message": "The service was not found"
4}內部伺服器錯誤
程式碼 : 500
範例回覆：
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}