Conceptos

Invoise le da a tu cliente una dirección de pago y envía los fondos recibidos a tu billetera, menos la comisión del servicio.

Concepto	Significado
Cuenta	Un usuario que inicia sesión en la plataforma y recibe acceso a comercios y tiendas.
Comercio	Un negocio en Invoise con sus propias tiendas, equipo y condiciones.
Tienda	Donde se crean facturas y depósitos. Tiene su propia configuración de destinatario, claves de API e historial de operaciones.
Factura	Una solicitud de pago único por un importe fijo. Se crea mediante /invoices.
Depósito	Una dirección reutilizable para recargas sin importe fijo. Se crea mediante /deposits.
Transferencia entrante	Fondos enviados por el pagador a una dirección de factura o depósito. Varias transferencias pueden pagar una factura.
Pago (payout)	Fondos recibidos transferidos al destinatario de la tienda, menos la comisión del servicio.

issuance es el nombre del recurso de la API compartido por facturas y depósitos. Guarda el id de la respuesta de creación como issuance_id para las solicitudes posteriores.

Vincula un pedido de tu propio sistema a una factura mediante external_id. La entidad de Invoise siempre es una factura.

Cómo funciona un pago

1. Crea una factura o un depósito.
2. Espera su address y luego dale al cliente el payment_url recibido.
3. El cliente envía el token elegido en la red elegida.
4. Invoise confirma la transferencia entrante. En cuanto hay fondos suficientes disponibles, envía el pago a tu destinatario.

Puedes comprobar el progreso con una solicitud GET o recibir webhooks. Consulta Estado de facturas y depósitos.

Una factura pasa a funded cuando han llegado fondos confirmados suficientes. La finalización del pago se confirma por separado mediante payout.confirmed.

Adónde van los pagos

Ajuste	Propósito
Dirección de destinatario	La billetera que recibe los pagos en EVM. Comprueba que admite las redes que elegiste.
Billetera de Invoise	En lugar de una dirección, una tienda puede pagar a la billetera de Invoise de un miembro de la cuenta.
Delegado	Una billetera opcional que controlas y que puede liquidar facturas EVM de forma independiente y pagar el gas. Una dirección de un exchange no sirve para esto.

Puedes cambiar el destinatario, el delegado y la elección entre una dirección y la billetera de Invoise más adelante con PATCH /shops/{shop_id}. Cada factura y depósito conserva el destinatario y el delegado con los que se creó, así que un cambio solo afecta a las facturas y direcciones creadas después.

Solana y Tron tienen sus propios destinatarios. Consulta Solana y Tron.

Comisiones y pagos pequeños

La comisión del servicio se descuenta del pago. Consulta las comisiones y límites actuales de tu tienda; no los calcules a partir de una lista de precios copiada.

En los depósitos, los pagos pequeños se acumulan hasta alcanzar el umbral de pago. En las facturas, los pagos parciales se acumulan hasta alcanzar el importe de la factura. Un pago en exceso de una factura va a Invoise junto con la comisión, no a tu destinatario.

Usa una tienda sandbox para probar la integración sin fondos reales.