Skip to content

NEWUnify Agents (MCP): governed AI access to finance data. Early access.See Unify Agents

PP

PAYMENTS INTEGRATION

PayPal integration with the Unify Payments API

Read PayPal transactions, refunds and payouts, plus 2 more objects, on one data model, in beta.

BetaOAuth 2.0 · Sandbox yes

GET /v1/finance/transactions?platform=paypal&limit=1

API design preview

Request

curl "https://api.unifyint.com/v1/finance/transactions?platform=paypal&limit=1" \
  -H "Authorization: Bearer $UNIFY_API_KEY"

200 OK · API design preview

{
  "data": [
    {
      "id": "tra_01EXAMPLE",
      "object": "transaction",
      "remote_id": "example-1001",
      "amount": 1250,
      "currency": "USD",
      "status": "settled",
      "updated_at": "2026-10-28T14:02:11Z",
      "raw": { "...": "original PayPal record, unchanged" }
    }
  ],
  "next_cursor": null
}

API design preview. Field names may change before general availability.

About the PayPal integration

PayPal is a global digital payments platform used by online merchants and marketplaces. The Unify Payments API reads its transactions, captures, refunds, disputes, payouts and balances.

PayPal's REST APIs use OAuth 2.0 client credentials, with partner onboarding for third-party access and webhooks for payment, refund and dispute events. The Unify Payments API maps transactions from the Transaction Search API, captures, refunds, disputes and balances to the Unify Graph.

Status
Beta
Category
Payments
Auth
OAuth 2.0
Sandbox
Available
Webhooks
Yes
Bank feeds
No
Regions
US, UK, EU, AU, CA

Supported objects

Read and write status for each PayPal object in the Unify Payments API. Write appears only where write-back is confirmed.

  • Transactions

    Read · Beta
  • Refunds

    Read · BetaWrite on roadmap
  • Payouts

    Read · Beta
  • Balances

    Read · Beta
  • Disputes

    Read · Beta

Why build PayPal on Unify Int

  • One data model

    PayPal records arrive in the same Unify Graph shape as every other platform in the category, with the original record kept in raw.

  • Unify Connect

    A white-label flow for your customers to authorize PayPal. Tokens are stored and refreshed for you.

  • Custom fields and passthrough

    Map PayPal custom fields per connection, and call any endpoint the model does not cover through passthrough requests.

  • Unify Monitor

    Request logs, sync health and alerts for every PayPal connection, so support can see what happened.

PayPal integration questions

Does Unify Int support PayPal transactions and refunds?
Yes, in beta. The Unify Payments API reads PayPal transactions, refunds, payouts, balances and disputes. Write-back for refunds is on the roadmap; it appears as Write on this page only once it is confirmed.
How do customers connect their PayPal account?
Your customer grants Unify Int access to their PayPal business account through PayPal's partner onboarding in Unify Connect.
Is there a PayPal sandbox for testing?
Yes. PayPal's developer sandbox provides test business and buyer accounts.
How often does PayPal data sync?
Unify Sync uses PayPal webhooks for change detection, so new and updated records usually arrive within minutes, with scheduled polling as a safety net. You can set the schedule per object.
Can I access PayPal custom fields?
PayPal custom IDs and invoice IDs on transactions are kept on each payment and can be used for invoice matching.

Get started

Connect once. Build everything else on top.

Request sandbox access, or book 30 minutes with an engineer to map your integrations.

Free sandbox access. No credit card. Reply within one business day.