> ## 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.

# Reference

> Configuration properties for the Temenos Payments Hub outbound and inbound connectors

The Temenos Payments Hub integration submits payment orders to Temenos and receives payment status updates, through a REST outbound connector and an AMQP inbound connector. For setup steps, see [Get started](/connectors/payments/temenos-payments-hub/get-started).

## Configuration properties

The outbound connector passes the `Authorization: Bearer` header from the incoming Grand Central request through to Temenos unchanged. Configure OAuth 2.0 token acquisition at the Azure API Management (APIM) layer or your calling channel before invoking the connector. The AMQP username and password for payment status events are stored in a SOPS secret, described in [SOPS secrets](#sops-secrets).

### gc-temenos-payment-connector

Configure outbound connections in `v2/payment-v2.values.yaml`.

| Property                                            | Description                                                                                                                                                         | Environmental Key  |
| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------- |
| `temenos.baseUrl`                                   | Target API endpoint for the Temenos IRF Provider Container gateway.                                                                                                 | `temenos-base-url` |
| `temenos.searchBankDirectoryByBICApiUri`            | API path for bank directory lookup by BIC.                                                                                                                          | N/A                |
| `temenos.searchBankDirectoryByIBANApiUri`           | API path for bank directory lookup by IBAN.                                                                                                                         | N/A                |
| `temenos.searchBankDirectoryByBankBranchCodeApiUri` | API path for bank directory lookup by National Clearing Code.                                                                                                       | N/A                |
| `temenos.ibanValidationApiUri`                      | API path template for IBAN validation. Must include the `{IBAN}` placeholder.                                                                                       | N/A                |
| `temenos.paymentOrders.apiUri`                      | API path for single payment initiation. The connector also uses this path for payment validation and fee retrieval when you pass `validate_only=true` in the route. | N/A                |
| `temenos.paymentOrders.update.apiUri`               | API path template for payment modification. Must include the `{paymentOrderId}` placeholder.                                                                        | N/A                |
| `temenos.paymentOrders.cancel.apiUri`               | API path template for single payment cancellation. Must include the `{paymentOrderId}` placeholder.                                                                 | N/A                |
| `temenos.standingOrders.apiUri`                     | API path template for recurring payment initiation. Must include the `{standingOrderId}` placeholder.                                                               | N/A                |
| `temenos.standingOrders.cancel.apiUri`              | API path template for recurring payment cancellation. Must include the `{standingOrderId}` placeholder.                                                             | N/A                |
| `temenos.standingOrder.suppressFT`                  | Standing-order mode switch sent as `body.suppressFT`. Defaults to `PAYMENT` for payment order mode.                                                                 | N/A                |
| `temenos.disablePagination`                         | Set to `true` to suppress Temenos pagination metadata on single-record bank directory responses.                                                                    | N/A                |
| `retryFlag`                                         | Set to `true` to enable automatic request retries on connection failure.                                                                                            | N/A                |
| `maximumRedeliveries`                               | Maximum number of retry attempts when `retryFlag` is enabled.                                                                                                       | N/A                |
| `redeliveryDelay`                                   | Initial delay in milliseconds between retry attempts.                                                                                                               | N/A                |
| `retryStatuses`                                     | Comma-separated HTTP status codes that trigger a retry, such as `429,502,503`.                                                                                      | N/A                |
| `backOffMultiplier`                                 | Exponential backoff multiplier applied between retry attempts.                                                                                                      | N/A                |
| `http.client.proxy.activate`                        | Set to `true` when outbound Temenos calls must route through the corporate HTTP proxy.                                                                              | N/A                |

<Info>
  To route a bank directory request to IBAN validation instead of a standard lookup, set `bankDirectorySource=IBAN-DIRECTORY` with `identificationType=IBAN` on `POST /payments/bank-directory`. The connector resolves this combination to the `temenos.ibanValidationApiUri` endpoint.
</Info>

<Info>
  The `externalReferenceNo` path parameter on modify and cancel operations maps to the Temenos `{paymentOrderId}` for single payments or `{standingOrderId}` for recurring cancellations. Use the `paymentInstruction.instructionId` returned from the initiation response, not the request-body instruction reference. For recurring cancellation, send `cancellationType=COMPLETE_SCHEDULE` on `POST /payments/{externalReferenceNo}/cancel`.
</Info>

### gc-temenos-foreign-exchange-connector

Configure outbound foreign exchange connections in `foreign-exchange-v1.values.yaml`.

| Property                             | Description                                                                                                                                                                            | Environmental Key  |
| :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- |
| `temenos.baseUrl`                    | Target API endpoint for the Temenos IRF Provider Container gateway.                                                                                                                    | `temenos-base-url` |
| `temenos.forex.exchangeRates.apiUri` | API path template for exchange rate lookup. Must include `{buyCurrency}`, `{sellCurrency}`, `{transactionAmount}`, and `{transactionAmountType}` placeholders.                         | N/A                |
| `temenos.forex.amount`               | Default transaction amount that the connector substitutes into the exchange-rates path when the request doesn't override it.                                                           | N/A                |
| `temenos.forex.type`                 | Default transaction amount type that the connector substitutes into the exchange-rates path, such as `BUY`.                                                                            | N/A                |
| `temenos.forex.currencyMarket`       | Currency market identifier sent as the `currencyMarket` query parameter.                                                                                                               | N/A                |
| `retryFlag`                          | Set to `true` to enable automatic request retries on connection failure.                                                                                                               | N/A                |
| `maximumRedeliveries`                | Maximum number of retry attempts when `retryFlag` is enabled.                                                                                                                          | N/A                |
| `redeliveryDelay`                    | Initial delay in milliseconds between retry attempts.                                                                                                                                  | N/A                |
| `retryStatuses`                      | Comma-separated HTTP status codes that trigger a retry, such as `429,502,503`.                                                                                                         | N/A                |
| `backOffMultiplier`                  | Exponential backoff multiplier applied between retry attempts.                                                                                                                         | N/A                |
| `http.client.proxy.activate`         | Set to `true` when outbound Temenos calls must route through the corporate HTTP proxy. This property comes from the connector SDK rather than the foreign exchange connector defaults. | N/A                |

<Info>
  The foreign exchange connector accepts one currency pair per request. Grand Central validates `rateType` on the inbound request but the connector doesn't forward it to Temenos.
</Info>

### gc-temenos-payment-inbound-connector

Configure inbound connections in `payment-inbound-v1.values.yaml`.

| Property                           | Description                                                                                                             | Environmental Key         |
| :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------- | :------------------------ |
| `source.provider`                  | Inbound listener provider. Set to `amqp` for Temenos AMQP 1.0 integration.                                              | N/A                       |
| `source.queue.route.mapping`       | Maps the inbound AMQP queue to its Camel route, for example `R25PaymentEvents>direct:updatePaymentStatus`.              | `temenos-amqp-queue-name` |
| `source.concurrent.threads`        | Number of concurrent consumer threads for the inbound queue.                                                            | N/A                       |
| `inbound.listener.transacted`      | Set to `true` to tie message acknowledgement to processing outcome. Transient failures roll back for broker redelivery. | N/A                       |
| `quarkus.qpid-jms.url`             | AMQP connection URL to the Temenos broker.                                                                              | `temenos-amqp-url`        |
| `asb.producer.apiUri`              | Callback URI of the Sync Hub ASB producer that receives outgoing events.                                                | N/A                       |
| `asb.event.topic`                  | ASB topic for payment status update events, such as `payment-status`.                                                   | N/A                       |
| `asb.payment.status.event.type`    | ASB event type for payment status updates, for example `com.backbase.payment.event.spec.v1.PaymentOrderStatusEvent`.    | N/A                       |
| `asb.payment.status.event.source`  | ASB source for payment status update events, for example `com.backbase.payments`.                                       | N/A                       |
| `asb.payment.status.event.version` | ASB schema version for payment status update events, for example `1.0.0`.                                               | N/A                       |
| `retryFlag`                        | Set to `true` to enable retries on ASB connection failures.                                                             | N/A                       |
| `redelivery.maximumRetries`        | Maximum in-route retry attempts when `retryFlag` is enabled. Set to `0` when the broker owns redelivery.                | N/A                       |

## SOPS secrets

The connector reads the AMQP broker credentials from the `temenos-amqp-jms-credentials-secret` SOPS secret.

| Variable                    | Description           | Environmental Key       |
| :-------------------------- | :-------------------- | :---------------------- |
| `quarkus.qpid-jms.username` | AMQP broker username. | `temenos-amqp-username` |
| `quarkus.qpid-jms.password` | AMQP broker password. | `temenos-amqp-password` |

## Supported operations

The Temenos Payments Hub Connector exposes the Grand Central Unified API for payment initiation, modification, cancellation, and bank directory lookups. For the operation-to-endpoint tables, see [Overview](/connectors/payments/temenos-payments-hub/overview). For the full contract, see the [unified API specifications](/connectors/reference/unified-api-specifications).

## Events

The payment inbound connector consumes payment status events from the Temenos AMQP broker and publishes payment status update events to the Sync Hub ASB producer.

| Event                 | Type property                   | Source property                   | Version property                   | Topic property    |
| :-------------------- | :------------------------------ | :-------------------------------- | :--------------------------------- | :---------------- |
| Payment status update | `asb.payment.status.event.type` | `asb.payment.status.event.source` | `asb.payment.status.event.version` | `asb.event.topic` |

The payment inbound connector consumes messages from the following source.

| Source                            | Route mapping property       |
| :-------------------------------- | :--------------------------- |
| Temenos payment events AMQP queue | `source.queue.route.mapping` |

The payment and foreign exchange connectors are synchronous and don't publish or consume events.

## Error mapping

The connector maps Temenos error codes to Grand Central status codes. For the full list, see [Error codes](/connectors/reference/error-codes).

## Dependencies

* Temenos IRF Provider Container REST API (outbound), reachable at `temenos.baseUrl`.
* Temenos payment events AMQP broker (inbound), reachable at `quarkus.qpid-jms.url`.
* Sync Hub ASB producer, which receives the published payment status events.