退款付款
post
https://api.cryptomus.com/v1/wallet/blocked-address-refund
您只能退款一次。
要求
查询参数
| 姓名 | 参数类型 | 定义 |
|---|---|---|
| uuid | stringuuidrequired_without: order_id | 静态钱包 |
| order_id | stringmin:1max:32alpha_dashrequired_without: uuid | 静态钱包的订购ID |
| address* | stringmin:10max:128alpha_dash | 退款全部将资金封锁到此地址 |
参数类型
stringuuidrequired_without: order_id定义
静态钱包参数类型
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}