Skip to main content

PayPal

Connection

Frihet stores your PayPal API credentials and, when you click the import button, brings in your transactions as paid invoices. Frihet does not send data to PayPal.

What Frihet does​

  • Stores the credentials of your PayPal Developer app securely:
    • Client ID and Client Secret (stored encrypted)
  • Test connection — Frihet checks the credentials by requesting a token from PayPal. The Sandbox mode (testing) checkbox only affects the connection test: imports always query PayPal Live.
  • Import transactions, on the Data tab — creates one paid invoice per PayPal transaction:
    • The document number is PP- followed by the transaction identifier.
    • If the transaction includes items, each one is a line; otherwise there is a single "PayPal transaction" line.
    • The currency is the transaction's currency and the invoice is created with no taxes.
    • Frihet uses the client you already have with the same payer email (or, without an email, the same name). If none exists, it creates a new one.
  • If an invoice with the same document number already exists, the transaction is skipped.
  • Each import brings in transactions since the last recorded sync. Saving the connection records that moment as the starting point: the first import only brings in transactions made after you connected, not your earlier history. If you save the connection again, the starting point moves to that moment.

What Frihet does not do​

  • Import automatically or on a schedule: the import runs only when you click Import transactions.
  • Import refunds. Refunds are not imported, nor is any other transaction with a negative amount: when the import finishes, Frihet tells you how many were left out so you can record each one yourself as a corrective invoice (rectificativa) of the original invoice.
  • Show your PayPal account balance on the dashboard.
  • Match transactions to existing invoices or reconcile payments.
  • Convert amounts to your base currency or store exchange rates.
  • Let you choose a date range for the import.
  • Import your PayPal history from before you connected.

Requirements​

  • PayPal Business account: personal accounts do not have API access.
  • A PayPal Developer app to obtain the Client ID and Client Secret.
  • Each connected integration counts toward your plan limit: 2 on Free, 5 on Pro, unlimited on Premium.

Connect​

Step 1: create an app in PayPal Developer​

  1. Go to developer.paypal.com and sign in with your PayPal Business account.
  2. In Apps & Credentials, choose Live mode (or Sandbox for testing).
  3. Click Create App and give it a name, for example "Frihet ERP".
  4. Copy the Client ID and, with Show, the Client Secret.
Save the Secret

Copy the Client Secret and store it somewhere safe before you continue.

Step 2: save them in Frihet​

  1. In Frihet, go to Integrations.
  2. Open PayPal.
  3. On the Connection tab, enter the Client ID and the Client Secret. Check Sandbox mode (testing) only to test Sandbox credentials.
  4. Click Test connection to verify.
  5. If the test succeeds, click Save connection.

Step 3: import the transactions​

On the Data tab, click Import transactions. If there are no new transactions, Frihet says so.

Troubleshooting​

Authentication error​

  • Check that the Client ID and Client Secret are correct.
  • Imports always use PayPal Live: with Sandbox credentials the connection test passes, but the import brings in nothing.
  • Check that your PayPal Business account is active and verified.

No transactions are imported​

  • Only transactions after the last recorded sync are requested or, if you have not imported anything, after you connected.
  • If PayPal rejects the request, for example because the app lacks permissions on transactions, the import ends without bringing anything.
  • Transactions whose PP- number already exists as an invoice are skipped.

Refunds are missing​

  • Refunds are not imported. Frihet tells you how many there are so you can record each one as a corrective invoice of the original invoice.

Next steps​

Last updated on