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:

  1. IP address
  2. Port
  3. 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
  • 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, , , ,6000


Tenant-Level Configurations

  • postilionServiceName (required)
    • Example: postilionServiceName=TEST_Postilion_EFTCorp_ZA_Xneelo
  • cardManagementSystem (required for issuing)
    • Example: cardManagementSystem=Postilion
  • isPostilionCardManagementSystem (required)
    • Example: isPostilionCardManagementSystem=true
  • hsmServiceName (required for issuing)
    • Example: hsmServiceName=TEST_HSM_EFTCorp_ZW_Netone
  • 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>
  • postilionUpdateNotificationProcessor (optional) – processor for notifications from Postilion about card events.
    • Resolution order:
      1. postilionUpdateNotificationProcessor.<program name in lowercase> (tenant)
      2. postilionUpdateNotificationProcessor (tenant)
      3. postilionUpdateNotificationProcessor.<institution id> (global)
      4. postilionUpdateNotificationProcessor (global default)

Global Property Configurations

Default postbridge.config settings (can be overridden at tenant level):

NameDescription
institutionIdICA number – for issuing
issuerNr1 – for issuing
cardAcceptorTerminalId00000008 – for acquiring
cardAcceptorId120000000000001 – for acquiring
cardAcceptorNameLocationUKHESHE RESTFUL PRETORIA ZA – for acquiring
posDataCode060000065000017 – for acquiring