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
Sección titulada «Consulta las redes disponibles»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.
Pago mínimo
Sección titulada «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
Sección titulada «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.
Comisiones estándar
Sección titulada «Comisiones estándar»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.
Consulta comisiones y umbrales de pago
Sección titulada «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". 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.