> ## 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 Temenos Payments Hub payment outbound and inbound connectors for payment initiation, management, bank directory lookup, and status updates.

The **Grand Central Temenos Payments Hub Connector** enables payment routing, processing, and enrichment across domestic and international payment schemes by integrating Grand Central with **Temenos Payments Hub**.

The connector family includes:

* **Temenos Payments Hub payment outbound Connector:** Payment initiation (single and recurring), payment validation, and fee retrieval. Also handles bank directory lookup (BIC, IBAN, and National Clearing Code), payment modification, cancellation (single and recurring), and other outbound payment processing.
* **Temenos Payments Hub payment inbound Connector:** Payment status updates and payment lifecycle events from Temenos Payments Hub through event-driven integration.
* **Temenos Payments Hub foreign exchange Connector:** Currency exchange rate retrieval for supported currency pairs.

**Versions supported:** R25

### Use cases supported

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

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

  <Card title="Validate payment" icon="clipboard-check">
    Validate a payment before initiation to reduce payment failures.
  </Card>

  <Card title="Ancillary features" icon="layer-group">
    Retrieve bank details, validate IBANs, fetch payment fees, and fetch FX rates.
  </Card>
</CardGroup>

### Supported Grand Central endpoints

The Temenos Payments Hub Connector supports the following operations from the Grand Central Unified API:

| **Method**                                     | **Operation**                                   | **Endpoint**                                         |
| :--------------------------------------------- | :---------------------------------------------- | :--------------------------------------------------- |
| <span className="http-method-post">POST</span> | Initiate a single or recurring payment          | `baseURL/payments`                                   |
| <span className="http-method-put">PUT</span>   | Modify a single future-dated payment            | `baseURL/payments/{externalReferenceNo}`             |
| <span className="http-method-post">POST</span> | Cancel a single or recurring 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-post">POST</span> | Fetch 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`                        |
| <span className="http-method-post">POST</span> | Validate a payment before initiation            | `baseURL/payments/validations`                       |
| <span className="http-method-post">POST</span> | Retrieve exchange rate applicable for a payment | `baseURL/parties/{partyId}/currency-exchanges/rates` |

<Info>
  To receive status updates on initiated payments, the Temenos Payments Hub payment inbound Connector listens to a dedicated Advanced Message Queuing Protocol (AMQP) queue. For more information, see [Get started](/connectors/payments/temenos-payments-hub/get-started). Use `cancellationType=COMPLETE_SCHEDULE` on `POST /payments/{externalReferenceNo}/cancel` to cancel a recurring payment schedule. Payment validation and fee retrieval both call the Temenos `paymentOrders` endpoint with `validate_only=true`; the connector doesn't use a separate validate or fees URI property.
</Info>

<Info>
  For connector configuration properties, see [Reference](/connectors/payments/temenos-payments-hub/reference). 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>
