ml-connector
Oracle Fusion Cloud ERPPayPal

Oracle Fusion Cloud ERP and PayPal integration

Oracle Fusion Cloud ERP powers your accounts payable and general ledger. PayPal processes your payments and maintains a complete payment history. Connecting the two keeps your invoice records and your payment ledger in agreement. New invoices entered in Oracle Fusion Cloud ERP can be submitted to PayPal for payment, and completed payments flow back into Oracle for automatic GL posting and account reconciliation. ml-connector handles the very different REST APIs on each side and moves the data on a schedule you control.

How Oracle Fusion Cloud ERP works

Oracle Fusion Cloud ERP exposes invoices, suppliers, purchase orders, payments, general ledger accounts, and journal batches through REST APIs at a customer-specific pod URL (https://{pod}.fa.{region}.oraclecloud.com/fscmRestApi/resources/), with OData-style query parameters for filtering by creation date and last update date. Cloud instances authenticate with OAuth 2.0 Client Credentials or Authorization Code grants, with bearer tokens valid for approximately one hour. Oracle Fusion Cloud ERP has no outbound webhook system for direct notifications, so records are read by polling the REST API, typically every 5 to 15 minutes with a timestamp filter to pull only new or recently updated records.

How PayPal works

PayPal exposes orders, payments, captures, refunds, invoices, and transaction search through REST APIs at https://api-m.paypal.com, organized into v1 and v2 path prefixes. All calls require OAuth 2.0 Client Credentials, with bearer tokens cached and reused for approximately eight hours. PayPal can push events to a registered webhook endpoint via HTTPS POST, including payment completion, order approval, and invoice events. Webhooks carry an RSA-SHA256 signature in the paypal-transmission-sig header for validation, and PayPal retries up to 25 times over three days on any non-2xx response.

What moves between them

Invoices created in Oracle Fusion Cloud ERP are pulled by ml-connector on a schedule and submitted to PayPal as payment requests. After PayPal processes a payment and a capture is completed, ml-connector receives the confirmation via webhook and posts the payment settlement into Oracle Fusion Cloud ERP's general ledger, mapped to the supplier and GL account from the original invoice. Transaction details are aligned in both directions so payment reconciliation matches invoice detail.

How ml-connector handles it

ml-connector stores both Oracle Fusion Cloud ERP and PayPal credentials encrypted and refreshes the OAuth 2.0 bearer tokens before they expire (Oracle tokens at 50 minutes, PayPal tokens at 7 hours and 50 minutes). On the Oracle side it accepts the full customer pod URL per tenant, since Oracle publishes no shared base address, and filters invoice queries by last update date to pull only changed records since the prior poll. When PayPal webhooks arrive, ml-connector verifies the RSA-SHA256 signature using PayPal's published certificate to ensure authenticity, then posts the payment confirmation and capture details into Oracle's journal batch API for immediate GL posting. Supplier validation occurs before a payment is submitted to ensure the supplier is registered in both systems, and failed payments are tracked with full audit detail so they can be replayed when the issue is resolved. Rate limits are handled with exponential backoff, and every record carries a full transaction trail.

A real-world example

A mid-sized software services company uses Oracle Fusion Cloud ERP for accounts payable and vendor management, and processes client payments and refunds through PayPal. Before the integration, the finance team exported invoices from Oracle, manually matched them to customers and projects in PayPal, and tracked payment confirmations in a spreadsheet, then re-entered settlement details into Oracle's general ledger daily. Month-end reconciliation required cross-referencing PayPal's transaction list against Oracle's unmatched invoices and chasing differences. With Oracle Fusion Cloud ERP and PayPal connected, each invoice generated in Oracle flows to PayPal automatically, payments are captured and confirmed, and settlement posts back into Oracle's ledger in real time. Reconciliation is now a verification step rather than a detective hunt.

What you can do

  • Pull invoices from Oracle Fusion Cloud ERP and submit them to PayPal as payment requests on a schedule tied to your billing cycle.
  • Post PayPal payment confirmations and captures back into Oracle Fusion Cloud ERP's general ledger with automatic GL account and supplier mapping.
  • Verify PayPal webhook signatures with RSA-SHA256 and handle payment events securely at scale.
  • Store OAuth 2.0 credentials encrypted for both Oracle Fusion Cloud ERP and PayPal, with automatic token refresh before expiry.
  • Poll Oracle Fusion Cloud ERP on a schedule with timestamp filtering, and receive PayPal confirmations via webhook with full audit trail and error replay.

Questions

Which direction does data move between Oracle Fusion Cloud ERP and PayPal?
The main flow is Oracle Fusion Cloud ERP into PayPal. Invoices and payment requests move from Oracle into PayPal, while payment confirmations and capture details flow back into Oracle for GL posting and reconciliation. PayPal transaction history can also be read on demand for reconciliation verification.
How does the integration handle OAuth 2.0 token expiry and refresh?
ml-connector caches OAuth 2.0 bearer tokens and refreshes them before expiry to prevent failed API calls. Oracle Fusion Cloud ERP tokens are refreshed at 50 minutes (before the 60-minute expiry), and PayPal tokens are refreshed at 7 hours and 50 minutes (before the 8-hour expiry). Token refresh happens automatically in the background.
How are PayPal webhooks verified for authenticity and fraud?
PayPal signs every webhook with an RSA-SHA256 signature in the paypal-transmission-sig header. ml-connector validates the signature against PayPal's published certificate before processing any webhook event. This prevents forged payment confirmations or unauthorized settlement postings into your Oracle Fusion Cloud ERP general ledger.

Related integrations

Connect Oracle Fusion Cloud ERP and PayPal

Free to use. Add your credentials, ping your real systems, and see if we fit.

Get started