Pagos de reembolso en la dirección bloqueada

post https://api.cryptomus.com/v1/wallet/blocked-address-refund Copiar

Puede hacer un reembolso solo una vez.

Pedido

Parámetros de consulta

NombreTipo de parámetroDefinición
uuidstringuuidrequired_without: order_iduuid de una billetera estática
order_idstringmin:1max:32alpha_dashrequired_without: uuidID de pedido de una billetera estática
address*stringmin:10max:128alpha_dashReembolsar todos los fondos bloqueados a esta dirección

Tipo de parámetro

stringuuidrequired_without: order_id

Definición

uuid de una billetera estática

Tipo de parámetro

stringmin:1max:32alpha_dashrequired_without: uuid

Definición

ID de pedido de una billetera estática

Tipo de parámetro

stringmin:10max:128alpha_dash

Definición

Reembolsar todos los fondos bloqueados a esta dirección

* - parámetro obligatorio

Para reembolsar los pagos, debe pasar uuid o order_id , si pasa ambos, la billetera estática se identificará por uuid

Ejemplo de solicitud


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

Respuesta

Parámetros de respuesta

NombreTipo de parámetroDefinición
commissionstringComisión de reembolso
amountstringCantidad de reembolso

Tipo de parámetro

string

Definición

Comisión de reembolso

Tipo de parámetro

string

Definición

Cantidad de reembolso

Ejemplo de respuesta


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

Posibles errores

Errores de validación

código : 422

Ejemplos de respuestas:

Si no pasará un uuid y orden_id , recibirá este mensaje. Significa que se requiere al menos uno de los parámetros.


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

Si no se encontró la billetera estática:


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

Al mismo tiempo, el retiro solo se permite una vez de la billetera estática bloqueada, si el retiro ya se hizo, recibirá este mensaje de error:


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

Al mismo tiempo, el retiro solo se permite una vez de la billetera estática bloqueada, si bloqueó una billetera estática con un parámetro is_force_refund = true , el retiro ya se realizó y recibirá este mensaje de error:


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

Si el reembolso ya está en proceso:


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

Si el pago está bloqueado en su comerciante o usuario, recibirá este mensaje de error. Esto sucede, por ejemplo, cuando cambia su contraseña y los pagos están bloqueados durante 24 horas.


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

Si no se hicieron pagos a la billetera estática:


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

Si el monto del pago es menor que el monto mínimo compatible con la criptomoneda, recibirá este mensaje de error:


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

Si se produce un trabajo técnico o el pago no está disponible temporalmente, recibirá estos mensajes de error:


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


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

Error Interno del Servidor

código : 500

Ejemplos de respuestas:


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