Hoppa till huvudinnehåll

GoCardless

Tillgänglig

Denna integration är aktiv och redo att användas i Frihet.

Anslut GoCardless till Frihet för att hantera SEPA-autogirobetalningar. Se mandat, betalningar och kunder direkt från ditt ERP. Perfekt för abonnemang och återkommande betalningar med låga avgifter.

Vad är det till för?​

Med GoCardless integrerat:

  • Importera betalningar — Importera betalningar från GoCardless som fakturor i Frihet med ett klick
  • Automatisk deduplicering — Redan importerade betalningar dupliceras inte (prefix GC-)
  • Se betalningar — Se alla dina autogirobetalningar från Frihet
  • Hantera kunder — Få åtkomst till information om kunder med aktiva mandat
  • Visa mandat — Se status för varje SEPA-mandat (aktivt, väntande, avbrutet)
  • Avstämma betalningar — Koppla GoCardless-betalningar till fakturor i Frihet
  • Sandbox-läge — Testa integrationen med fiktiva data

Krav​

  • Aktivt GoCardless-konto — gocardless.com
  • API Access Token — Genereras från dashboarden
  • Frihet Pro eller högre

Anslut GoCardless till Frihet​

Steg 1: Hämta din Access Token​

  1. Gå till manage.gocardless.com (eller manage-sandbox.gocardless.com för testning)
  2. Logga in på ditt konto
  3. Gå till Developers i sidomenyn
  4. Klicka på Create → Access Token
  5. Välj scope Read-only (tillräckligt för att läsa data) eller Read-write om du behöver hantera betalningar
  6. Ge den ett namn (t.ex. "Frihet ERP")
  7. Kopiera den genererade token
Spara token

Access Token visas bara en gång när den skapas. Kopiera den innan du stänger fönstret.

Steg 2: Konfigurera i Frihet​

  1. Gå till Inställningar → Integrationer
  2. Sök efter GoCardless
  3. Klicka på Anslut
  4. Klistra in din Access Token
  5. Välj miljö:
    • Live — För verkliga data
    • Sandbox — För testning
  6. Klicka på Verifiera anslutning

Steg 3: Verifiera anslutning​

Om anslutningen är korrekt visar Frihet:

  • Namnet på din organisation i GoCardless
  • Antal aktiva mandat
  • Antal registrerade kunder

Så fungerar det​

Frihet ansluter till GoCardless API v2 (version 2015-07-06) med Bearer authentication:

  1. Du tillhandahåller din Access Token
  2. Frihet skickar token i Authorization: Bearer <token>-huvudet för varje förfrågan
  3. Data för betalningar, kunder och mandat hämtas vid behov
  4. Token lagras krypterad (AES-256-GCM) i Frihet
  5. All kommunikation sker över HTTPS

Synkroniserade data​

DataRiktningFrekvens
Betalningar (insamlingar)GoCardless → FrihetVid behov
KunderGoCardless → FrihetVid behov
SEPA-mandatGoCardless → FrihetVid behov
BetalningsstatusGoCardless → FrihetVid behov

Användningsfall​

Konsultfirma med månadsavgifter​

Du debiterar en månadsavgift från dina kunder via autogiro. Från Frihet kan du se vilka betalningar som har samlats in korrekt, vilka som är väntande och vilka som har misslyckats, utan att lämna ditt ERP.

SaaS med SEPA-prenumerationer​

Dina europeiska kunder föredrar att betala via autogiro istället för kort. GoCardless hanterar återkommande betalningar och Frihet visar dig status för varje betalning tillsammans med de utfärdade fakturorna.

Verifiera mandat innan fakturering​

Innan du utfärdar en återkommande faktura, kontrollera från Frihet om kundens mandat fortfarande är aktivt. Undvik att fakturera kunder vars mandat har löpt ut eller annullerats.

Importera betalningar till Frihet​

Du kan importera betalningarna från GoCardless som fakturor i Frihet:

  1. Gå till Inställningar → Integrationer → GoCardless
  2. På fliken Data, klicka på Importera betalningar
  3. Frihet kommer att ladda ner alla betalningar och skapa fakturor för var och en
  4. Redan importerade betalningar hoppas automatiskt över (deduplicering via GC-{id})
  5. När det är klart kommer du att se det exakta antalet importerade betalningar

De importerade betalningarna inkluderar: belopp, valuta, datum, referens och status.

Sandbox-läge​

GoCardless erbjuder en helt separat sandbox-miljö:

  1. Registrera dig på manage-sandbox.gocardless.com
  2. Skapa en Access Token i sandbox-miljön
  3. Konfigurera Frihet i "Sandbox"-läge
  4. Skapa testmandat och testbetalningar från sandbox-dashboarden
  5. Verifiera att data visas korrekt i Frihet

Betalningsstatusar i GoCardless​

GoCardless StatusBetydelse
pending_submissionBetalning skapad, väntar på att skickas till banken
submittedSkickad till banken, behandlas
confirmedBetalning genomförd med framgång
paid_outMedel överförda till ditt konto
failedBetalningen misslyckades (otillräckliga medel, mandat annullerat, etc.)
cancelledAvbruten innan behandling

Felsökning​

"Autentiseringsfel"​

  • Verifiera att Access Token är korrekt och inte har gått ut
  • Se till att använda en Live-token i Live-läge och en Sandbox-token i Sandbox-läge
  • Om du återskapade token i GoCardless, uppdatera den i Frihet

"Jag ser inte mina betalningar"​

  • Kontrollera att du har betalningar registrerade i ditt GoCardless-konto
  • Verifiera att token har läsbehörighet
  • I sandbox, skapa testbetalningar först

"API-versionsfel"​

  • Frihet använder GoCardless API-version 2015-07-06, som är stabil och kompatibel
  • Om GoCardless meddelar API-ändringar kommer vi att uppdatera integrationen

"Jag vill koppla från"​

  1. Gå till Inställningar → Integrationer → GoCardless
  2. Klicka på Koppla från
  3. Alternativt, återkalla Access Token från GoCardless-dashboarden

Nästa steg​