RPOWER Gift Card Programs


Jump to: navigation, search


Gift Cards

RPOWER's gift card program is robust and flexible, whether implemented at a single store restaurant or a multi-unit chain. With multi-store gift cards, customers can purchase a gift card at one location, increase its balance at another location, and make purchases at all locations. This article details the implementation and setup of RPOWER single and mutlti-store gift card programs.

Order Gift Card Numeration and CUSCNX.INI file

Complete an order form and email it to office.manager@rpower.com, being sure to include the following information:

  • Dealer Number (if known) - A unique four digit number identifying the dealer. For a new dealer's first order this number will be issued by RPOWER.
  • Program Number (if known) - Four digit number identifying the customer. For a new customer's first order this number will be issued by RPOWER, typically 1201.
  • Starting card number. For a new customer's first order this will be assigned by RPOWER, typcially 120001 unless otherwise notified.
  • Number of cards. Since RPOWER charges a $25.00 fee for card numeration the dealer might consider making this number big, like 10,000, and using the numbers as needed for that customer.

These parameters are used to create unique card numeration for each program. A four digit CVC (card validation code) is also generated with each card number issued. RPOWER can require entry of the CVC when a card number is manually entered (not swiped), making the successful use of a fraudulent card number unlikely at best.

RPOWER will return to the dealer the cuscnx.ini and an Excel file containing the card numbers, the card number as they should be printed, and the CVC's. Any plastic card company will then encode (Track 2) the card numbers, emboss (or print) the printed card number (three groups of five digits) and print the CVC (preferably on the back of the card).


Cuscnx.ini contains the parameters used by RPOWER to control the specific behaviors of each gift (and loyalty) program. Multiple programs within one site are supported through the use of mutiple setup entries within the cuscnx.ini.

The file will be copied to the dealer's ftp folder, and will be found in the format DealerShortName_CustomerName_cuscnx.ini.

Navigate to:

 X:\rpower\winrun\ini (where X is the system shared drive letter)

...and copy the .ini file here.

  • Important: Rename the file to cuscnx.ini.
  • Important: Be sure that Hide extensions for known file types is not selected. (Windows Explorer, Tools, Folder Options, View)
  • Important: RPOWER MUST be restarted on all workstations for cuscnx.ini to load. (Shortcut - Manager/System Maintenance/Enter Site Code does exactly that).

Below is a sample cuscnx.ini with explanations of each section and parameter.

 *A* [Setup]
 *B* Service=RPOWERGift
 *D* Type=RPOWER
 *E1* Server=
 *E2* Server= ; SERVER1
 *E3* Server=
 *E4* Server=RPOWER.DYNDNS.ORG:32112 ; ServerName
 *F* UseDNS=1
 *G* Test=QW1,988712241200019 ; 4169
 *G* Test=QW2,988712241200027 ; 9717
 *G* Test=QW3,988712241200035 ; 3952
 *G* Test=QW4,988712241200043 ; 5632
 *G* Test=QW5,988712241200050 ; 3958
 *H* CardRule=type=4, subt=1, id=RPGIFT, name=Gift Card, len=15:1:15:4, Man=1:1
*J* TranFlags=CD,ED,A,D,NC
*K* TenderKey=1
*L* SettleGroup=1
*M* AcctPrefix=GC

A Profile name. [Setup] is default but could also be [Support] or others for support or debugging purposes.

B Service names contained in this file, could be multiple.

C Beginning of parameters for service RPOWERGift.

D Program host type. RPOWER indicates local as opposed to third party program.

E The IP address and port of the computer that will be used as the gift card server.

E1 Example of a single store setup, Using a non-existent IP address tells RPOWER that it is hosting the program itself, so it therefore looks to itself and not a defined server for program data,

E2 Example of server setup for a multi-store program, where this store is the hosting (server) system,

E3 Example of server setup for a multi-store program using static IP addressing at the hosting (server) system, where this store is a client store.

E4 Example of setup for a multi-store program using DYNDNS to simulated static IP addressing at the hosting (server) system, where this is a client store.

Note that a server name included after the IP address and separated by a colon is a label for reference purposes only.

F Use DNS (1) or not (0) to resolve an ip address from a url

G Test cards for this program. Emter ;qw1, ;qw2, ;qw3, etc. to "swipe" test card 1, 2, 3, etc. for setup and testing purposes.

G CardRule= Program parameters. Type 4 indicates RPOWER CRM. Subtypes 1 through 8 allow up to eight different CRM programs. ID is the short name (up to seven characters) used for the program. Name is the descriptive name for the progran that is both printed and displayed to users. LEN controls how the raw card number is parsed. Older versions of RPOWER could only handle card numbers internally of ten digits or less. As of version 11, RPOWER can deal with long card numbers. The example LEN tells RPOWER that the card is 15 digits long, and to start at the first digit and take 15 digits. The 4 indicates that the card number has a MOD10/2 check-digit on the end, an 8 would indicate a MOD10/3 check-digit on the end. Pre allows qualification of card number prefixes. In the example, only cards beginning with 91234567 are permitted. Pre is evaluated before any card parsing is performed. Man=1:1 indicates that manually entered card numbers are permitted but will require a manager, Man=1:0 would not require a manager. Man=0 would not permit manually entered card numbers at all.

