Reference

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.

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.

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

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.

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.

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

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.

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. For the full contract, see the 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.

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.

Overview

Grand Central connectors

Release notes

Configuration properties

gc-temenos-payment-connector

gc-temenos-foreign-exchange-connector

gc-temenos-payment-inbound-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​gc-temenos-payment-connector

​gc-temenos-foreign-exchange-connector

​gc-temenos-payment-inbound-connector

​SOPS secrets

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

gc-temenos-payment-connector

gc-temenos-foreign-exchange-connector

gc-temenos-payment-inbound-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies