Reembolsar os pagamentos em endereço bloqueado

post https://api.cryptomus.com/v1/wallet/blocked-address-refund Cópia

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

Resposta

Parâmetros de resposta

NomeTipo de parâmetroDefinição
commissionstringComissão de Reembolso
amountstringQuantidade de reembolso

Tipo de parâmetro

string

Definição

Comissão de Reembolso

Tipo de parâmetro

string

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

Possíveis erros

Erros de validação

código : 422

exemplos 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

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


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

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

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

Se o reembolso já estiver em processo:


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

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

Se nenhum pagamento foi feito à carteira estática:


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

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

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


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

Erro do Servidor Interno

código : 500

exemplos de respostas:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
Cópia