Ir al contenido

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.

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

Si solo necesitas precios, GET /api/v1/pricing devuelve las comisiones con las que empieza un comercio nuevo en cada red, el descuento por referido y los precios de la tarjeta, en dólares. No necesita credenciales, cualquier sitio web puede llamarlo y la respuesta se guarda en caché cinco minutos.

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 durante la configuración con GET /api/v1/merchants/{merchant_id}/networks usando una sesión o una clave de API de tienda con read (el ID del comercio de la clave está en GET /api/v1/me). 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.

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.

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.

Estas son las comisiones generales con las que empieza un comercio nuevo; pueden variar de un comercio a otro, así que consulta las tuyas en la API (abajo). La comisión es el 0.5% de cada factura o de cada pago de un depósito, nunca menos que la comisión mínima de la red ni más de $10. El mínimo cubre el gas de tu pago.

Red Comisión Comisión mínima Comisión máxima Pago mínimo
Ethereum 0.5% $1 $10 $10
Arbitrum 0.5% $0.05 $10 $1
Base 0.5% $0.03 $10 $1
Optimism 0.5% $0.03 $10 $1
Polygon 0.5% $0.05 $10 $1
BNB Chain 0.5% $0.05 $10 $1
Avalanche 0.5% $0.02 $10 $1
Solana 0.5% $1 $10 $2
Tron 0.5% $4.50 $10 $10

Por ejemplo, $100 en Base cuestan $0.50, $4 cuestan el mínimo de $0.03 y $5,000 cuestan $10 en lugar de $25.

Un comercio que se registró con un enlace de referido empieza con el 0.49%. Un comercio conserva las comisiones con las que se creó, e Invoise puede fijar comisiones individuales, así que consulta los términos de tu tienda en la API como se muestra abajo.

Ventana de terminal
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". Para cambiarlo, envía PATCH /api/v1/shops/{shop_id} con {"sweep_thresholds":{"<chain_id>":"25"}}, dentro del minimum_sweep y el maximum_sweep de esa red; un valor fuera de ese rango devuelve 400 invalid_sweep_threshold.

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.