Postilion Management
The Postilion suite by ACI Worldwide provides capabilities across payment switching, transaction processing, and card issuing. Key components include:
- Realtime payment switching
- Card issuing
- ATM and POS driving
- Payment acquiring
Eclipse integrates tightly with Postilion to offer a unified platform with hosted services such as:
- Instant Card Issuing as a Service
- Acquiring and Payment as a Service
- SME in-a-box Services, including Terminal Management
- Rapid acceleration of Banking-as-a-Service deployments
There are various deployment options including:
- Eclipse and Postilion offered as hosted services
- Eclipse integrated into an existing Postilion instance
This section outlines the prerequisites for connecting an Eclipse instance to Postilion.
Pre-requisites
You need the following Postilion host details:
- IP address
- Port
- Number of permitted connections
Service Discovery Configuration
Add the following to the global property sd.external.services for service discovery:
- Service Type: Always
TCPSOCKET - Service Name: Format:
PROD/TEST_<Destination System Name>_<Company>_<ISO 2 Country Code>_<Data Center ID>- Example:
TEST_Postilion_EFTCorp_ZA_Xneelo
- Example:
- Handler:
com.ukheshe.eclipse.services.postbridge.transport.PostbridgeTcpsocketHandler - Connections: As per Postilion host details (default: 1)
- IP and Port of the Postilion host
Example sd.external.services entry:
TCPSOCKET,TEST_Postilion_EFTCorp_ZA_Xneelo,41.87.208.234:7802:com.ukheshe.eclipse.services.postbridge.transport.PostbridgeTcpsocketHandler:1, , , ,6000Tenant-Level Configurations
- postilionServiceName (required)
- Example:
postilionServiceName=TEST_Postilion_EFTCorp_ZA_Xneelo
- Example:
- cardManagementSystem (required for issuing)
- Example:
cardManagementSystem=Postilion
- Example:
- isPostilionCardManagementSystem (required)
- Example:
isPostilionCardManagementSystem=true
- Example:
- hsmServiceName (required for issuing)
- Example:
hsmServiceName=TEST_HSM_EFTCorp_ZW_Netone
- Example:
- postbridge.config (optional) – custom Postbridge configuration for the tenant - see global property configurations below for parameters that must be set for issuing and acquiring
- postilionOutboundProcessor (optional) – processor to link cards, update cards, and read card details.
- Can also be set at program level:
OutboundPnPayMsgProcessor.<program name in lowercase>
- Can also be set at program level:
- postilionUpdateNotificationProcessor (optional) – processor for notifications from Postilion about card events.
- Resolution order:
postilionUpdateNotificationProcessor.<program name in lowercase>(tenant)postilionUpdateNotificationProcessor(tenant)postilionUpdateNotificationProcessor.<institution id>(global)postilionUpdateNotificationProcessor(global default)
- Resolution order:
Global Property Configurations
Default postbridge.config settings (can be overridden at tenant level):
| Name | Description |
|---|---|
| institutionId | ICA number – for issuing |
| issuerNr | 1 – for issuing |
| cardAcceptorTerminalId | 00000008 – for acquiring |
| cardAcceptorId | 120000000000001 – for acquiring |
| cardAcceptorNameLocation | UKHESHE RESTFUL PRETORIA ZA – for acquiring |
| posDataCode | 060000065000017 – for acquiring |
Updated 20 days ago
