Redes y tokens

Elige una red y un token a partir de la API antes de crear una factura o un depósito. El nombre del token por sí solo no basta: la solicitud necesita su dirección en esa red.

Consulta las redes disponibles

curl 'https://platform.invoise.me/api/v1/networks'

Usa estos campos de cada red:

Campo	Propósito
`chain_id`	ID de la red.
`family`	`solana` o `tron` para esas redes; ausente o `evm` para redes EVM.
`tokens[].address`	dirección del token: un contrato en EVM y Tron, un mint en Solana.
`tokens[].decimals`	número de decimales.
`tokens[].status`	disponibilidad, cuando está presente. Usa activos `ready` para pagos reales.
`minimum_payment`	el importe de factura más pequeño en esta red, en tokens enteros.

El catálogo público describe las redes configuradas. Un comercio puede tener un conjunto habilitado más pequeño; compruébalo con GET /api/v1/merchants/{merchant_id}/networks usando una sesión durante la configuración. La API rechaza la creación de facturas o depósitos en una red o activo no disponible.

Solana y Tron necesitan un destinatario configurado en la tienda antes de la primera factura. Consulta Solana y Tron.

Las redes y los tokens cambian mediante los ajustes de la plataforma. Consulta la disponibilidad, las direcciones y los decimales en la API al elegir un activo; no mantengas una lista fija.

Pago mínimo

minimum_payment es un número entero de tokens, por ejemplo "1". Una factura por debajo de ese valor devuelve 400 amount_below_minimum. Ambos listados de redes lo incluyen. El valor difiere entre redes y puede cambiar, así que consúltalo en vez de fijarlo en el código.

Da formato al importe

Los importes de pago son cadenas de números enteros en las unidades más pequeñas del token:

Decimales del token	10 tokens en la solicitud
6	`"10000000"`
18	`"10000000000000000000"`

No envíes "10.5". Con 6 decimales, 10.5 tokens es "10500000". Usa aritmética de enteros (BigInt en JavaScript) para los importes de la API; los números de punto flotante pueden perder precisión.

Una excepción: una factura que ofrece varios tokens o redes acepta un importe de token con decimales, como "10.5". Consulta varios tokens o redes.

Consulta comisiones y umbrales de pago

curl 'https://platform.invoise.me/api/v1/shops/{shop_id}/terms' \
  -H 'Authorization: Bearer ivk_...'

La respuesta lista las condiciones por red:

Campo	Propósito
`invoice` y `deposit`	ajustes de comisión: `bps`, `minimum`, `maximum`.
`sweep_threshold`	cuánto necesita un depósito antes de programar un pago.
`minimum_sweep` y `maximum_sweep`	el rango anunciado para ese ajuste.

bps significa centésimas de porcentaje: 50 bps = 0.5%. minimum y maximum de comisión usan unidades de dieciocho decimales, independientemente de los decimales del token; 10000000000000000 significa una comisión de 0.01 tokens. sweep_threshold es un importe de token legible, como "1".

La comisión máxima no es el importe máximo de pago. Mantén separadas las comisiones, los importes de las facturas y los umbrales de los depósitos.