Documentación de Coinetic

Todo lo necesario para aceptar criptomonedas en su web, app o bot. La integración consiste en dos llamadas a la API y un gestor de webhooks.

Cómo funciona un pago

 Su servidor                     Coinetic                           Cliente
 ───────────                     ────────                           ───────
 1. POST /v1/invoices  ────────▶ crea la factura, devuelve checkout_url
 2. redirección a checkout_url ───────────────────────────────────▶ página de pago
                                 3. el cliente elige la moneda ◀──── (USDT, USDC, BTC…)
                                    y paga a la dirección asignada
                                 4. la red confirma el pago
 5. webhook invoice.paid ◀────── POST a su URL (firma HMAC)
 6. GET /v1/invoices/{id} ─────▶ nueva comprobación del estado
 7. entrega del pedido
                                 8. «Volver a la tienda» ──────────▶ su return_url

Cuatro reglas

• El secreto de la clave de API, solo en su servidor. Nunca en el navegador, en la app móvil ni en git.
• El estado del pago, solo de Coinetic. No confíe en los parámetros de return_url ni se fíe del webhook sin más: verifique la firma y vuelva a consultar el estado con GET /v1/invoices/{id}.
• El dinero, como cadenas. Los importes llegan como cadenas decimales ("49.99") o como cadenas en unidades mínimas ("49990000"). No los convierta a float.
• Cada solicitud que modifica datos, con Idempotency-Key. Un reintento tras un tiempo de espera agotado devuelve la misma factura en lugar de crear otra.

URL base

Todas las respuestas son JSON en UTF-8 y las fechas, RFC 3339 en UTC. El contrato formal completo es OpenAPI 3 (openapi.yaml): solicítelo al soporte o descárguelo desde el panel.

Todos los endpoints del comercio