10 Voucher Management
This chapter explains how to create and manage vouchers.
This chapter contains the following topics.
Voucher Manager Module
The Voucher Management screen allows you to configure vouchers. It contains these tabs:
Accessing the Voucher Manager screen
Follow these steps to open the Voucher Manager screen.
-
Select the Services menu from the SMS main screen.
Note: The services which are available under the Services menu depend on the components which have been installed, and the permissions of the user. The services displayed in this screen shot may not match the services you have available on your system.
-
Select Voucher Manager.
Result: You see the Voucher Manager screen.
Voucher Type
The Voucher Type tab allows you to add, modify, or delete voucher types.
The voucher type determines the tariff plan, the restriction control plan, and the value of the calls for which recharges (including vouchers) are valid.
For each voucher type, you can:
-
Define multiple balance types, see Multiple balance type
-
Define power charge scenarios, see Power charge scenarios
Voucher types define core details and restrictions for recharges such as vouchers and the balance increase part of credit transfers.
For more information about redeeming vouchers, see Vouchers Introduction. For more information about credit transfers, see "Transfer Management" in CCS User's Guide.
Multiple balance type
You can add more than one balance type to a voucher type. When a recharge or voucher is redeemed, all balance types associated with the voucher type are recharged. This can include both monetary balance types (such as general cash or promotional cash) and non-monetary balance types (such as free SMS or time). You can add more than one entry for the same balance type, with different details for each entry, including:
-
Unique expiry dates and extension policies
-
The period during which this balance type entry can be recharged
-
The product types for which this balance type entry can be recharged
Power charge scenarios
You can associate recharge scenarios to a balance type for a voucher type. The voucher type can then be redeemed in multiple ways depending on the scenario options available when it is redeemed. Scenarios can include both monetary balance types, such as general cash or promotional cash, and non-monetary balance types, such as free SMS or time. You can do one or more of the following:
-
Increment a balance
-
Extend the expiry date for the balance
Note: The scenarios functionality will only be available in the screens if it has been activated. For more information about activating scenarios, see CCS Technical Guide.
Voucher Type fields
The following table describes the function of each field.
Field | Description |
---|---|
Name |
A unique name for the voucher type. Note: If this voucher type uses scenarios and you will be sending real-time wallet notifications for recharges, this field must be reflected in the name of the template you use for the notification. For more information about the required format, see CCS Technical Guide. |
CDR Description |
The description to use for EDRs which are produced by vouchers with this voucher type. Tip: You can use a maximum of 100 characters. |
Description | A brief description of the voucher type. |
Pre-use Expiry Period |
The period (in days and hours) between this voucher being issued and when it will expire. Example: If a voucher has a pre-use expiry period of seven days, the holder of the voucher has seven days from the date of issue to begin using the voucher. If not used in seven days, the voucher expires and is no longer valid. |
Scenario |
The scenarios to associate with the balance type when the voucher is redeemed. Tip: You can add multiple scenarios to the same balance type by adding different scenario values. You can also edit/delete the default scenario. Note: This panel will only be visible on the tab if the scenarios functionality has been activated. For more information about activating scenarios see CCS Technical Guide. |
Multi-Balances |
The details of the changes vouchers with this type make to balance types when the voucher is redeemed. For more information about the fields in these records, see Balance type fields. Tip: You can add multiple balance types to the same voucher type and you can specify the product type for each balance type. You can include the same balance type more than once. |
Adding voucher types
Follow these steps to add a new voucher type.
-
In the Voucher Management screen, select the Service Provider from the drop down box.
-
From the Voucher Type tab, click New.
Result: You see the New Voucher Type screen.
-
Start to configure this record by entering data in the fields in the top left of this screen. For more information about the fields on this screen, see Voucher Type fields.
-
If the Scenario panel is visible in the screen, then add the scenarios to associate with the balance type when vouchers of this type are redeemed. For details, see Adding scenarios to a voucher type.
Tip: You can add multiple scenarios to the same balance type by adding different scenario values.
Note: The Scenario panel will only be visible in the screen if the Scenarios functionality has been activated on your system.
-
Add the balance types that this type of voucher recharges when it is redeemed. For details, see Adding balance types to a voucher type.
Tip: You can add multiple balance types to the same voucher type and you can specify the product type for each balance type. You can include the same balance type more than once.
-
Click Save.
Related topic
Editing voucher types
Follow these steps to edit an existing voucher type.
-
In the Voucher Management screen, select the Service Provider from the drop down box.
-
On the Voucher Type tab, select the record to edit.
-
Click Edit.
Result: You see the Edit Voucher Type screen. For information about voucher type fields, see Voucher Type fields.
-
Make the changes that you need to by editing the fields in this screen.
-
Add the scenarios to associate with the balance type when vouchers of this type are redeemed. For details, see Adding scenarios to a voucher type.
Tip: You can add multiple scenarios to the same balance type by adding different scenario values.
-
Add the balance types that this type of voucher recharges when it is redeemed. For details, see Adding balance types to a voucher type.
Tip: You can add multiple balance types to the same voucher type and you can specify the product type for each balance type. You can include the same balance type more than once.
-
Click Save.
Related topic
Deleting voucher types
Follow these steps to delete an existing voucher type.
-
In the Voucher Management screen, select the Service Provider from the drop down box.
-
In the table on the Voucher Type tab, select the record to delete.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK to delete the record from the database.
Result: The record is deleted and you see the Voucher Type prompt.
-
Click OK.
Adding scenarios to a voucher type
Follow these steps to add a scenario to the scenario list on the New or Edit Voucher Type screens.
-
In the Scenario area, click Add.
Result: The New Scenario window is displayed.
-
From the Scenario ID drop down list, select the scenario number to associate to the scenario.
-
In the Scenario Name field, enter a name for the scenario.
-
In the Recharge Classification field, enter a description for how the recharge will be made.
-
Click OK.
Result: You are returned to the New/Edit Voucher Type screen and the new scenario is added to the list of scenarios.
Related topic
Editing scenarios for a voucher type
Follow these steps to edit a scenario in the scenario list on the New, or Edit Voucher Type screen.
-
In the New or Edit Voucher Type screen, select the scenario to edit.
-
In the Scenario area, click Edit.
Result: The Edit Scenario screen is displayed.
-
Edit the details as required. See Adding scenarios to a voucher type for field details.
-
Click OK.
Related topic
Deleting scenarios for a voucher type
Follow these steps to delete a scenario in the scenario list on the New, or Edit Voucher Type screen.
-
In the New or the Edit Voucher Type screen, select the scenario to delete.
-
Click Delete.
Result: The record is deleted from the list of scenarios.
Related topic
Balance type fields
This table describes the function of each field.
Field | Description |
---|---|
Action |
Provides three actions:
|
New Bucket | Whether to create a new bucket for the balance type when the voucher is redeemed. |
Balance Type |
The balance type to recharge when vouchers of this type are redeemed. This field is populated by the records on the Balance Types tab. Note: Any valid balance type can be selected. This includes non cash balance types, such as time. |
Value | The amount to recharge the balances of the balance type selected in the Balance Type field. |
Expiry Policy |
How to apply the expiry period for this balance type when vouchers of this type are redeemed. Select:
The following fields exist when the
|
Balance Expiry Period |
The period between when the voucher is activated and when the balance expires. Depending on the selection in the expiry period type options, enter one of:
Example: If a voucher has an expiry period of 30 days, the holder of the voucher has 30 days from the date the voucher is first used to use the outstanding voucher balance. At the end of the expiry period any outstanding voucher balance expires. Note: Month expiry dates measured in calendar months. If a bucket is created on the 31st of the month, and the expiry will be on month which has 30 days or less, the expiry date is set for the 1st of the month after. For example, a two-month bucket created on the 31st of December will expire on the 1st of March. Tip: The |
Credit Available |
Select one of the following:
Note: You can only specify Credit Available for chargeable or cross balance types. |
Scenario |
The scenario which will apply this balance. Notes:
|
Allowed Product Types |
The product types which vouchers of this type can recharge for this balance type. Tip: An empty Allocated list means that the balance type can be recharged for all product types. |
Configuration Restriction |
Restricts the day, month and year that a balance starts and ends. Select the following:
|
Adding balance types to a voucher type
Follow these steps to add a balance type to the current voucher type.
Note: To add multiple balance types to the voucher type, repeat this process as required.
-
In the Multi-Balances area at the bottom of the New or the Edit Voucher Type screen, click New.
Result: You see the New Multi-Balance screen.
-
Start to configure this record by entering data in the fields in the top of this screen.
-
In the Allowed Product Types section select the Product Types for which the voucher can recharge this balance type. To:
-
Allocate a product type, select it in the Available list and click the '>>' button
-
Remove an allocated product type, select it in the Allocated list and click the '<<' button.
Tip: An empty Allocated list means that the balance type can be recharged for all product types.
-
-
Click Save.
Result: The balance type details are saved, and you return to the Voucher Type screen.
Related topic
Editing balance types for a voucher type
Follow these steps to edit an existing balance type for the current voucher type.
-
In the New or Edit Voucher Type screen, select the balance type record to edit from the Multi-Balances table.
-
Click Edit.
-
Edit the fields to reflect the changes you need to make.
-
If required, in the Allowed Product Types section select the Product Types for which the voucher can recharge this balance type. To:
-
Allocate a product type, select it in the Available list and click the '>>' button
-
Remove an allocated product type, select it in the Allocated list and click the '<<' button.
Tip: An empty Allocated list means that the balance type can be recharged for all product types.
-
-
Click Save.
Result: The modified balance type record is saved, and you return to the Voucher Type screen.
Related topic
Deleting balance types for a voucher type
Follow these steps to delete an existing balance type from a voucher type.
-
In the New or the Edit Voucher Type screen, select the balance type record to delete from the Multi-Balances table.
-
Click Delete.
Result: You see the Delete Multi-Balance prompt.
-
Click Apply to delete the record from the database.
Related topic
Voucher Batches
The Voucher Batches tab lets you search, display, create, and delete batches of vouchers for the selected customer.
You use the New Voucher Batch screen to create a simple voucher batch file, eliminating the need to generate the batch from the command line.
Tip: Configuration for the voucher tool used to create voucher batches is defined in eserv.config. For more information about eserv.config, see CCS Technical Guide.
Topics:
Voucher Batch fields
The following table describes the functions of Voucher Batch fields.
Field | Description |
---|---|
Batch Code |
The identifier which will be used to group the vouchers in this batch. This field can be used to group vouchers from several batches. Note: This field is not available:
|
Batch Id |
The batch ID for the voucher batch. This field is automatically populated when the vouchers are first generated. It cannot be changed and is only visible on the Voucher Batches tab. |
Domain |
The domain where the voucher batch was created. This field is only available on the New Voucher Batch screen. |
Batch Name | The unique name for the batch. It can be up to 50 characters long and is optional. |
Activation Date |
Activation date of the voucher batch. This field cannot be changed after the batch is activated. Note: This field is not available on the New Voucher Batch screen. |
Voucher Type |
The type of the vouchers in this batch. This field is populated by the Voucher Types tab. For more information, see Voucher Type. This field cannot be changed after the batch is generated. |
Expiry Date |
The expiry date of the vouchers in this batch. This field enables you to specify the voucher batch expiry date, which sets a batch to expire on a specific day and shows users that a batch is no longer active and not available for use. |
State |
Displays the state of the voucher batch. Available states are:
Note: This is different to the state of the individual vouchers within the batch. These states are available within the Voucher Batch Search screen but not in the New Voucher Batch screen. |
Description |
Reason for the voucher state change. Note: This field is only displayed in the New Voucher Batch screen, not in the Voucher Batch Search screen. |
Initial Voucher State |
The state new vouchers in a batch will be in when they are first generated. This field allows individual vouchers or ranges of vouchers in a voucher batch to be made Active as an additional security feature for service providers. In the New Voucher Batch screen a new batch
should normally be created with the Initial Voucher State set
to Active. This sets the individual voucher records in the
batch to Active in the If a new batch is created with the Initial Voucher State set to Created, then vouchers can only be redeemed when their state has been reset to Active in the Vouchers tab (for individual activation) or in the Voucher Ranges tab (for a range of vouchers). To enable vouchers, set both the batch state and the voucher state to Active. Note: This is different to the state of the voucher batch (which is automatically set to Created when the batch is first generated. This field is only displayed in the New Voucher Batch screen, not in the Voucher Batch Search screen. |
Voucher Number Length |
The number of digits in the voucher number. This is set by the authentication rule for this voucher batch and cannot be changed after the batch is generated. Note: This field is only displayed in the New Voucher Batch screen, not in the Voucher Batch Search screen. |
Start Voucher Number |
Displays the number of the first voucher in the batch and the starting point for the voucher number range. Note: The length of the voucher number must match the voucher number length defined for the authentication rule being used. You can use a voucher number range more than once for CB10 HRN encrypted vouchers with or without GPG selected. Vouchers are generated from unused voucher numbers from the range. This field cannot be changed after the batch is generated. |
End Voucher Number |
Displays the number of the last voucher in the batch and the ending point for the number range. The value must be greater than the start of range value and have a matching number of digits. Note: This field cannot be changed after the batch is generated. |
Start Serial Number |
Displays the serial number of the first voucher in the batch. Note: This field is automatically populated and cannot be changed after the batch is generated. It is not available on the New Voucher Batch screen. |
End Serial Number |
Displays the serial number of the last voucher in the batch. Note: This field is automatically populated and cannot be changed after the batch is generated. It is not available on the New Voucher Batch screen. |
Batch Size Original Count |
The number of vouchers in this batch. This can be equal to or less than the difference between the start voucher number and the end voucher number. Note: This field cannot be changed after the batch is generated. |
Authentication Rule |
Indicates which encryption scheme the voucher batch has been created with. This field cannot be changed after the batch is generated. This list is populated by records from the Security tab in the Service Management screen. For more information about the Security tab, see CCS User's Guide. |
GPG Public Key |
The GPG Public key to use to encrypt the voucher batch export file. The key must have been imported and verified on the SMS. If you do not want to use a GPG Public key, select the blank entry. Note: This field is only available for voucher batch files generated using an authentication rule based on DES PIN encryption or CB10 HRN encryption. This field is only available on the New Voucher Batch screen. For more information about GPG public keys, see GPG Public Keys. |
Pause Time |
The time in seconds to pause after loading each 100 vouchers for writing to the export file. Note: This field is only displayed in the New Voucher Batch screen, not in the Voucher Batch Search screen. |
Creation Date | The creation date of the batch. |
CDR Description | Description to use for this voucher batch in any EDRs that are created for vouchers from this batch. |
Remote Filename |
The name of the voucher batch export file to write the details of the generated vouchers to. Note: This field is only displayed in the New Voucher Batch screen, not in the Voucher Batch Search screen. |
Finding voucher batches
Follow these steps to search for an existing voucher batch.
-
In the Voucher Manager screen, choose the Service Provider from the drop down list.
-
On the Voucher Batches tab, enter the search strings you are using to find the required batch. Perform one of the following:
-
Enter the first few characters of the specified batch code in the Code field and click Search
-
Select the Voucher Batch state from the State drop down box and click Search
Note: There are three states:
-
Active
-
Created
-
Unavailable
Result: The Voucher Batches table will display the first 100 records matching the search criteria. Results include creation date.
-
-
If the required voucher batch is not displayed and more than 100 records were returned, enter a longer search string and click Search again.
Adding voucher batches
Follow these steps to add a new voucher batch.
Note: The values for the voucher number length and voucher PIN length are determined by the authentication rule selected and cannot be edited. The GPG Public Key Description field is for information only.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
From the Voucher Batches tab, click New.
Result: You see the New New Voucher Batch Screen.
-
Enter data in the fields to configure this record.
For more information about the fields on this screen, see Voucher Batch fields.
-
Click Save.
Result: The batch generation process is started and you see the Voucher Batch Generation prompt.
-
Click OK.
Result: You see the Voucher Batch Progress bar. The COMPLETE message is displayed in the bar once the batch has been successfully created.
-
Click 'x' to close the progress bar.
Related topic
Checking voucher batch status
Follow these steps to check the status of an existing voucher batch.
-
Read the ccsSmsORB output log. For more information about the ccsSmsORB, see CCS Technical Guide.
-
Check for any error messages from the actual voucher-creation process.
-
Go to the /IN/service_packages/CCS/voucher/export/ directory.
-
Check that the following file exists:
remote_filename .lst.print
Where:
remote_filename is the name entered in the Remote Filename field of the New Voucher Batch screen.
-
If the file exists, is larger than 0 bytes in size and contains full records, the voucher batch job has been created successfully.
If the file does not exist, is 0 bytes in size or only contains headers, the voucher batch job has failed. You will need to repeat the procedure in Adding voucher batches.
Editing voucher batches
Follow these steps to edit an existing Voucher Batch.
Note: The Voucher Batch, Edit Voucher Batch, and Vouchers tabs have a creation date read-only value which preserves the creation date when a batch is edited.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
On the Voucher Batches tab enter the search criteria for the required voucher batch in the search fields and click Search. For details on finding voucher batches, see Finding voucher batches.
-
In the table on the tab, select the record you want to edit and click Edit.
Result: You see the Edit Voucher Batch Screen.
-
Edit the fields with the changes to make.
You can update only the following fields:
-
CDR Description
-
Voucher Batch Status
Tip: For descriptions of voucher batches fields, see Voucher Batch fields.
-
-
Click Save.
Related topic
Deleting voucher batches
Follow these steps to delete an existing voucher batch.
-
In the Voucher Manager screen, select the service provider from the Service Provider list.
-
On the Voucher Batches tab enter the search criteria for the voucher batch to delete and click Search.
For more information about finding voucher batches, see Finding voucher batches.
-
In the table on the tab, select the record to delete.
Note: Selecting Delete on an active batch will calculate if the batch is stale. Only active batches that are stale and unavailable batches can be deleted.
-
The Delete Voucher Batch prompt displays. Confirm your desire to delete the voucher batch by clicking OK.
Result: The voucher batch is deleted.
Related topic
Vouchers
The Vouchers tab allows you to view details of a voucher, change its status, and set voucher expiry.
The Vouchers tab has the following subtabs:
-
Voucher
-
Batch
-
Subscriber
-
Info
-
History
Voucher
The Voucher subtab enables you to:
-
View details of a voucher
-
Change voucher status
-
Set voucher expiry
Voucher fields
The following table describes the Voucher subtab fields.
Field | Description |
---|---|
Voucher Number | The voucher number. |
Serial Number | The voucher serial number. |
Private Secret | Encrypted voucher HRN or PIN. |
Voucher Type | The type of the voucher in this batch. This field is populated by the Voucher Types tab. |
Voucher Created | The voucher creation date. |
Archive Date | The calculation date when archiving may take place. |
Voucher Status |
The status of the voucher. The available statuses are:
|
Voucher Expiry |
The expiry date of the voucher. This field enables you to set a voucher to expire on a specific day. If an expiry date is already set for a voucher, this field displays the date and time when the voucher expires. You can set the date by clearing the Remove check box. Note:This field is enabled only if the Remove check box is cleared. By default, the Remove check box is selected. |
Description | Additional information about the voucher state change or the voucher expiry date change. |
Last State Change User | User name of the user who last changed the voucher state. |
Changing voucher states
You can select a voucher owned by the selected service provider and set it to an 'active' or 'frozen' state.
In an 'active' voucher batch, if you set a voucher to the 'frozen' state, then the voucher can no longer be redeemed. If a voucher batch is in a 'created' or 'unavailable' state, then although you will be able to set a voucher within the batch to an 'active' state in this screen, you will not be able to redeem it. You may only redeem an active voucher if the voucher batch it belongs to is also in an 'Active' state.
Follow these steps to change the state of an existing voucher.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
In the Vouchers tab, enter one of the following:
-
Voucher number or HRN in the Voucher Number field
-
Voucher serial number in the Serial Number field
Click Search.
Tip: When searching on the voucher number, the number entered must be the length of the voucher number as defined for the authentication rule for this voucher.
Result: The Voucher subtab displays the details for the voucher searched for.
-
-
In the Voucher subtab, from the Voucher Status drop down box, select the status.
Available statuses are:
-
Active
-
Frozen
Note: If you want to be able to redeem the voucher, set the status to
Active
.If the voucher has been redeemed already:
-
This field is grayed out (indicating the value cannot be changed)
-
The status will be
Used
If the voucher has been deleted, this field is grayed out (indicating the value cannot be changed).
-
-
Click Save.
Decrypting voucher private secret
You can decrypt the private secret of a voucher to view its HRN.
Follow these steps to decrypt a voucher private secret.
- In the Voucher Manager screen, select the Service Provider from the drop down box.
- In the Vouchers tab, enter one of the following:
- Voucher number or HRN in the Voucher Number field
- Voucher serial number in the Serial Number field
Click Search.
Tip: When searching on the voucher number, the number entered must be the length of the voucher number as defined for the authentication rule for this voucher.
Result: The Voucher subtab displays the details for the voucher searched for.
- In the Voucher subtab, click Decrypt.
Result: The HRN field displays the decrypted voucher private secret.
The Decrypt button and the HRN field are displayed only if:
- The user has an allocated template with the access permission for private secret decryption.
- The Authentication Rule associated with the voucher supports private secret decryption.
Setting voucher expiry
You can set a voucher to expire on any specific day beyond which it is not available for use.
Follow these steps to set an expiry date for a voucher.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
In the Vouchers tab, enter one of the following:
-
Voucher number or HRN in the Voucher Number field
-
Voucher serial number in the Serial Number field
-
-
Click Search.
Tip: When searching on the voucher number, the number entered must be the length of the voucher number as defined for the authentication rule for this voucher.
Result: The Voucher subtab displays the details for the voucher searched for.
-
In the Voucher subtab, in the Voucher Expiry field, clear the Remove check box and click the date chooser icon.
Result: The Date Chooser window is displayed.
Note: The Voucher Expiry field is disabled if the Remove check box is selected. By default, the Remove check box is selected.
-
In the Date Chooser window, select a date and time when you want the voucher to expire.
-
Click Save.
Batch
The Batch subtab displays information related to voucher batches. It provides information about batch ID, batch name, batch state, and batch expiry.
Batch fields
The following table describes the Batch subtab fields.
Field | Description |
---|---|
Batch Name | The name of the voucher batch. This can be up to 50 characters long. |
Batch ID | Unique ID for the voucher batch. |
Batch Code | The batch code for the voucher batch that includes this voucher. |
Batch State |
The state of vouchers in the voucher batch. The batch states are:
|
Batch Activated | Activation date of the voucher batch. |
Batch Expiry |
The expiry date of the vouchers in this batch. This field enables you to specify the voucher batch expiry date, which sets a batch to expire on a specific day and shows users that a batch is no longer active and not available for use. |
Subscriber
The Subscriber subtab displays voucher redemption, wallet reference, subscriber ID, and scenario information for a voucher.
Subscriber fields
The following table describes the Subscriber subtab fields.
Field | Description |
---|---|
Voucher Redeemed | The voucher redemption date. |
Wallet Reference | The wallet reference of the redeeming wallet. |
Subscriber ID | The ID of the subscriber redeeming the voucher. |
Scenario |
The voucher scenario used to redeem the voucher. Note: This field is visible only if scenarios have been installed and activated on your system. For more information about installing and activating scenarios, see CCS Technical Guide. |
Info
The Info subtab displays details about distributor and retail channel and other additional information about a voucher.
Note:
The fields in Info subtab are editable only if the following conditions are met:
-
The voucher status needs to be in active, created, or frozen state.
-
The Info subtab needs to have CreateDelete or ReadModify permissions. You can modify the permissions under User Management > Template Creation > CCS > Voucher Info Subtab.
Info fields
The following table describes the Info subtab fields.
Field | Description |
---|---|
Barcode | The barcode number of the voucher. You can use a maximum of 12 digits. |
Text | Description of the voucher. You can use a maximum of 50 characters. |
Card Design | Version number of the voucher design. You can use a maximum of 4 digits. |
Distributor Channel | Distributor of the voucher. You can use a maximum of 50 characters. |
Retail Channel | Retailer of the voucher. You can use a maximum of 50 characters. |
Provisioning Date | Date on which the voucher is created. |
Free Text Field_1 | Field for capturing business process information. You can use a maximum of 50 characters. |
Free Text Field_2 | Field for capturing business process information. You can use a maximum of 50 characters. |
Free Text Field_3 | Field for capturing business process information. You can use a maximum of 50 characters. |
History
History subtab displays the history of changes made for that particular voucher.
History fields
This table describes the History subtab fields.
Field | Description |
---|---|
Date | Date when the voucher was modified. |
Term | The host that modified the voucher. |
User | User name of the user who made the changes. |
Type |
Type of the operation performed. Types are:
|
Description | The description of the changes made. |
Voucher Validation
Use the Voucher Validation tab to test whether a given voucher signature (the voucher number and secret digits) is valid.
Note: You will only have access to this facility if you have sufficient user privileges.
Validating a voucher
Follow these steps to validate a voucher.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
In the Voucher Signature field in the Voucher Validation tab, enter the voucher number or HRN. Do not include any spaces.
Tip: The voucher number to use for searching must be the length of the voucher number as defined for the authentication rule for this voucher.
-
Click Validate.
Result: The Voucher Status field shows the validity of the voucher.
Voucher validation results
This table lists the possible messages displayed when you validate a Voucher.
Message | Description |
---|---|
|
You clicked Validate before entering the voucher signature. |
|
The signature has been confirmed by the SMS. |
|
The signature was not recognized by the SMS. |
Voucher Ranges
The Voucher Ranges tab enables you to change the state of a group of vouchers. The vouchers are a defined range of voucher numbers.
Activating voucher ranges
Follow these steps to change the state of a range of vouchers.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
On the Voucher Ranges tab, from the Voucher Batch drop down list, select the voucher batch which contains the range to change.
Note: The voucher batch corresponds with the Batch ID field in the Voucher Batches screen.
-
From the Voucher State drop down list, select the new state the vouchers in the range should be.
Note: If you want to be able to redeem the vouchers you must set the voucher state to active.
-
In the Start Serial No field, enter the lowest voucher serial number in the voucher range you want to change.
-
In the End Serial No field, enter the highest voucher serial number in the voucher range you want to change.
Note: The range must be 100,000 vouchers or less.
-
In the Description field, enter a description for the voucher range, if required.
-
Click Change.
Result: The Confirm Voucher Change Operation prompt will appear.
-
Click OK.
Result: The Voucher Change State prompt will appear.
-
Click OK.
GPG Public Keys
The GPG Public Keys tab allows you to:
-
Import new GPG public keys into CCS
-
Verify imported keys
GPG keys are used to increase security when creating voucher batch export files for printing.
Once a public key has been verified it can be used as part of the security mechanism for creating voucher batches.
Note: You cannot remove public keys from the SMF database or from the GPG key-ring store on the SMS.
Importing GPG public keys
Follow these steps to import new GPG public keys from a specified file.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
Select the GPG Public Keys tab.
-
In the Import File field, enter the path and filename of the file containing the new GPG public keys or click Browse to select the file.
-
Click Import Keys.
Note: This button becomes enabled once the import file has been specified.
Result: Any keys not currently in the system are imported from the file and you see the GPG Key Importation prompt.
-
Click OK.
Result: The GPG Public Keys tab is refreshed to include the new keys.
Verifying public keys
Follow these steps to verify a GPG public key.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
In the table on the GPG Public Keys tab, select the GPG Key to verify.
Tip: If the value in the Verified column for this key is 'Y', then it has already been verified.
-
Click Verify Key.
Result: You see the GPG Key Importation validation prompt.
-
Click OK.
Deleting GPG public keys
Follow these steps to delete GPG public keys.
-
In the Voucher Manager screen, select the Service Provider from the drop down box.
-
In the table on the GPG Public Public Keys tab, select the public key to delete.
-
Click Delete.
Result: The Confirmation prompt appears.
-
Click OK to confirm.
AVD Configuration
The AVD Configuration tab allows you to:
-
Update the common configuration that will be used on the SMS and across all VWS voucher domains by the automatic voucher delete process.
-
View the date ranges for vouchers that are in the process of being deleted for each of the configured VWS domain nodes.
Notes:
-
Automatic voucher deletion (AVD) is performed on a regular basis by the ccsBeAvd binary processes. For information about ccsBeAvd, see CCS Technical Guide.
-
You manage the configuration of ccsBeAvd from the AVD Configuration tab. This tab also lists the current tasks that the ccsBEAvd binary processes are required to perform. However, it does not show the progress of the deletion of the redeemed vouchers from the VWS domain nodes.
AVD Configuration fields
This table describes the configuration fields in the AVD Configuration tab.
Field | Description |
---|---|
Keep Redeemed Vouchers For | Sets the number of weeks for which redeemed voucher records will be kept on the SMS and VWS nodes. Must be between 1 and 26 weeks. |
Archive Frozen Vouchers | Globally archives frozen vouchers. |
Max Records to Process |
Sets the maximum number of voucher records to delete per run of the automatic deletion process (ccsBeAvd) on the VWS. Must be between 1 and 999999. Note: The frequency and times that the ccsBeAvd process is run on each VWS node is controlled by the crontab for the ccs_oper user. For more information, see Charging Control Services Technical Guide. |
Commit After Num Rows |
Sets the number of redeemed voucher records for ccsBeAvd to delete on the VWS node before committing the changes to the database. You must specify a value between 1 and 9999. If the value you specify is
Note: It is not possible to roll back changes once they have been committed. |
Batch Size | Sets the maximum number of redeemed voucher records to delete in a single batch. You must specify a value between 1 and 999999. |
Sleep Time |
Sets the amount of time (in seconds) for ccsBeAvd to wait after the number of vouchers defined by Batch Size are deleted. You must specify a value between 1 and 999999 seconds. Note: This allows the system processing time for other jobs. |
Node Status fields
The Node Status table on the AVD Configuration tab lists the deletion tasks currently under progress by the automatic deletion process on each VWS node. If there are no entries it means that currently there are no vouchers to delete on any VWS node.
This table describes the fields listed in the Node Status table.
Note: These fields are read-only and cannot be changed. The values in these fields are updated automatically by the automatic voucher deletion process.
Field | Description |
---|---|
Domain Name |
The voucher domains that are currently undergoing automatic voucher deletion processing. Note: You configure domains on the Domain tab in the Service Management screen. See the Service Management chapter in CCS User's Guide for details. |
Node Name | The defined domain nodes from which voucher records to be deleted. |
Redeem Start Date | The start date of the date range for which redeemed vouchers to be deleted. |
Redeem End Date | The end date of the date range for which redeemed vouchers to be deleted. |
Voucher Batch | The batch IDs of the the voucher batch to be deleted. |
Voucher Serial | The serial number of the first voucher in each batch to be deleted. |
Changing AVD configuration
Follow these steps to change AVD configuration.
-
In the Voucher Manager window, click on the AVD Configuration tab.
Result: You see the current AVD configuration details. See AVD Configuration tab.
-
Edit the fields to reflect the changes you need to make.
For more information about the fields on this tab, see AVD Configuration fields.
-
Click Save.