Direcciones de depósito

Una dirección de depósito recibe un token por una red. Se crea con POST /v1/deposit-addresses, con chain y currency, y la respuesta trae también warning. Las combinaciones disponibles están en Cobertura.

export FITAL_API="https://widget.fital.xyz/explorar/v1"
export FITAL_KEY="sk_test_sandbox_publica"
export FITAL_SIGNING_SECRET="secreto_de_firma_de_prueba_publico"

CUERPO='{"chain":"polygon","currency":"USDC"}'
CLAVE="direccion-tesoreria-01"
TS=$(date +%s)
HASH=$(printf '%s' "$CUERPO" | openssl dgst -sha256 -r | cut -d' ' -f1)
FIRMA=$(printf '%s\n%s\n%s\n%s\n%s' "$TS" POST /v1/deposit-addresses "$HASH" "$CLAVE" \
  | openssl dgst -sha256 -hmac "$FITAL_SIGNING_SECRET" -r | cut -d' ' -f1)
curl -sS -X POST "$FITAL_API/deposit-addresses" \
  -H "Authorization: Bearer $FITAL_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $CLAVE" \
  -H "X-Fital-Timestamp: $TS" \
  -H "X-Fital-Signature: v1=$FIRMA" \
  -d "$CUERPO"

La respuesta trae chain en minúsculas y currency en mayúsculas, sin importar cómo los pediste.

Antes de compartirlaCopiar enlace

• En solana, tron, tempo, linea y xdc un depósito rechazado no regresa automáticamente. Lo dice también el warning de esas direcciones. Tenlo en cuenta antes de usarlas para montos grandes.
• stellar no está disponible.
• Otro token enviado a una dirección puede no acreditarse. Respeta chain, currency y warning de la respuesta.

En qué se acreditaCopiar enlace

• EURC se queda en EURC. En GET /v1/balances suma a la fila EUR, y el depósito trae credited_currency: EURC.
• USDC, USDT y PYUSD se acreditan en dólares: suman a la fila USD. Lee credited_amount y credited_currency de cada depósito.

EstadosCopiar enlace

processing mientras se crea y active cuando ya recibe. Consulta con GET /v1/deposit-addresses/{id}.

Errores comunesCopiar enlace

• 422 pair_not_supported: esa red no recibe ese token.
• 422 deposit_address_rejected: la dirección se rechazó. Revisa chain y currency.
• Compartir la dirección con processing: address todavía es null.

Qué sigueCopiar enlace

Quién pagó.

Ver esta página en Markdown