I Customer Flags - In this example, CLMT indicates customers have credit limits, LMTD: spending is limited to available credit, ANON: customers are anonymous, GIFT: Gift cards, DBAL and PBAL: Display and print card balances.

J Transaction Flags - CD: Charge dollars permitted, ED: Receive dollars permitted, A: Activate permitted, D: Deactivate permitted, NC: Transfer permitted, NRCPT: No receipt will be printed.

K Tender Key - the Payment Method associated with the gift card (Manager, System Setup, Payment Methods, Gift Card Redeemed, Tender Key/Type #)

L SettleGroup - The settlement group for this program

M AcctPrefix - The account prefix. RPOWER automatically creates a new gift card account each month as gift cards are sold. The account name is a combination of the Card Rule ID and the date, e.g., RPGIFT 2013 April. The account number is a combination of the AcctPrefix and the date, e.g., GC1304.

Port Forwarding

If setting up the server system for a multi-store program, be sure to forward the appropriate port, usually 32112, through the router, to the server workstation referenced in the Server= section of cuscnx.ini.


Configure Gift Card Redeemed Payment Method

Navigate to Manager, System Setup, Payment Methods and Add New

The important fields are:

Name: Gift Card Redeemed

Apply Sales Tax?: Y

Ask $ Tendered?: Checked

Put $ over on tip?: Checked

Detail report?: Customer choice - whether or not to show gift card detail in the close day report, much like credit card detail

Type: C $On-line (CRM) Charge

# G/C Copies: Probably 2 - Guest check copies

Tender key/type #: Usually 1. This is what ties the payment method to the program defined in cuscnx.ini through the Tender Key entry.

Print for tip & signature: Probably checked

"Pre-pay" (debit)?: Checked - Defines behavior

Auto-pay on swipe?: Checked - When swiped, system assumes payment operation

Department: Gift Card or Other

  • Important: Changes to Payment Methods require a restart of RPOWER (Tip: use Manager Functions, System Maintenance, Enter Site Code to do just that).

Create Gift Card Sold Menu Sales Category

Navigate to Manager, System Setup, Menu Sales Categories and Add New

The important fields are:

Name: Gift Card Sold

HASH (throw away)?: Checked

No Tax

Allow combine check?: Checked

Gift Card/CRM rec'd: Checked

OK to split?: Checked

Day/Times: All Days and Times

Department: Gift Card Sold

Itemizers: All Items - to allow discounts

Create Gift Card Sold Menu Item

Navigate to Manager, Menu Setup

Choose a menu panel on which to place the menu item, Open Keys maybe?

Choose a menu button on which to place the menu item

From the list of Menu Items select Add New

Select Regular Menu Item

The important fields are:

Name: Gift Card Sold

Item Type: Regular Menu Item

Category: Gift Card Sold

Ask amount?: Checked - to allow entry of any amount

Multiple preset amount gift card sold items may also be created. On those, Ask amount? would not be checked and the name and price would be filled appropriately, e.g., 25$ Gift Card, with Price/Level at 25.00

Gift Card Operations - Purchase and Redemption

Selling a gift card

Selling a gift card is like selling any other menu item.

On a server workstation, start a new guest check or pick up an existing one. Navigate to the panel containing Gift Card Sold and touch it. At the Amount for Gift Card Sold prompt, enter the purchase amount and touch OK.

At the Gift Card Sold... prompt, swipe the card through the magnetic swipe reader or enter the card number using the numeric keypad.

Enter CVC
  • Note: If the card number is manually entered, depending upon system programming, a CVC (Card Validation Code) may be required. The CVC is a four digit number normally printed on the back of the card.

Pay the check normally. A receipt will be printed showing an invoice number for future reference, the gift card number, and the current balance.

On a Bar, Cashier or Cash Register type workstation, assuming cash sales are permitted, it is not necessary to start a guest check, tab or counter check, simply navigate to the menu panel containing Gift Card Sold and touch it, Enter the purchase amount and touch OK.


At the Gift Card Sold... prompt, swipe the card through the magnetic swipe reader or enter the card number using the numeric keypad.

Use Cash to close the transaction to cash, or swipe a credit card,


Querying a Gift Card Balance

To check the balance on a gift card, on a passcode sercure workstation, passcode in and swipe the card; on any type of non-secure workstation, outside of a sales transaction, swipe the card.

The balance is displayed.


Touch OK to exit or touch Print to print a balance chit


Redeeming a gift card

The procedure for redeeming a gift card is identical to that for tendering a credit card,

Pick up the check to be paid, and, from the order entry window, swipe the card.

At the Amount Authorized... prompt, touch OK to close the check to the gift card, or enter an amount to split tender the check,

RPOWER prints a receipt, typically with tip and total lines,

Close the check normally to add the tip.

Personal tools