Implementation Guide for Oracle Self-Service E-Billing > Customizing the Payment Consolidator Integration Module >

Customizing the Bill Detail URL


The PCBillSummary job generates a URL that links to the bill detail. This link is provided to consumer users after logging in to the payment consolidator's site and viewing the statement summary or when viewing the bill summary PDF attachment. The user must log into Oracle Self-Service E-Billing to view the bill detail. The default bill detail URL is

https://hostname:ebillingAppPort/ebilling/login.action?redirectTo=statementSummary&statementPeriodStart=XXX

You can:

  • Customize the entire bill detail URL.
  • Let users view the bill detail without logging into Oracle Self-Service E-Billing.
  • Change the statement start period.

This task is step in Process of Implementing a Payment Consolidator

To customize the entire bill detail URL

  • To change the entire URL, implement the com.edocs.common.api.pc.ICartridgePlugin plug-in for the bill summary file. In the method preProcessDetailRecord(IDetailRecord record), invoke the method IBillSummaryRecord.setBillURL() to compose and overwrite the URL.

    CAUTION:  The following portion of the URL is configured when setting up a biller in the Command Center. Do not edit this section directly: https://hostname:ebillingAppPort/ebilling/login.action?redirectTo=statementSummary.

To let customers view the bill detail without logging in to Oracle Self-Service E-Billing

  • Use the two flexible fields, token1 and token2, provided with the bill summary record. These fields are the unique IDs for each bill summary and are stored in the EDX_PC_BILLSUMMARY_LOG file for later user authentication.

    The fields can be accessed using com.edocs.common.api.pc.IBillSummaryRecord. You can set it at the implemention of com.edocs.common.api.pc.ICartridgePlugin.preProcessDetailRecord(IDetailRecord record). The field values are null by default.

To customize the statement start period

  1. Open the paymentConsolidator.xma.xml file found in the EDX_HOME\xma\config\modules\paymentConsolidator directory (or the EDX_HOME/xma/config/modules/paymentConsolidator directory in Windows).
  2. Edit the XML in the billSummaryCartridgeImp bean section for the statementPeriodParamName property.
Implementation Guide for Oracle Self-Service E-Billing Copyright © 2014, Oracle and/or its affiliates. All rights reserved. Legal Notices.