PayPal

Saatavilla

Tämä integraatio on aktiivinen ja käyttövalmis Frihetissä.

Yhdistä PayPal Business -tilisi Frihetiin. Tuo tapahtumia, tarkastele saldoja ja täsmäytä kansainväliset maksut laskujesi kanssa automaattisesti. Tukee sandbox-tilaa testikäyttöä varten.

Mihin tätä käytetään?

Integroidun PayPalin avulla:

• Tuo tapahtumia — Tuo PayPal-maksut automaattisesti Frihetiin laskuina
• Kattava sivutus — Tuo kaikki tapahtumat ilman rajoitusta (automaattinen sivutus)
• Älykäs historia — Ensimmäinen tuonti: 1 vuoden historia. Sen jälkeen: vain uudet tapahtumat viimeisimmästä synkronoinnista.
• Hyvitykset — Hyvitykset tuodaan etuliitteellä [Refund] ja negatiivisella summalla selkeän kirjanpidon varmistamiseksi
• Tarkastele saldoja — Näe PayPal-saldosi suoraan Frihetin dashboardista
• Täsmäytä maksut — Yhdistä PayPal-tapahtumat olemassa oleviin laskuihin
• Monivaluutta — Käsittelee maksuja EUR, USD, GBP ja muissa valuutoissa
• Duplikaattien poisto — Jo tuotuja tapahtumia ei duplicoida (etuliite PP-)
• Sandbox-tila — Testaa integraatiota vaikuttamatta oikeisiin tietoihin

Vaatimukset

• PayPal Business -tili — Henkilökohtaisilla tileillä ei ole pääsyä APIin
• Sovellus PayPal Developerissa — Client ID:n ja Client Secretin hankkimiseksi
• Frihet Pro tai vastaava

Yhdistä PayPal Frihetiin

Vaihe 1: Luo sovellus PayPal Developerissa

1. Mene osoitteeseen developer.paypal.com
2. Kirjaudu sisään PayPal Business -tililläsi
3. Mene dashboardissa kohtaan Apps & Credentials
4. Valitse tila Live (tai Sandbox testejä varten)
5. Napsauta Create App
6. Anna sille nimi (esim: "Frihet ERP")
7. Napsauta Create App

Kun sovellus on luotu, näet:

• Client ID — Julkinen tunniste (esim: AaBbCcDdEe...)
• Client Secret — Yksityinen avain (napsauta "Show" nähdäksesi sen)

Tallenna Secret

Client Secret näytetään vain kerran. Kopioi se ja tallenna se turvalliseen paikkaan ennen jatkamista.

Vaihe 2: Määritä Frihetissä

1. Mene Asetukset → Integraatiot
2. Etsi PayPal
3. Napsauta Yhdistä
4. Syötä Client ID ja Client Secret
5. Valitse tila:
   • Live — Todellisille tapahtumille
   • Sandbox — Testeille kuvitteellisilla tiedoilla
6. Napsauta Tarkista yhteys
7. Jos yhteys on kunnossa, näet "Yhdistetty"

Vaihe 3: Tarkista yhteys

1. Frihet hankkii automaattisesti OAuth2-tunnuksen käyttäen tunnuksiasi
2. Jos tarkistus onnistuu, näet PayPal-saldosi dashboardissa
3. Voit tehdä testituonnin viimeisimmillä tapahtumilla

Miten se toimii

Frihet käyttää PayPalin REST API v2:ta OAuth2-todennuksella (client credentials flow):

1. Annat Client ID:n ja Client Secretin
2. Frihet pyytää pääsytunnuksen PayPalilta automaattisesti
3. Tällä tunnuksella Frihet hakee tapahtumia ja saldoja
4. Tunnukset tallennetaan salattuna (AES-256-GCM) Frihetiin
5. Tunnus uusiutuu automaattisesti vanhentuessaan

Missään vaiheessa sinun ei tarvitse hallita tunnuksia manuaalisesti.

Synkronoidut tiedot

Tieto	Suunta	Tiheys
Vastaanotetut tapahtumat	PayPal → Frihet	Tarvittaessa / määräajoin
Tilisaldo	PayPal → Frihet	Jokaisella kyselyllä
Maksajan tiedot	PayPal → Frihet	Jokaisen tapahtuman yhteydessä
Valuutta ja vaihtokurssi	PayPal → Frihet	Jokaisen tapahtuman yhteydessä

Käyttötapaukset

Freelancer kansainvälisten asiakkaiden kanssa

Laskutat asiakkaita USD- ja EUR-valuutoissa PayPalin kautta. Frihet tuo jokaisen maksun, yhdistää sen vastaavaan laskuun ja muuntaa summan perusvaluuttaasi.

Verkkokauppa PayPal maksutapana

Vastaanotat maksuja asiakkailta PayPal Checkoutin kautta. Tapahtumat tuodaan Frihetiin ja voit täsmäyttää ne laskutettujen tilausten kanssa.

Tarkista saldo ennen toimittajille maksamista

Tarkista PayPal-saldosi Frihetin dashboardista poistumatta sovelluksesta. Päätä, onko sinulla riittävästi varoja ennen siirtojen tekemistä.

Sandbox-tila

Testataksesi integraatiota vaikuttamatta oikeisiin tietoihin:

1. Luo developer.paypal.com -sivustolla sovellus Sandbox-tilassa
2. Käytä Sandbox-tunnuksia Frihetissä (valitse "Sandbox"-tila)
3. PayPal tarjoaa testitilejä kuvitteellisella saldolla
4. Varmista, että tapahtumat tuodaan oikein
5. Kun olet valmis, vaihda Live-tilaan tuotantotunnuksilla

Vianmääritys

"Todennusvirhe"

• Varmista, että Client ID ja Client Secret ovat oikein
• Varmista, että käytät Live-tunnuksia Live-tilassa ja Sandbox-tunnuksia Sandbox-tilassa
• Tarkista, että PayPal Business -tilisi on aktiivinen ja vahvistettu

"Tapahtumia ei tuoda"

• Varmista, että tarkastellulla ajanjaksolla on tapahtumia (1 vuosi ensimmäisessä tuonnissa, viimeisimmästä synkronoinnista eteenpäin seuraavissa)
• Sandbox-tilassa luo testitapahtumia PayPal Developerin dashboardista
• Tarkista, että sovelluksellasi PayPalissa on tarvittavat oikeudet aktivoituna
• Jos ilmoitus näyttää "No new transactions to import", kaikki tapahtumat ovat jo Frihetissä

"API-oikeusvirhe"

• Kun luot sovelluksen PayPal Developerissa, varmista, että se sisältää tapahtumien scopet
• Jos muutit oikeuksia, luo uusi Client Secret ja päivitä se Frihetiin

"Haluan vaihtaa Sandbox-tilasta Live-tilaan"

1. Mene Asetukset → Integraatiot → PayPal
2. Napsauta Katkaise yhteys
3. Yhdistä uudelleen tuotantotunnuksilla (Live)

Seuraavat vaiheet

• Yhdistä Stripe korttimaksuja varten
• Yhdistä GoCardless SEPA-suoraveloituksia varten
• Automatisoi työnkulkuja n8n:llä

---