Referencia de API

Direcciones de depósito

Cada usuario final recibe una dirección propia por red, derivada de forma determinista desde la semilla maestra custodiada por Tulkit. Son permanentes y atribuibles: cualquier depósito que llegue se acredita automáticamente a su dueño.

Redes disponibles

ETHEREUMPOLYGONBSCBASEARBITRUMOPTIMISMTRONSOLANAROBINHOODWORLDCHAINAVALANCHELINEA

La disponibilidad real depende de los tokens habilitados para tu comercio. Consulta /v1/merchants/me/tokens para saber qué activos puedes ofrecer en cada red.

POST/v1/deposit-addresses

Generar direcciones de depósito

Deriva direcciones HD públicas para un usuario final en las redes que indiques. Si la dirección ya existe para esa combinación usuario+red, se devuelve la misma en lugar de crear otra.

Cuándo usarlo

Antes de mostrar la pantalla de fondeo. Puedes pedir varias redes en un solo llamado y cachear el resultado en tu base de datos.

Cuerpo (JSON)

end_user_idstringrequerido

Id del End User dueño de las direcciones.

networksstring[]requerido

Lista de redes en mayúsculas. Solicita únicamente las que vas a mostrar para no confundir al usuario.

curl

curl -X POST "https://vaultcore.dev.tulkitpay.com/v1/deposit-addresses" \
  -H "x-api-key: $TULKIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "end_user_id": "eu_01HZX...",
    "networks": ["POLYGON", "BASE", "TRON"]
  }'

Respuesta de ejemplo

200 OK

[
  {
    "id": "addr_01HZX89A...",
    "merchant_id": "mrc_01HZX89...",
    "end_user_id": "eu_01HZX89...",
    "network": "POLYGON",
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "derivation_path": "m/44'/60'/0'/0/42",
    "status": "ACTIVE",
    "created_at": "2026-08-20T20:05:00.000Z"
  },
  {
    "id": "addr_01HZX89C...",
    "merchant_id": "mrc_01HZX89...",
    "end_user_id": "eu_01HZX89...",
    "network": "TRON",
    "address": "TLyqzVGLV1srkB7dToTAwdg29TFBDgAuto",
    "derivation_path": "m/44'/195'/0'/0/42",
    "status": "ACTIVE",
    "created_at": "2026-08-20T20:05:00.000Z"
  }
]

Buenas prácticas

Muestra siempre la red junto a la dirección y el QR: enviar por la red equivocada es la principal causa de fondos perdidos.
Las direcciones son reutilizables. No generes una nueva por cada depósito: complica la conciliación sin aportar seguridad.

GET/v1/deposit-addresses

Listar direcciones de depósito

Devuelve todas las direcciones generadas para tu comercio, con su usuario y red asociados.

Cuándo usarlo

Útil para auditorías, para reconstruir tu caché local o para verificar que un depósito llegó a una dirección tuya.

curl

curl "https://vaultcore.dev.tulkitpay.com/v1/deposit-addresses" \
  -H "x-api-key: $TULKIT_API_KEY"

Respuesta de ejemplo

200 OK

[
  {
    "id": "addr_01HZX89A...",
    "merchant_id": "mrc_01HZX89...",
    "end_user_id": "eu_01HZX89...",
    "network": "POLYGON",
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "derivation_path": "m/44'/60'/0'/0/42",
    "status": "ACTIVE",
    "created_at": "2026-08-20T20:05:00.000Z"
  }
]

Patrón recomendado

Genera las direcciones una sola vez al crear el usuario y guárdalas en tu base de datos. Así tu pantalla de depósito carga al instante y no dependes de una llamada externa en el camino crítico.

Depósitos

Detecta, confirma y concilia los fondos que reciben tus usuarios.

Cómo funciona

Por qué usamos direcciones HD y qué significa un barrido.