ml-connector
Oracle PeopleSoftGoCardless

Oracle PeopleSoft and GoCardless integration

Oracle PeopleSoft manages your financials and customer master. GoCardless collects payments directly from customer bank accounts. Connecting the two keeps your AR current and reconciled. Payments collected by GoCardless flow back into Oracle PeopleSoft's customer accounts and general ledger without manual re-entry. Customer records sync in both directions so payment terms and collection data stay aligned.

How Oracle PeopleSoft works

Oracle PeopleSoft runs on customer-hosted infrastructure or Oracle Cloud Manager and exposes invoice inquiry, customer master, and payment data through REST ListeningConnectors (JSON) and SOAP Component Interfaces (XML). Authentication uses HTTP Basic Auth with an OPRID and password or OAuth2 bearer token for PeopleTools 8.58+. Each customer instance has a unique hostname and port. Service operations are read-only inquiry functions or write-enabled SOAP services; Integration Broker can also receive XML messages pushed from external systems. PeopleSoft does not offer webhooks for outbound notifications, so data is read by polling with date-range filters. Result pagination varies by service operation and requires filtering by date ranges for large datasets.

How GoCardless works

GoCardless exposes customers, mandates, payments, subscriptions, payouts, and refunds through REST JSON APIs at api.gocardless.com (production) or api-sandbox.gocardless.com (sandbox). Authentication uses a bearer token (personal access token or OAuth2) sent in the Authorization header, and API version is specified via a GoCardless-Version header. GoCardless provides real-time webhooks that POST batches of events (up to 250 per request) to a registered HTTPS endpoint, signed with HMAC-SHA256. Webhook events include audit trail data but are read-only; payouts are also read-only and created automatically by GoCardless. Amount fields are integers in the smallest currency unit. Webhook signature verification is mandatory.

What moves between them

The main flow runs from GoCardless into Oracle PeopleSoft. When GoCardless collects a payment or records a refund, ml-connector receives the event via webhook, verifies the HMAC signature, and posts a payment record into Oracle PeopleSoft's customer account and AR subledger, mapped to the matching customer and GL account. Customer master records such as bank account status and mandate information sync from GoCardless into Oracle PeopleSoft so that AR teams can see which customers are active in the payment plan. Reference data such as customer names and payment terms flow both directions, ensuring Oracle PeopleSoft and GoCardless are aligned on collection status and customer creditworthiness.

How ml-connector handles it

ml-connector stores the GoCardless bearer token and Oracle PeopleSoft OAuth2 credentials or basic auth password encrypted and presents them on each request. On the GoCardless side it listens for webhooks at a registered HTTPS endpoint, verifies every incoming webhook signature with HMAC-SHA256 using the webhook signing secret, and discards unsigned or tampered events. On the Oracle PeopleSoft side it accepts the unique hostname and port for the customer's PeopleSoft instance, since there is no shared base URL, and authenticates with either HTTP Basic Auth or OAuth2 depending on the customer's PeopleTools version. Because Oracle PeopleSoft does not push outbound events, ml-connector also polls for new customer and payment data on a schedule, filtered by date ranges to stay within rate limits and avoid re-processing. GoCardless events carry globally unique IDs, so ml-connector tracks processed webhook event IDs to avoid re-posting duplicate payments. Payment amounts are converted from GoCardless's integer smallest-currency-unit format to the decimal GL format Oracle PeopleSoft expects. Every payment record and customer sync carries a full audit trail.

A real-world example

A mid-sized SaaS company runs Oracle PeopleSoft on-premise for general ledger, AP, AR, and customer master, and uses GoCardless to collect recurring subscription payments and one-off customer invoices across Europe and North America. Before the integration, the accounting team received daily reports from GoCardless, manually matched payments to customer records in Oracle PeopleSoft, and posted each one by hand in the AR module. Collections reconciliation took days each month, and discrepancies between GoCardless collection logs and Oracle PeopleSoft customer balances required manual investigation. With Oracle PeopleSoft and GoCardless connected, each payment GoCardless collects flows directly into the matching customer account and GL posting in Oracle PeopleSoft, reconciled automatically. The AR aging report reflects current collections status immediately, and month-end close starts with AR already reconciled.

What you can do

  • Receive payment and refund events from GoCardless in real-time via webhooks and verify HMAC-SHA256 signatures.
  • Post verified GoCardless payments into Oracle PeopleSoft customer accounts and AR subledger, mapped to the correct GL accounts.
  • Sync customer master records and mandate status from GoCardless into Oracle PeopleSoft to keep collection terms and customer creditworthiness current.
  • Authenticate GoCardless with bearer tokens and Oracle PeopleSoft with OAuth2 or HTTP Basic Auth, adapting to each customer's PeopleTools version.
  • Track processed webhook event IDs to prevent duplicate payments and maintain a full audit trail on every record.

Questions

Which direction does data flow between Oracle PeopleSoft and GoCardless?
The main flow is GoCardless into Oracle PeopleSoft. Payments, refunds, and customer mandate status move from GoCardless into Oracle PeopleSoft's AR module and customer master. Customer names, payment terms, and credit limits sync both directions to keep both systems aligned on collection eligibility and customer status.
How does the integration handle Oracle PeopleSoft's unique hostnames and lack of webhooks?
ml-connector accepts the unique hostname and port for each customer's Oracle PeopleSoft instance, since there is no shared base URL. Because Oracle PeopleSoft does not offer outbound webhooks, ml-connector listens for GoCardless webhook events and polls Oracle PeopleSoft on a schedule filtered by date ranges, so new payments are captured and posted without re-processing old data.
What happens if a GoCardless webhook arrives with a bad signature?
ml-connector verifies every webhook with HMAC-SHA256 and rejects unsigned or tampered events without posting them to Oracle PeopleSoft. This ensures that only authentic GoCardless payment events update your AR records. A rejected webhook is logged for audit and investigation by your support team.

Related integrations

Connect Oracle PeopleSoft and GoCardless

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

Get started