Reembolsar os pagamentos em endereço bloqueado

post
https://api.cryptomus.com/v1/wallet/blocked-address-refund
CÓPIA DE

Você pode fazer um reembolso apenas uma vez.

Solicitar

Parâmetros de consulta

NomeTipo de parâmetroDefinição
uuidstringuuidrequired_without: order_idUuid de uma carteira estática
order_idstringmin:1max:32alpha_dashrequired_without: uuidPedido ID de uma carteira estática
address*stringmin:10max:128alpha_dashReembolsar todos os fundos bloqueados para este endereço

Tipo de parâmetro

stringuuidrequired_without: order_id

Definição

Uuid de uma carteira estática

Tipo de parâmetro

stringmin:1max:32alpha_dashrequired_without: uuid

Definição

Pedido ID de uma carteira estática

Tipo de parâmetro

stringmin:10max:128alpha_dash

Definição

Reembolsar todos os fundos bloqueados para este endereço

* - parâmetro obrigatório

Para reembolsar os pagamentos, você precisa passar uuid ou order_id , se você passar os dois, a carteira estática será identificada por uuid

Exemplo de solicitação


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..."
}'
CÓPIA DE

Resposta

Parâmetros de resposta

NomeDefinição
commissionComissão de Reembolso
amountQuantidade de reembolso

Definição

Comissão de Reembolso

Definição

Quantidade de reembolso

Exemplo de resposta


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

Possíveis erros

Erros de validação

código : 422

Exemplo de respostas:

Se você não passar um uuid e order_id , você receberá esta mensagem. Isso significa que pelo menos um dos parâmetros é necessário.


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

Se a carteira estática não foi encontrada:


1{
2    "state": 1,
3    "message": "Not found"
4}
CÓPIA DE

Alde que a retirada seja permitida apenas uma vez da carteira estática bloqueada, se a retirada já foi feita, você receberá esta mensagem de erro:


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

Apesar de a retirada for permitida apenas uma vez da carteira estática bloqueada, se você bloqueou uma carteira estática com um parâmetro is_force_refund = true , a retirada já foi feita e você receberá esta mensagem de erro:


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

Se o reembolso já estiver em processo:


1{
2    "state": 1,
3    "message": "Refund is in process"
4}
CÓPIA DE

Se o pagamento estiver bloqueado em seu comerciante ou usuário, você receberá esta mensagem de erro. Isso acontece, por exemplo, quando você altera sua senha e os pagamentos estão bloqueados por 24 horas.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
CÓPIA DE

Se nenhum pagamento foi feito à carteira estática:


1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}
CÓPIA DE

Se o valor do pagamento for menor que o valor mínimo suportado para a criptomoeda, você receberá esta mensagem de erro:


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

Se ocorrer um trabalho técnico ou o pagamento estiver temporariamente indisponível, você receberá as mensagens de erro:


1{
2    "state": 1,
3    "message": "Server error"
4}
CÓPIA DE


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

Erro do Servidor Interno

código : 500

Exemplo de respostas:


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