API & partners

Bouw betalingen
in uw software

Eén REST-integratie geeft uw gebruikers de drie betaalkanalen — online, op smartphone, op terminal. De sandbox is beschikbaar vanaf de inschrijving, en u ontvangt een terugkerende commissie op elke betaling van uw handelaars.

Verken de API Word partner

Meteen testsleutels, zonder voorafgaande commerciële validatie.

REST / cURLNode.jsPythonWebhooksSandbox

Endpoints

Eén REST-API, drie betaalkanalen

U maakt een betaling aan met hetzelfde object, of ze nu online, op een telefoon of op een terminal wordt geïnd. Ondertekende webhooks melden elke statuswijziging.

POST/checkout-sessionsEen betaling starten — link, QR of gehoste pagina

GET/checkout-sessions/{id}Status en volledige levensloop van een betaling

GET/transactionsUitlezen en afpunten, btw per lijn

POST/refundsGedeeltelijke of volledige terugbetaling

POST/subscriptionsTerugkerende facturatie op een bewaarde kaart

POST/subscription-plansDeelbare formules waarop uw klanten intekenen

GET/terminalsDe terminals van een verkooppunt oplijsten

POST/terminal-chargesEen betaling starten op een fysieke terminal

Basis-URL https://app.nextepay.com/api/v1 · Authorization: Bearer uw sleutel · Idempotency-Key bij elke schrijfactie

Volledige API-referentieQuickstart, elke parameter, fouten, testkaarten — in uw omgeving, sleutels inbegrepen ServerstatusLive beschikbaarheid van de API, de betaalpagina en de uitbetalingen

Webhooks

Ondertekend, betrouwbaar, idempotent

Elke gebeurtenis stuurt een HMAC-SHA256-ondertekende webhook. Uw backend valideert de handtekening vóór elke verwerking — automatische retry als u niet antwoordt.

HMAC-SHA256 over timestamp.body, verstuurd in X-Nextepay-Signature
X-Nextepay-Timestamp, X-Nextepay-Event en X-Nextepay-Delivery-Id gaan mee
De velden van het event staan onder data — uw eigen reference komt ongewijzigd terug
Automatische nieuwe poging met backoff als uw endpoint niet antwoordt
Test- en productiesleutels, intrekbaar vanuit uw omgeving

Webhook — transaction.succeededondertekend

{
  "event": "transaction.succeeded",
  "data": {
    "transaction_id": "…",
    "reference": "order-1234",
    "status": "succeeded",
    "amount_cents": 2500,
    "currency": "EUR"
  }
}

→ uw backend controleert de handtekening en bevestigt de bestelling

Aan de slag

Van de eerste request tot productie

pk_test_… / sk_test_…

Maak uw ontwikkelaarsaccount

U haalt uw testsleutels op en doet uw eerste call dezelfde dag nog.

simulate: success · declined · timeout

Integreer en test

U koppelt de webhooks en doorloopt uw flows in de sandbox. Ons technisch team beantwoordt uw integratievragen.

pk_live_… ✓ go-live

Ga naar productie

We valideren uw integratie samen met u, en dan innen uw handelaars.

Partnerprogramma

Elke betaling van uw handelaars
brengt u op

U ontvangt een terugkerende commissie op het volume dat de handelaars die u integreerde, innen. Ze is in realtime zichtbaar in uw partneromgeving en wordt elke maand automatisch uitbetaald.

Het programma is contractueel vastgelegd: het aandeel, de berekening en de uitbetaling staan in de partnerovereenkomst.
U volgt uw volume en uw commissies handelaar per handelaar.
Uw klanten houden een Nextepay-account op hun naam; u houdt de productrelatie.

Word partner

Partneromgeving3 actieve handelaars

Boetiek Martin      € 12.480  +€ 124,80
Café Central         € 8.920   +€ 89,20
Studio Peeters       € 3.640   +€ 36,40

— commissies deze maand —
Totaal              € 250,40

Automatische uitbetaling op de 1e van de maand

Gratis sandbox

Uw testsleutels in enkele minuten

U maakt uw account, haalt uw sandbox-sleutels op en doet uw eerste call dezelfde dag. Voor het partnerprogramma plannen we binnen de week een technisch en commercieel gesprek.

Verken de API Contacteer ons team