---
title: Documentatie
description: Coinetic-documentatie voor developers: snelstart, request-handtekeningen, facturen, betaalpagina, webhooks, terugbetalingen en sandbox.
url: https://coinetic.money/nl/docs/
lang: nl
---

# Coinetic-documentatie

Alles om crypto te accepteren op uw website, in uw app of in uw bot. De integratie bestaat uit twee API-requests en één webhook-handler.

- [Snelstart](https://coinetic.money/nl/docs/quickstart/) — Uw eerste testbetaling in 15 minuten: factuur, redirect, webhook.
- [Clients en voorbeelden](https://coinetic.money/nl/docs/sdks/) — Node.js, PHP, Python, Go — één bestand zonder dependencies.
- [Webhooks](https://coinetic.money/nl/docs/webhooks/) — Events, handtekening, retries en volgorde van aflevering.
- [Go-live-checklist](https://coinetic.money/nl/docs/go-live/) — Wat u controleert voordat u echt geld accepteert.

## Zo werkt een betaling

`betaalflow`

```
 Uw server                       Coinetic                           Klant
 ─────────                       ────────                           ─────
 1. POST /v1/invoices  ────────▶ maakt factuur aan, geeft checkout_url terug
 2. redirect naar checkout_url ───────────────────────────────────▶ betaalpagina
                                 3. klant kiest valuta ◀──────────── (USDT, USDC, BTC…)
                                    en betaalt naar het getoonde adres
                                 4. netwerk bevestigt de betaling
 5. webhook invoice.paid ◀────── POST naar uw URL (HMAC-handtekening)
 6. GET /v1/invoices/{id} ─────▶ status opnieuw controleren
 7. bestelling leveren
                                 8. ‘Terug naar de winkel’ ────────▶ uw return_url
```

## Vier regels

- **Het secret van de API-sleutel staat alleen op uw server.** Niet in de browser, niet in een mobiele app en niet in git.
- **De betaalstatus komt alleen van Coinetic.** Vertrouw geen parameters in `return_url` en neem een webhook niet zomaar voor waar aan: controleer de handtekening en controleer daarna de status opnieuw via `GET /v1/invoices/{id}`.
- **Geld is een string.** Bedragen komen binnen als decimale strings (`"49.99"`) of als strings in de kleinste eenheid (`"49990000"`). Zet ze nooit om naar float.
- **Elk wijzigend request krijgt een `Idempotency-Key`.** Een retry na een time-out geeft dezelfde factuur terug in plaats van een tweede aan te maken.

## Basis-URL's

| Omgeving | API | Dashboard |
| --- | --- | --- |
| Productie | `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) |

Alle responses zijn JSON in UTF-8, tijden in RFC 3339 en UTC. Het volledige formele contract is OpenAPI 3 (`openapi.yaml`); vraag het op bij support of in het dashboard.

## Alle merchant-endpoints

| Methode | Pad | Wat het doet |
| --- | --- | --- |
| POST | `/v1/invoices` | [Factuur aanmaken](https://coinetic.money/nl/docs/invoices/) |
| GET | `/v1/invoices/{id}` | Factuur, betalingen, bevestigingen |
| GET | `/v1/invoices` | Lijst met facturen, met filters en cursor |
| GET | `/v1/assets` | Beschikbare assets en minimumbedragen |
| GET | `/v1/rates` | Referentiekoers (consensus van exchanges) |
| POST | `/v1/refunds` | [Terugbetaling aanvragen](https://coinetic.money/nl/docs/refunds/) |