PayPal — Global Payments

Accept payments from anywhere in the world.

Connect PayPal to HavenPay and collect in USD, EUR, GBP, and more — alongside your M-Pesa and Airtel Money integrations. One dashboard, every payment method.

200+ countriesRedirect checkoutOAuth 2.0Encrypted credentials

How PayPal payments work

PayPal uses a redirect flow — different from M-Pesa STK push, but fully automated once configured.

01
Create order

Your server calls HavenPay's STK push endpoint. HavenPay creates a PayPal order and returns an approval URL.

02
Customer approves

Redirect the customer to the PayPal checkout page. They log in and approve with their PayPal account or card.

03
Auto-capture

PayPal posts a CHECKOUT.ORDER.APPROVED event. HavenPay captures the payment server-side within seconds.

04
Webhook & ledger

On PAYMENT.CAPTURE.COMPLETED, HavenPay fires your configured webhook and updates your merchant ledger.

The approval URL is your redirect target

HavenPay returns the PayPal approval URL as merchant_request_id in the STK push response. Redirect your customer there and HavenPay handles the rest automatically via webhook.

Everything included

Full PayPal integration, production-ready out of the box.

Global reach, local control

Accept payments from customers in 200+ countries. Your HavenPay dashboard unifies PayPal alongside M-Pesa and Airtel — one ledger, every currency.

Cards, wallets & Buy Now Pay Later

PayPal checkout gives customers the flexibility to pay with a saved card, their PayPal balance, or PayPal Pay Later — at no extra integration work.

PayPal Buyer & Seller Protection

Every transaction is covered by PayPal's dispute resolution. Chargebacks are handled by PayPal directly, not deducted silently from your balance.

Signed webhook callbacks

PAYMENT.CAPTURE.COMPLETED and CHECKOUT.ORDER.APPROVED events are verified against your Webhook ID before HavenPay credits your wallet.

Automatic order capture

When a customer approves a PayPal order, HavenPay captures it immediately via a server-side call — no manual step, no uncaptured orders left pending.

Unified analytics

PayPal, M-Pesa, and Airtel transactions all appear on one Transactions page with consistent status labels, receipt numbers, and export support.

Multi-currency support

Transact in USD, EUR, GBP, CAD, AUD, SGD, and more. Set your preferred currency per integration via the metadata field — no code changes needed.

OAuth 2.0 credential encryption

Your PayPal Client ID and Secret are stored AES-256 encrypted at rest, the same way every other provider credential is protected in HavenPay.

Multi-currency, zero code changes

Set your preferred currency once in the PayPal metadata field. HavenPay passes it through to every order automatically.

🇺🇸
USD
US Dollar
🇪🇺
EUR
Euro
🇬🇧
GBP
British Pound
🇨🇦
CAD
Canadian Dollar
🇦🇺
AUD
Australian Dollar
🇸🇬
SGD
Singapore Dollar

+ dozens more via PayPal's supported currency list. KES available for select PayPal account regions.

What you need to get started

Setup takes under five minutes. You only need a PayPal developer account and one app credential pair.

  • PayPal Developer account (free at developer.paypal.com)
  • A PayPal App — gives you Client ID & Client Secret
  • Optional: Webhook ID for callback signature verification
  • Your preferred transaction currency set in metadata
stk-push · PayPal
POST /v1/payments/stk-push

{
  "phone": "customer@email.com",
  "amount": 49.00,
  "external_reference": "ORDER-2024-001",
  "description": "Premium subscription",
  "provider": "paypal"
}

// Response 202
{
  "transaction_id": "uuid",
  "checkout_request_id": "6XV12345AA...",
  "merchant_request_id": "https://paypal.com/checkoutnow?token=...",
  "status": "processing",
  "provider": "paypal",
  "funds_routing": "direct_to_merchant"
}

Ready to accept global payments?

Connect PayPal in your HavenPay dashboard in under five minutes. Sandbox testing included.