Hoàn tiền thanh toán cho địa chỉ bị chặn

Lời yêu cầu

Tham số truy vấn

* - tham số bắt buộc

Ví dụ yêu cầu

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..."
}'

Phản ứng

Các thông số phản hồi

Ví dụ phản hồi

1{
2    "state": 0,
3    "result": {
4        "commission": "0.50",
5        "amount": "9.50"
6    }
7}

Lỗi có thể xảy ra

Lỗi xác thực

mã số : 422

ví dụ phản hồi:

Nếu bạn không truyền uuid và order_id, bạn sẽ nhận được thông báo này. Điều này có nghĩa là ít nhất một tham số là bắt buộc.

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

Nếu không tìm thấy ví tĩnh:

1{
2    "state": 1,
3    "message": "Not found"
4}

Miễn là việc rút tiền chỉ được phép một lần từ ví tĩnh bị chặn, nếu việc rút tiền đã được thực hiện, bạn sẽ nhận được thông báo lỗi này:

1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}

Miễn là việc rút tiền chỉ được phép một lần từ ví tĩnh bị chặn, nếu bạn chặn ví tĩnh bằng tham số is_force_refund=true, thì việc rút tiền đã được thực hiện và bạn sẽ nhận được thông báo lỗi này:

1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}

Nếu quá trình hoàn tiền đang diễn ra:

1{
2    "state": 1,
3    "message": "Refund is in process"
4}

Nếu khoản thanh toán bị chặn trên đơn vị chấp nhận thanh toán hoặc người dùng của bạn, bạn sẽ nhận được thông báo lỗi này. Ví dụ: điều này xảy ra khi bạn thay đổi mật khẩu và khoản thanh toán bị chặn trong 24 giờ.

1{
2    "state": 1,
3    "message": "You are forbidden"
4}

Nếu không có khoản thanh toán nào được thực hiện vào ví tĩnh:

1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}

Nếu số tiền thanh toán ít hơn số tiền tối thiểu được hỗ trợ cho tiền điện tử, bạn sẽ nhận được thông báo lỗi này:

1{
2    "state": 1,
3    "message": "The amount is too small"
4}

Nếu xảy ra sự cố kỹ thuật hoặc khoản thanh toán tạm thời không khả dụng, bạn sẽ nhận được thông báo lỗi sau:

1{
2    "state": 1,
3    "message": "Server error"
4}

1{
2    "state": 1,
3    "message": "The service was not found"
4}

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}