Menu

Samenvatting van de GoCardless API

De GoCardless API stelt je in staat om bankbetalingen wereldwijd te automatiseren — van het verzamelen van mandaten tot het uitvoeren van payouts en refunds. Hiermee bouw je incasso en variable recurring payments direct in je product in, zonder losse PSP-koppelingen.
  • Klanten en mandaten: Verzamel SEPA-, Bacs-, ACH-, BECS-, PAD- en Autogiro-mandaten via Billing Requests, redirect flows of mandate-imports.
  • Eenmalige en terugkerende incasso's: Maak losse betalingen, abonnementen en termijnschema's aan met flexibele datums en retry-logica.
  • Payouts en reconciliatie: Haal payouts en payout-items op, verzoen ze met events en exports en update payout-referenties.
  • Refunds en disputes: Initieer refunds, beheer disputes en gebruik blocks om frauduleuze betalers tegen te houden.
  • Verified mandates en KYC: Gebruik payer authorisations en verification details voor offline-onboarding en compliance.
  • Webhooks en exports: Configureer webhooks, vraag historische exports op en simuleer event-scenario's in de sandbox.
API Quick Facts REST
  • Authenticatie Bearer Token, OAuth2
  • Methods POST (66)GET (63)DELETE (1)PUT (12)
  • Rate limits 1.000 requests per minuut per integrator (of per merchant bij partner-integraties); ratelimit-limit, ratelimit-remaining en ratelimit-reset response-headers geven het actuele venster aan
  • Webhooks Beschikbaar
  • Sandbox Beschikbaar
  • Response format JSON
  • Versionering Header-based
  • SDK's PHP, Python, Node.js, Java, .NET, Ruby

Laatste ontwikkelingen bij de GoCardless API

GoCardless werd opgericht in 2011 met een eerste API rond UK Bacs Direct Debit. In juli 2015 verscheen de huidige API-versie 2015-07-06, die met een GoCardless-Version-header gegarandeerde backwards-compatibility geeft. Na 2017 volgden snelle uitbreidingen: payout-items en surcharge fees in 2017, BECS en BECS NZ in 2018, PAD in 2018, instalment schedules en internationale FX in 2020 en payer authorisations als single-call onboarding. Maart 2021 introduceerde Billing Requests, een gecombineerde resource voor klant, bankrekening en mandaat. In 2024-2025 kwamen Faster ACH, balances, processing errors op mandate imports en gespecificeerde consent types voor ACH en PAD.

API versies

Balances + processing errors
26 maart 2025

Nieuw /balances-endpoint voor crediteur-saldi en processing_errors-veld op mandate import entries voor betere foutafhandeling bij imports.

ACH & PAD-uitbreidingen
2 december 2024

ACH- en PAD-specifieke parameters toegevoegd aan Billing Requests: consent_type, payment_method-constraints, subscription_request en instalment_schedule_request bij creation.

Faster ACH
8 januari 2024

faster_ach-parameter en response-veld op de Payments API, plus next_possible_standard_ach_charge_date op mandates voor sneller incasso op het Amerikaanse ACH-schema.

Scenario Simulators
30 maart 2021

Sandbox-endpoint voor het simuleren van event-scenario's (mandaat cancelled, payment failed) zonder externe afhankelijkheden.

Billing Requests Major release
26 maart 2021

Lancering van Billing Requests, een gecombineerde resource voor klant, bankrekening en mandaat met Billing Request Flows voor custom payment pages.

Webhooks endpoint
28 januari 2021

Endpoints om historische webhooks op te halen en handmatig opnieuw te versturen; webhook_id wordt nu toegevoegd aan de meta-key in afgaande webhooks.

Payer Authorisations
30 oktober 2020

Single-call onboarding-resource die klant, bankrekening en mandaat in één request bundelt — voorloper van Billing Requests.

Tax Rates + internationale FX
14 juli 2020

Nieuwe tax_rates-endpoint, taxes op payout_items en internationale payouts/refunds met tax_currency en surcharge_fee-events.

Instalment Schedules
28 januari 2020

Nieuwe Instalment Schedules-resource voor het inplannen van meerdere betalingen onder één mandaat — ideaal voor termijnbetalingen en pay-in-X.

API 2015-07-06 Major release
6 juli 2015

Huidige versie van de API. Verwijdert de Helpers-endpoint, hernoemt start_at/end_at naar start_date/end_date op subscriptions en dwingt date-formaat (geen datetime) af voor payment charge_date.