> ## Documentation Index
> Fetch the complete documentation index at: https://grandcentral.backbase.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Includes the OBPM payment outbound, inbound, direct debit mandate, and foreign exchange connectors with payee contact sync support.

The **Grand Central OBPM Connector** provides connectivity with **Oracle Banking Payments Manager (OBPM)**, enabling payment orchestration across multiple payment channels.

The connector family includes:

* **OBPM payment outbound Connector:** Payment initiation and lifecycle management, payee contact synchronization (create and update), including domestic and international payee routing, fee retrieval, bank details lookup, and other outbound features. Doesn't handle payment status updates.
* **OBPM payment inbound Connector:** Status updates, recurring payment schedules, future-dated payment ingestion, and off-channel payment ingestion (FPS and internal payments) from the payments core using dedicated JMS queues.
* **OBPM direct debit Connector:** Mandate search, retrieval, and cancellation.
* **Flexcube foreign exchange Connector:** Currency exchange rate retrieval.

**Versions supported:** 14.5, 14.7

### Use cases supported

<CardGroup cols={3}>
  <Card title="Payment initiation" icon="money-bill-transfer">
    Initiate single or recurring payments across supported payment schemes.
  </Card>

  <Card title="Payment management" icon="gears">
    Manage payment lifecycle including modifications and cancellations.
  </Card>

  <Card title="Payee synchronization" icon="address-book">
    Synchronize beneficiary and payee information with OBPM, including create and update operations for domestic and international payees.
  </Card>

  <Card title="Future-dated payment ingestion" icon="calendar-days">
    Receive future-dated payments initiated in the payments core and surface them to channel apps through Sync Hub.
  </Card>

  <Card title="Direct debit management" icon="gears">
    Search, retrieve, and cancel direct debit mandates.
  </Card>

  <Card title="Payment ingestion" icon="inbox-in">
    Receive recurring payment schedules and off-channel payments from the payments core.
  </Card>

  <Card title="Ancillary features" icon="layer-group">
    Retrieve bank details, payment fees, exchange rates, and holiday calendars.
  </Card>
</CardGroup>

### Supported Grand Central endpoints

The OBPM Connector supports the following operations from the Grand Central Unified API v1:

| **Method**                                       | **Operation**                                                          | **Endpoint**                                           |
| :----------------------------------------------- | :--------------------------------------------------------------------- | :----------------------------------------------------- |
| <span className="http-method-post">POST</span>   | Initiate a single or recurring payment                                 | `baseURL/payments`                                     |
| <span className="http-method-post">POST</span>   | Cancel a future-dated payment                                          | `baseURL/payments/{externalReferenceNo}/cancel`        |
| <span className="http-method-na">N/A</span>      | Receive status updates on initiated payments                           | N/A                                                    |
| <span className="http-method-na">N/A</span>      | Receive recurring payment schedules from the payments core             | N/A                                                    |
| <span className="http-method-na">N/A</span>      | Receive off-channel (FPS and internal) payments from the payments core | N/A                                                    |
| <span className="http-method-na">N/A</span>      | Receive future-dated payments from the payments core                   | N/A                                                    |
| <span className="http-method-post">POST</span>   | Fetch bank holiday calendar information                                | `baseURL/bank-payment-calendar/search`                 |
| <span className="http-method-post">POST</span>   | Fetch bank name and address details                                    | `baseURL/payments/fetch-bank-details`                  |
| <span className="http-method-post">POST</span>   | Retrieve fees applicable for a payment                                 | `baseURL/payments/fetch-fees`                          |
| <span className="http-method-post">POST</span>   | Search direct debit mandates                                           | `baseURL/mandates/searches`                            |
| <span className="http-method-get">GET</span>     | Retrieve direct debit by mandate ID                                    | `baseURL/mandates/{directDebitMandateId}`              |
| <span className="http-method-patch">PATCH</span> | Terminate direct debit by mandate ID                                   | `baseURL/mandates/{directDebitMandateId}`              |
| <span className="http-method-get">GET</span>     | Retrieve exchange rate applicable for a payment                        | `baseURL/parties/{{partyId}}/currency-exchanges/rates` |
| <span className="http-method-post">POST</span>   | Create payees                                                          | `baseURL/payments/payee`                               |
| <span className="http-method-patch">PATCH</span> | Delete or update existing payees                                       | `baseURL/payments/payee`                               |

The OBPM Connector supports the following operations from the Grand Central Unified API v2:

| **Method**                                     | **Operation**                           | **Endpoint**                                    |
| :--------------------------------------------- | :-------------------------------------- | :---------------------------------------------- |
| <span className="http-method-post">POST</span> | Initiate a single or recurring payment  | `baseURL/payments`                              |
| <span className="http-method-post">POST</span> | Cancel a future-dated payment           | `baseURL/payments/{externalReferenceNo}/cancel` |
| <span className="http-method-post">POST</span> | Fetch bank holiday calendar information | `baseURL/bank-payment-calendar/search`          |
| <span className="http-method-post">POST</span> | Search bank name and address details    | `baseURL/payments/bank-directory`               |
| <span className="http-method-post">POST</span> | Retrieve fees applicable for a payment  | `baseURL/payments/fetch-fees`                   |

For Unified API v2, `fetchFees` returns fee `amount` and `currency` in the customer's debit-account currency. That amount is what the bank actually debits, not the OBPM internal pricing currency.

<Info>
  To receive status updates on initiated payments, recurring payment schedules, future-dated payments, and off-channel payments from the payments core, the OBPM payment inbound Connector listens to dedicated JMS queues. For more information, see [Get started](/connectors/payments/obpm/get-started). The payee contact sync feature validates the incoming JSON payload against the unified spec schema, routes domestic and international payees based on `obpm.contact.sync.domesticCountryCode`, and performs XSLT transformation to convert the request into the XML format expected by OBPM.
</Info>

<Info>
  For more information about the Grand Central Unified API endpoints that support these features, see [Unified APIs](/architecture#unified-apis-and-bian). For a complete list of Grand Central error codes and vendor mappings, see [Error codes](/connectors/reference/error-codes).
</Info>