Chặn ví tĩnh
post
https://api.cryptomus.com/v1/wallet/block-address
Khi bạn cần khóa ví tĩnh của khách hàng, tất cả các khoản thanh toán tiếp theo sẽ không được ghi có vào số dư của họ. Bạn chỉ có thể hoàn lại số tiền này một lần. Số tiền sẽ được trả về địa chỉ mà chúng được gửi đến.
Lời yêu cầu
Tham số truy vấn
| Tên | Kiểu tham số | Giá trị mặc định | Sự định nghĩa |
|---|---|---|---|
| uuid | stringuuidrequired_without: order_id | uuid của ví tĩnh | |
| order_id | stringmin:1max:32alpha_dashrequired_without: uuid | ID đơn hàng của ví tĩnh | |
| is_force_refund | boolean | false | Hoàn trả tất cả các khoản thanh toán đến địa chỉ của người gửi |
Kiểu tham số
stringuuidrequired_without: order_idSự định nghĩa
uuid của ví tĩnhKiểu tham số
stringmin:1max:32alpha_dashrequired_without: uuidSự định nghĩa
ID đơn hàng của ví tĩnhKiểu tham số
booleanSự định nghĩa
Hoàn trả tất cả các khoản thanh toán đến địa chỉ của người gửi
Bạn cần phải vượt qua một trong các tham số bắt buộc, nếu bạn vượt qua cả hai, tài khoản sẽ được xác định bằng order_id
Ví dụ yêu cầu
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"
}'Phản ứng
Các thông số phản hồi
| Tên | Sự định nghĩa |
|---|---|
| uuid | uuid của ví tĩnh |
| status | Trạng thái của ví tĩnh.Các tùy chọn có sẵn:• blocked• active• in_active |
Sự định nghĩa
uuid của ví tĩnhSự định nghĩa
Trạng thái của ví tĩnh.Các tùy chọn có sẵn:- blocked- active- in_active
Ví dụ phản hồi
1{
2 "state": 0,
3 "result": {
4 "uuid": "fcc40793-39f9-4fa9-85b2-93148039a72b",
5 "status": "blocked"
6 }
7}Lỗi có thể xảy ra
Lỗi xác thực
mã số : 422
ví dụ phản hồi:
1{
2 "state": 1
3}
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}Lỗi máy chủ nội bộ
mã số : 500
ví dụ phản hồi:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}