---
title: Documentación
description: Documentación de la API de Coinetic para desarrolladores: inicio rápido, firma de solicitudes, facturas, página de pago, webhooks, reembolsos y sandbox.
url: https://coinetic.money/es/docs/
lang: es
---

# 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.

- [Inicio rápido](https://coinetic.money/es/docs/quickstart/) — Su primer pago de prueba en 15 minutos: factura, redirección y webhook.
- [Bibliotecas cliente](https://coinetic.money/es/docs/sdks/) — Node.js, PHP, Python y Go: un único archivo sin dependencias.
- [Webhooks](https://coinetic.money/es/docs/webhooks/) — Eventos, firma, reintentos y orden de entrega.
- [Lista de verificación para producción](https://coinetic.money/es/docs/go-live/) — Qué comprobar antes de recibir dinero real.

## Cómo funciona un pago

`flujo de 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

| Entorno | API | Panel |
| --- | --- | --- |
| Producción | `https://pay.coinetic.money` | [https://dash.coinetic.money/merchant](https://dash.coinetic.money/merchant) |
| Sandbox | `https://sandbox.coinetic.money` | [https://sandbox.coinetic.money/merchant](https://sandbox.coinetic.money/merchant) |

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

| Método | Ruta | Qué hace |
| --- | --- | --- |
| POST | `/v1/invoices` | [Crear una factura](https://coinetic.money/es/docs/invoices/) |
| GET | `/v1/invoices/{id}` | Factura, pagos y confirmaciones |
| GET | `/v1/invoices` | Lista de facturas con filtros y cursor |
| GET | `/v1/assets` | Activos disponibles e importes mínimos |
| GET | `/v1/rates` | Tipo de cambio de referencia (consenso de exchanges) |
| POST | `/v1/refunds` | [Solicitud de reembolso](https://coinetic.money/es/docs/refunds/) |