Hop til hovedindhold

GoCardless

Tilgængelig

Denne integration er aktiv og klar til brug i Frihet.

Forbind GoCardless til Frihet for at administrere SEPA-bankoverførselsopkrævninger. Se mandater, betalinger og kunder direkte fra dit ERP. Ideel til abonnementer og tilbagevendende opkrævninger med lave gebyrer.

Hvad bruges det til?​

Med integreret GoCardless:

  • Importer betalinger — Importer GoCardless-opkrævninger som fakturaer i Frihet med et enkelt klik
  • Automatisk deduplikering — Allerede importerede betalinger duplikeres ikke (præfiks GC-)
  • Se betalinger — Se alle dine bankoverførselsopkrævninger fra Frihet
  • Administrer kunder — Få adgang til kundeinformation med aktive mandater
  • Se mandater — Se status for hvert SEPA-mandat (aktivt, afventende, annulleret)
  • Afstem opkrævninger — Knyt GoCardless-betalinger til fakturaer i Frihet
  • Sandbox-tilstand — Test integrationen med fiktive data

Krav​

  • Aktiv GoCardless-konto — gocardless.com
  • API Access Token — Genereres fra dashboardet
  • Frihet Pro eller højere

Tilslut GoCardless med Frihet​

Trin 1: Hent dit Access Token​

  1. Gå til manage.gocardless.com (eller manage-sandbox.gocardless.com til test)
  2. Log ind på din konto
  3. Gå til Developers i sidemenuen
  4. Klik på Create → Access Token
  5. Vælg scope Read-only (tilstrækkeligt til at forespørge data) eller Read-write hvis du skal administrere opkrævninger
  6. Giv det et navn (f.eks.: "Frihet ERP")
  7. Kopier det genererede token
Gem tokenet

Access Tokenet vises kun én gang ved oprettelse. Kopier det, før du lukker vinduet.

Trin 2: Konfigurer i Frihet​

  1. Gå til Indstillinger → Integrationer
  2. Søg efter GoCardless
  3. Klik på Forbind
  4. Indsæt dit Access Token
  5. Vælg miljø:
    • Live — Til rigtige data
    • Sandbox — Til test
  6. Klik på Verificer forbindelse

Trin 3: Verificer forbindelse​

Hvis forbindelsen er korrekt, vil Frihet vise:

  • Navnet på din organisation i GoCardless
  • Antal aktive mandater
  • Antal registrerede kunder

Sådan fungerer det​

Frihet opretter forbindelse til GoCardless API v2 (version 2015-07-06) ved hjælp af Bearer authentication:

  1. Du angiver dit Access Token
  2. Frihet sender tokenet i headeren Authorization: Bearer <token> for hver anmodning
  3. Data for betalinger, kunder og mandater forespørges on-demand
  4. Tokenet lagres krypteret (AES-256-GCM) i Frihet
  5. Al kommunikation sker over HTTPS

Synkroniserede data​

DataRetningFrekvens
Betalinger (opkrævninger)GoCardless → FrihetOn-demand
KunderGoCardless → FrihetOn-demand
SEPA-mandaterGoCardless → FrihetOn-demand
BetalingsstatusGoCardless → FrihetOn-demand

Anvendelsestilfælde​

Rådgivning med månedlige gebyrer​

Du opkræver et månedligt gebyr fra dine kunder via bankoverførsel. Fra Frihet kan du se, hvilke betalinger der er blevet opkrævet korrekt, hvilke der er afventende, og hvilke der er mislykkedes, uden at forlade dit ERP.

SaaS med SEPA-abonnementer​

Dine europæiske kunder foretrækker at betale via bankoverførsel i stedet for med kort. GoCardless administrerer de tilbagevendende opkrævninger, og Frihet viser dig status for hver betaling sammen med de udstedte fakturaer.

Verificer mandater før fakturering​

Før du udsteder en tilbagevendende faktura, skal du fra Frihet kontrollere, om kundens mandat stadig er aktivt. Undgå at fakturere kunder, hvis mandat er udløbet eller blevet annulleret.

Importer betalinger til Frihet​

Du kan importere GoCardless-betalinger som fakturaer i Frihet:

  1. Gå til Indstillinger → Integrationer → GoCardless
  2. Under fanen Data klik på Importer betalinger
  3. Frihet vil downloade alle betalinger og oprette fakturaer for hver enkelt
  4. Tidligere importerede betalinger springes automatisk over (deduplikering via GC-{id})
  5. Når du er færdig, vil du se det nøjagtige antal importerede betalinger

De importerede betalinger inkluderer: beløb, valuta, dato, reference og status.

Sandbox-tilstand​

GoCardless tilbyder et fuldstændig separat sandbox-miljø:

  1. Registrer dig på manage-sandbox.gocardless.com
  2. Opret et Access Token i sandbox-miljøet
  3. Konfigurer Frihet i "Sandbox"-tilstand
  4. Opret testmandater og betalinger fra sandbox-dashboardet
  5. Verificer at data vises korrekt i Frihet

Betalingsstatusser i GoCardless​

GoCardless StatusBetydning
pending_submissionBetaling oprettet, afventer afsendelse til banken
submittedSendt til banken, under behandling
confirmedOpkrævning gennemført med succes
paid_outMidler overført til din konto
failedOpkrævningen mislykkedes (utilstrækkelige midler, mandat annulleret osv.)
cancelledAnnulleret før behandling

Fejlfinding​

"Autentificeringsfejl"​

  • Verificer at Access Tokenet er korrekt og ikke er udløbet
  • Sørg for at bruge et Live token i Live-tilstand og et Sandbox token i Sandbox-tilstand
  • Hvis du regenererede tokenet i GoCardless, skal du opdatere det i Frihet

"Jeg kan ikke se mine betalinger"​

  • Kontroller at du har registrerede betalinger på din GoCardless-konto
  • Verificer at tokenet har læsetilladelser
  • I sandbox, opret først testbetalinger

"API-versionsfejl"​

  • Frihet bruger GoCardless API version 2015-07-06, som er stabil og kompatibel
  • Hvis GoCardless meddeler API-ændringer, vil vi opdatere integrationen

"Jeg vil afbryde forbindelsen"​

  1. Gå til Indstillinger → Integrationer → GoCardless
  2. Klik på Afbryd forbindelse
  3. Eventuelt tilbagekald Access Tokenet fra GoCardless dashboardet

Næste skridt​