> ## 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, operations, events, and error mapping for the Alacriti connectors.

The Alacriti integration bridges Grand Central and the Alacriti payment platform for Fedwire, FedNow, and Real-Time Payments (RTP). The payment connector is outbound: it transforms Grand Central 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 setup steps, see [Get started](/connectors/payments/alacriti/get-started).

For batch (mass) payments, see the [Alacriti Batch Connector reference](/connectors/payments/alacriti-batch/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 set 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 Grand Central Unified API across the Fedwire, FedNow, and RTP rails. For the operation-to-endpoint tables, see [Overview](/connectors/payments/alacriti/overview). For the full contract, see the [unified API specifications](/connectors/reference/unified-api-specifications).

## 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 Grand Central status codes using the shared `transform-alacriti-error-details.json` template. For the full list, see [Error codes](/connectors/reference/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.
