Terugkerende betalingen (MIT)

Terugkerende betalingen stellen u in staat om klanten volgens een schema te belasten zonder hun actieve deelname. Dit is een Merchant Initiated Transaction (MIT)-flow.

Hoe het werkt

De terugkerende flow heeft twee fasen:

Eerste betaling — De klant authenticeert en betaalt, waarbij toestemming wordt verleend voor toekomstige betalingen
Vervolgbetalingen — U belast de opgeslagen kaart van de klant zonder hun interactie

Fase 1: Eerste betaling

Maak een bestelling aan met recurring_type: "first" en een schedule_type:

POST /v1/orders/

{
  "merchant_order_id": "first-recurring",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "first",
      "schedule_type": "scheduled"
    }
  ]
}

Schematypen

Type	Beschrijving
`scheduled`	Vast schema (bijv. maandelijks abonnement)
`unscheduled`	Variabele timing (bijv. opwaarderen wanneer het saldo laag is)

Sla na een geslaagde betaling het vault_token en/of first_transaction_id uit de respons op.

Fase 2: Vervolgende terugkerende betaling

Belast de klant met het opgeslagen token:

POST /v1/orders/

{
  "merchant_order_id": "recurring-order",
  "currency": "EUR",
  "amount": 995,
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "recurring",
      "vault_token": "{vault_token}"
    }
  ]
}

Terugkerende betalingen retourneren geen payment_url in de respons omdat er geen klantinteractie nodig is. De betaling wordt onmiddellijk verwerkt.

U kunt zowel vault_token als first_transaction_id gebruiken om te verwijzen naar de opgeslagen kaart.

Tokengeldigheid

Terugkerende tokens hebben een maximale geldigheid van 1 jaar. Na het verlopen moet u een nieuwe eerste betaling initieren om een nieuw token te verkrijgen.

Zorg ervoor dat uw systeem het verlopen van tokens goed afhandelt. Stel een proces in om klanten opnieuw te authenticeren voordat hun tokens verlopen.

Terugkerend vs. One-Click

Kenmerk	Terugkerend (MIT)	One-Click (CIT)
Geinitieerd door	Handelaar	Klant
Klant aanwezig	Nee	Ja
Gebruiksscenario	Abonnementen, geplande facturering	Snel afrekenen voor terugkerende klanten
`schedule_type` vereist	Ja	Nee
`payment_url` geretourneerd	Nee	Ja

Gerelateerde eindpunten

Bestelling aanmaken — gebruik recurring_type en schedule_type in de transactie om terugkerende betalingen in te stellen of te verwerken