Reference

The Alacriti integration bridges Banking OS and the Alacriti payment platform for Fedwire, FedNow, and Real-Time Payments (RTP). The payment connector is outbound: it transforms Banking OS Unified API payloads into rail-specific instructions. The payment inbound connector receives asynchronous status webhooks from Alacriti and publishes events to the Sync Hub ASB producer. For the environment details you send to Backbase, see Get started. For batch (mass) payments, see the Alacriti Batch Connector reference.

Connector	Property file	Purpose
`gc-alacriti-payment-connector`	`payments-v0.values.yaml`	Outbound payment initiation, modification, cancellation, fee retrieval, and bank details lookup
`gc-alacriti-payment-inbound-connector`	`inbound-payments-v0.values.yaml`	Inbound payment status updates from Alacriti webhooks

Configuration properties

Values to obtain from Alacriti

Obtain the following values from Alacriti and send them to your Backbase support team. Backbase sets them in payments-v0.values.yaml. These values are environment-specific, so they have no default.

Property	Description
`alacriti.baseUrl`	Target API endpoint for the Alacriti gateway.
`alacriti.client_key`	Unique organizational identifier assigned by Alacriti.

gc-alacriti-payment-connector

Set these properties in payments-v0.values.yaml. This connector sends outbound requests to Alacriti.

Property	Description	Default
`alacriti.client_requestor_reference`	Mandatory. Internal identifier used for audit logging.	N/A (environment-specific)
`alacriti.product`	Product that indicates the supported transfer type, for example `business_transfers`.	N/A (environment-specific)
`alacriti.payment_channel`	Payment channel, for example `business_banking` or `retail_banking`.	N/A (environment-specific)
`alacriti.requestor_type`	Who requests the payment, for example `party`.	N/A (environment-specific)
`alacriti.access_channel`	Access channel used to split a main organization into sub-organizations, for example `backbase_business`.	N/A (environment-specific)
`routing.number`	Routing number used for Alacriti requests.	N/A (environment-specific)
`api.simple.transfer.url`	API path for a simple transfer.	`/fasterpayments/v1/transfer/simpletransfer`
`api.update.transfer.url`	API path to update a transfer.	`/fasterpayments/v1/transfer/updatetransfer`
`api.cancel.payment.url`	API path to cancel a payment.	`/fasterpayments/v1/cancel/cancelpayment`
`api.get.recurring.transfer.url`	API path to retrieve a recurring transfer.	`/fasterpayments/v1/transfer/getrecurringtransfer`
`api.delete.recurring.transfer.url`	API path to delete a recurring transfer.	`/fasterpayments/v1/transfer/deleterecurringtransfer`
`api.prepare.transfer.url`	API path to prepare a retail banking transfer.	`/fasterpayments/v1/retailbanking/transfer/preparetransfer`
`api.fetch.fee.url`	API path to fetch fees.	`/fasterpayments/v1/fetchfee`
`api.recurring.transfer.url`	API path for a recurring transfer.	`/fasterpayments/v1/transfer/recurringtransfer`
`api.fetch.bank.details.url`	API path to fetch bank details.	`/fasterpayments/v1/route/bankdetails`
`errorTemplate`	Error mapping template file used to translate Alacriti errors.	`transform-alacriti-error-details.json`
`connectionsPerRoute`	Maximum HTTP connections per route.	`200`
`http.client.connect.timeout`	HTTP connect timeout, in milliseconds.	`5000`
`http.client.request.timeout`	HTTP request timeout, in milliseconds.	`10000`
`http.client.socket.timeout`	HTTP socket timeout, in milliseconds.	`10000`
`http.client.response.timeout`	HTTP response timeout, in milliseconds.	`15000`
`retryFlag`	Enable automatic request retries on connection failure.	`true`
`redelivery.maximumRetries`	Maximum number of redelivery attempts.	`3`
`redelivery.delay`	Initial delay between redelivery attempts, in milliseconds.	`200`
`redelivery.backOffMultiplier`	Backoff multiplier for redelivery attempts.	`2`

gc-alacriti-payment-inbound-connector

Set these properties in inbound-payments-v0.values.yaml. This connector receives Alacriti status webhooks and publishes events to the Sync Hub ASB producer.

Property	Description	Default
`asb.producer.apiUri`	Callback URI of the Sync Hub ASB producer.	N/A (environment-specific)
`asb.event.topic`	ASB topic for payment status events.	N/A (environment-specific)
`asb.event.type`	ASB event type for payment status events.	N/A (environment-specific)
`asb.event.source`	ASB source for payment status events.	N/A (environment-specific)
`asb.event.version`	ASB schema version for payment status events.	N/A (environment-specific)
`connectionsPerRoute`	Maximum HTTP connections per route.	`200`
`http.client.connect.timeout`	HTTP connect timeout, in milliseconds.	`5000`
`http.client.request.timeout`	HTTP request timeout, in milliseconds.	`10000`
`http.client.socket.timeout`	HTTP socket timeout, in milliseconds.	`5000`
`retry.statuses`	HTTP status codes that trigger a retry.	`429,500,502,503,504`
`retryFlag`	Enable automatic request retries on connection failure.	`true`
`redelivery.maximumRetries`	Maximum number of redelivery attempts.	`3`
`redelivery.delay`	Initial delay between redelivery attempts, in milliseconds.	`200`
`redelivery.backOffMultiplier`	Backoff multiplier for redelivery attempts.	`2`

Supported operations

The Alacriti Connector exposes the Banking OS Unified API across the Fedwire, FedNow, and RTP rails. For the operation-to-endpoint tables, see Overview. For the full contract, see the API playground.

Events

The payment inbound connector publishes the following event to the Sync Hub ASB producer.

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

The payment inbound connector consumes status notifications from the following source.

Source	Configuration
Alacriti status webhook	Registered callback URL, delivered to `POST /webhooks/statusupdate`

The payment connector is synchronous and doesn’t publish or consume events.

Error mapping

The connector maps Alacriti error codes to Banking OS status codes using the shared transform-alacriti-error-details.json template. For the full list, see Error codes.

Dependencies

Alacriti payment platform API (outbound), reachable at alacriti.baseUrl.
Alacriti status webhooks (inbound), delivered to the registered callback URL.
Sync Hub ASB producer, which receives the published payment status events.

Get started

Core banking

Payments

Card management

KYC and KYB

Open Banking

CRM

Fraud detection

Financial data aggregation

Configuration properties

Values to obtain from Alacriti

gc-alacriti-payment-connector

gc-alacriti-payment-inbound-connector

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​Values to obtain from Alacriti

​gc-alacriti-payment-connector

​gc-alacriti-payment-inbound-connector

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

Values to obtain from Alacriti

gc-alacriti-payment-connector

gc-alacriti-payment-inbound-connector

Supported operations

Events

Error mapping

Dependencies