Skip to main content
AgencyHandy’s PayPal integration gives your clients a secure, familiar way to pay invoices without a credit card. PayPal supports a wide range of international currencies, making it especially useful for agencies with clients outside of their home country.
PayPal cannot be used for upsells due to platform-level currency and regional limitations. For upsell payments, use Stripe instead.
Only SuperAdmin and Admin roles can connect or manage the PayPal integration. You must have an active PayPal account before you start.

​
Connect PayPal

1

Open PayPal Integration settings

Sign in to AgencyHandy, then go to Integrations → PayPal Integration in the left sidebar.
2

Start the connection

Click Connect PayPal. You are redirected to PayPal’s login page.
3

Authorize AgencyHandy

Sign in to your PayPal account and review the permissions requested. Click Allow (or Grant) to authorize AgencyHandy to access your account.
4

Confirm the connection

After successful authorization, PayPal redirects you back to AgencyHandy. A confirmation message — PayPal Connected — appears on the integration card. Clients can now pay invoices using PayPal.

​
How clients pay via PayPal

Once the integration is active, a Pay with PayPal button appears on any invoice you send. Your client clicks the button, logs in to their PayPal account (or pays as a guest depending on their region), and completes the payment. AgencyHandy updates the invoice status automatically when payment is confirmed by PayPal.

​
Supported currencies

AgencyHandy supports the following currencies for PayPal payments:
RegionCurrencies
AmericasUSD, CAD, BRL, MXN
EuropeEUR, GBP, CHF, NOK, SEK, DKK, PLN, CZK, HUF
Asia-PacificAUD, NZD, JPY, HKD, SGD, MYR, PHP, THB, TWD
Middle East / OtherILS, CNY
Some currencies have restrictions:
  • JPY and a few others do not support decimal amounts — avoid fractional invoice totals.
  • BRL is only available for Brazilian PayPal accounts. If your account is not based in Brazil, BRL payments are automatically converted to your primary currency.
  • Certain currencies are only available for in-country accounts. Confirm your account’s holding currency matches your invoice currency to prevent errors.
PayPal applies its own conversion fees and spreads when currency conversion occurs. These are not controlled by AgencyHandy.

​
Test the integration

Before using PayPal for real client invoices, run a quick test:
  1. Create a test invoice in AgencyHandy using a supported currency.
  2. Send the invoice to a secondary PayPal account you control.
  3. Complete the payment from the secondary account.
  4. Return to AgencyHandy and confirm the invoice status updated to Paid and that the funds appear in your PayPal account.