Skip to main content

GoCardless

Tilgjengelig

Denne integrasjonen er aktiv og klar til bruk i Frihet.

Koble GoCardless til Frihet for å administrere SEPA autogiro-innkrevinger. Se mandater, betalinger og kunder direkte fra ditt ERP. Ideell for abonnementer og gjentakende innkrevinger med lave gebyrer.

Hva er det for?​

Med GoCardless integrert:

  • Importer betalinger — Importer innkrevinger fra GoCardless som fakturaer i Frihet med ett klikk
  • Automatisk deduplisering — Betalinger som allerede er importert blir ikke duplisert (prefiks GC-)
  • Se betalinger — Se alle dine autogiro-innkrevinger fra Frihet
  • Administrer kunder — Få tilgang til kundeinformasjon med aktive mandater
  • Se mandater — Se status for hvert SEPA-mandat (aktivt, ventende, kansellert)
  • Avstem innkrevinger — Knytt GoCardless-betalinger til fakturaer i Frihet
  • Sandkassemode — Test integrasjonen med fiktive data

Krav​

  • Aktiv GoCardless-konto — gocardless.com
  • API-tilgangstoken — Genereres fra dashbordet
  • Frihet Pro eller høyere

Koble GoCardless til Frihet​

Trinn 1: Hent ditt API-tilgangstoken​

  1. Gå til manage.gocardless.com (eller manage-sandbox.gocardless.com for testing)
  2. Logg inn på kontoen din
  3. Gå til Developers i sidemenyen
  4. Klikk på Create → Access Token
  5. Velg omfanget Read-only (tilstrekkelig for å se data) eller Read-write hvis du trenger å administrere innkrevinger
  6. Gi det et navn (f.eks.: "Frihet ERP")
  7. Kopier det genererte tokenet
Lagre tokenet

API-tilgangstokenet vises bare én gang ved opprettelse. Kopier det før du lukker vinduet.

Trinn 2: Konfigurer i Frihet​

  1. Gå til Innstillinger → Integrasjoner
  2. Søk etter GoCardless
  3. Klikk på Koble til
  4. Lim inn ditt API-tilgangstoken
  5. Velg miljø:
    • Live — For reelle data
    • Sandbox — For testing
  6. Klikk på Verifiser tilkobling

Trinn 3: Verifiser tilkobling​

Hvis tilkoblingen er vellykket, vil Frihet vise:

  • Navnet på din organisasjon i GoCardless
  • Antall aktive mandater
  • Antall registrerte kunder

Hvordan det fungerer​

Frihet kobler til GoCardless API v2 (versjon 2015-07-06) ved hjelp av Bearer-autentisering:

  1. Du oppgir ditt API-tilgangstoken
  2. Frihet sender tokenet i headeren Authorization: Bearer <token> for hver forespørsel
  3. Betalings-, kunde- og mandatdata hentes etter behov
  4. Tokenet lagres kryptert (AES-256-GCM) i Frihet
  5. All kommunikasjon foregår over HTTPS

Synkroniserte data​

DataRetningFrekvens
Betalinger (innkrevinger)GoCardless → FrihetEtter behov
KunderGoCardless → FrihetEtter behov
SEPA-mandaterGoCardless → FrihetEtter behov
BetalingsstatusGoCardless → FrihetEtter behov

Bruksområder​

Rådgivning med månedlige avgifter​

Du krever inn en månedlig avgift fra kundene dine via autogiro. Fra Frihet kan du se hvilke betalinger som er innkrevd korrekt, hvilke som er ventende og hvilke som har feilet, uten å forlate ditt ERP.

SaaS med SEPA-abonnementer​

Dine europeiske kunder foretrekker å betale med autogiro i stedet for kort. GoCardless administrerer de gjentakende innkrevingene og Frihet viser deg status for hver betaling sammen med de utstedte fakturaene.

Verifiser mandater før fakturering​

Før du utsteder en gjentakende faktura, sjekk fra Frihet om kundens mandat fortsatt er aktivt. Unngå å fakturere kunder hvis mandat har utløpt eller er kansellert.

Importer betalinger til Frihet​

Du kan importere GoCardless-betalingene som fakturaer i Frihet:

  1. Gå til Innstillinger → Integrasjoner → GoCardless
  2. På fanen Data, klikk på Importer betalinger
  3. Frihet vil laste ned alle betalingene og opprette fakturaer for hver enkelt
  4. Betalinger som allerede er importert hoppes over automatisk (deduplisering basert på GC-{id})
  5. Når det er ferdig, vil du se nøyaktig antall importerte betalinger

De importerte betalingene inkluderer: beløp, valuta, dato, referanse og status.

Sandkassemode​

GoCardless tilbyr et helt separat sandkassemiljø:

  1. Registrer deg på manage-sandbox.gocardless.com
  2. Opprett et API-tilgangstoken i sandkassemiljøet
  3. Konfigurer Frihet i "Sandkasse"-modus
  4. Opprett testmandater og testbetalinger fra sandkasse-dashbordet
  5. Verifiser at dataene vises korrekt i Frihet

Betalingsstatus i GoCardless​

GoCardless-statusBetydning
pending_submissionBetaling opprettet, venter på sending til banken
submittedSendt til banken, under behandling
confirmedInnkreving utført med suksess
paid_outMidler overført til din konto
failedInnkrevingen feilet (utilstrekkelige midler, mandat kansellert, osv.)
cancelledKansellert før behandling

Feilsøking​

"Autentiseringsfeil"​

  • Verifiser at API-tilgangstokenet er korrekt og ikke har utløpt
  • Sørg for å bruke et Live-token i Live-modus og Sandbox-token i Sandkasse-modus
  • Hvis du regenererte tokenet i GoCardless, oppdater det i Frihet

"Jeg ser ikke betalingene mine"​

  • Sjekk at du har registrerte betalinger på din GoCardless-konto
  • Verifiser at tokenet har lesetillatelser
  • I sandkasse, opprett testbetalinger først

"API-versjonsfeil"​

  • Frihet bruker API-versjon 2015-07-06 fra GoCardless, som er stabil og kompatibel
  • Hvis GoCardless varsler om API-endringer, vil vi oppdatere integrasjonen

"Jeg ønsker å koble fra"​

  1. Gå til Innstillinger → Integrasjoner → GoCardless
  2. Klikk på Koble fra
  3. Eventuelt, tilbakekall API-tilgangstokenet fra GoCardless-dashbordet

Neste steg​