The PSI agent is a real-time processing agent designed to support the Payment Server Interface provided by the Comverse Realtime Billing System. The functionality exposed by these services are mapped to the type system. The agent thereby emits and accepts a set of UDRs that represent the requests that can be made and their corresponding responses and acknowledgements.

Example of Charge Flow

Request/Response Mapping

The PSI agent contains a number of different UDRs. The UDRs in turn contain a set of fields corresponding to the fields required by the PSI application. The UDRs also contain a few internal fields that can be used by the workflow logic.

PSI Related UDR Types

In the UDR Internal Format Browser a detailed view of the available fields is displayed. To open the browser, double click or right click on the Analysis Agent and select Configuration.... You then right click in the editing area and select the option UDR Assistance....

UDR Internal Format Browser showing a UDR with fields

The following requests and responses are provided by the agent and shown in the psi folder.

Note

Not all of the PSI messages are supported, just those included in the UDRs below.

ApplyTariffRequest

The ApplyTariffRequest UDR sends the parameters to the PSI agent to charge a subscriber using the RTB tariff.

Field	Description
`bearerCapability (string)`	Refer to 'Bearer Capability' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifications.
`discount (string)`	Refer to 'Discount' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifications.
`originatingCallerId (string)`	Refer to 'Originating Caller ID' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifica tions.
`originatingSubscriberMSCAddress (string)`	Refer to 'Originating Subscriber MSC Address' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifications.
`subscriberType (int)`	Refer to 'Subscriber Type' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifications.
`terminatingCallerId (string)`	Refer to 'Terminating Caller ID' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifications.
`terminatingSubscriberMSCAddress (string)`	Refer to 'Terminating Subscriber MSC Address' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Request specifications.

ApplyTariffResponse

This UDR send the response message from the PSI agent.

Field	Description
`statusID (int)`	Refer to 'Status ID' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Response specifications.
`transactionID (bytearray)`	Refer to 'Transaction ID' in the Comverse proprietary protocol for Payment Server Interface for the Apply Tariff Response specifications.

PSICycleUDR

This UDR contains all the relevant UDRs for the entire message cycle between a SLU and the PSI agent, including errors and contexts. This is the only UDR that the PSI agent accepts and emits.

Field	Description
`ackUDR (PSISessionAckUDR)`	Refer to the section below, TransactionIdAcknowledge.
`associatedNumber (long)`	A value generated by the PSI Agent to uniquely identify a request.
`context (any)`	This is an internal working field that can be used in the workflow configuration to keep track of and use internal workflow information related to the request, when processing the answer.
`errors (list<string>)`	This list contains the errors sent from the PSI agent.
`hasErrors (boolean)`	If there are errors, this is set to `true`. The errors are listed in `errors` `(list<string>)`.
`reqUDR (PSISessionReqUDR)`	Refer to the section above, ApplyTariffRequest.
`respUDR (PSISessionRespUDR)`	Refer to the section above, ApplyTariffResponse.
`SLUIndex (int)`	This field indicates the specific SLU to which the session is bound.

TransactionIdAcknowledge

This UDR acknowledges the receipt of the response message sent from the PSI agent.

Field	Description
`statusID (int)`	Refer to the 'Status ID' in the Comverse proprietary protocol for Payment Server Interface, in the Apply Tariff section for the Transaction ID Acknowledgement specifications.

Error Management

The agent will, to the extent possible, manage errors without aborting the workflow. Errors related to the communication between the agent and the PSI will be sent to the System Log and from the PSI agent via the cycleUDR (see errors (list<string>) and hasErrors (boolean) above).

Next:

9.58.2 PSI Agent Configuration

MediationZone Documentation 8.2

9.59.1 PSI Agent Overview