Dar de baja una wallet de origen

POST/prefondeos/wallets-origen/{id}/bajaProbar

URL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Parámetros de ruta

idstringobligatorio

Cabeceras

Idempotency-KeyGenerarÚnico por operación. El alcance es tu cuenta **y el modo** de la key: una `sk_test_` y una `sk_live_` no comparten keys. Dura 24 h. Reintentar con la misma key y payload devuelve la respuesta original, con el mismo código HTTP y la cabecera `Idempotent-Replayed: true`; con otro payload da `409 idempotency_key_reused`. Los campos secretos (el `url` de una gift card, una `apiKey` nueva, un `webhookSecret`) sólo llegan en la primera respuesta: al repetir llegan en `null`.

Cuerpo de la petición (JSON){}

Enviar peticiónCopiar como curl

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

POST

/prefondeos/wallets-origen/{id}/baja

curl --request POST \
  --url http://localhost:3000/v1/prefondeos/wallets-origen/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/baja \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{ "motivo": "example" }'

• Pruebas (sandbox)
• Producción

Scope prefondeos:write. Exige Idempotency-Key. Al momento: el USDT que llegue desde ella deja de acreditarse, también el de un ticket ya recibido que todavía no se cargó. Para volver a usarla, regístrala otra vez (pasa de nuevo por la aprobación). Una wallet de otra cuenta responde 404.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

string format: uuid

Header Parameters

Idempotency-Key

string

Único por operación. El alcance es tu cuenta y el modo de la key: una sk_test_ y una sk_live_ no comparten keys. Dura 24 h. Reintentar con la misma key y payload devuelve la respuesta original, con el mismo código HTTP y la cabecera Idempotent-Replayed: true; con otro payload da 409 idempotency_key_reused. Los campos secretos (el url de una gift card, una apiKey nueva, un webhookSecret) sólo llegan en la primera respuesta: al repetir llegan en null.

Request Body

Media typeapplication/json

object

motivo

string

<= 300 characters

Example^generated

{
  "motivo": "example"
}

Responses

200

Wallet en baja

Media typeapplication/json

Una wallet desde la que mandas USDT al prefondeo.

object

id

string format: uuid

red

string

direccion

Tal cual en TRON; en minúsculas en EVM

string

etiqueta

string

nullable

estado

pendiente hasta que la aprueba nuestro equipo; activa (sólo se acredita lo que llega desde una activa); rechazada; baja.

string

Allowed values: pendiente activa rechazada baja

simulada

Activada en la cuenta de pruebas, sin el equipo

boolean

motivo

string

nullable

aprobadaEn

string format: date-time

nullable

creadoEn

string format: date-time

actualizadoEn

string format: date-time

Example

{
  "red": "TRC20",
  "estado": "pendiente"
}

404

wallet_origen_not_found

Media typeapplication/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}