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

NombreDefinición
commissionComisión de reembolso
amountCantidad de reembolso

Definición

Comisión de reembolso

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

Respuestas de ejemplo:

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

Respuestas de ejemplo:


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