Introduction

Card on file facility in IP1 allows customers to make payments using a card that has been previously used. This is achieved by utilising tokens already captured from the payment gateway and stored on the system from a previous payment. The customers using this facility must be configured in control file TMSAR/PM-COF. After a new credit card information is captured by the payment gateway during Order entry, AR Cash entry or AR Collections maintenance, the system will bring up Work with Card on File program allowing you to store the card information on file. Multiple cards can be stored for a customer with usable date range and the card can be inactivated or re-activated as required.

Business rules/Other setup

The following business rules have to be setup to handle Card on File. These business rules must be setup with support from Iptor IP1 consultants. It is critical to understand the setting of control files and how it works. Control files must be setup correctly for the system to operate as intended. Any changes to the control files setup should be addressed cautiously and in consultation with Iptor IP1 consultants.

Note	This document does not cover customised setup tasks of specific companies. Deviations from this setup should be covered by setup tasks written by individual companies.

View business rules

Control files/Other	Setup
TMSAR/PM-COF Card on File	Setup this control file to define which debtor class and customers are allowed to use card on file facility.
Standard Payment manager control files and Merchant details for credit card processing	Ensure all the payment manager control files for the service provider and the merchant details is setup accordingly.
Java agent	Ensure the Java agent is running.

Procedure

It is your responsibility to ensure that you understand this procedure before performing the following tasks.

Note	Deviations from this procedure should be covered by procedures written by your company. Before performing any tasks please ensure all the business rules are set-up accordingly.

Process	Steps
Capture & store new credit card information via AR entry. Note: New credit card information can be captured when the Payment handler is called via any of the following. Cash entry (ARE005) Order entry; for payment with order AR Collections maintenance	Enter the Cash/Journal entry using CSH payment function. Set the document type to CC for credit card payment. Enter the customer account, the payment amount and allocate the payment. When there is no COF for the customer, the system will bring up the service providers landing page to enter the credit card information. For customers with existing COF see next section: Utilising existing COF. Enter the valid card information and click Continue. The entered details are displayed. You can make any changes, cancel the payment or confirm payment by clicking Make Payment. Click Make Payment to process the payment. On successful payment, the payment receipt will be displayed. It would then transfer back to iSeries and bring up the following panel, allowing you to add the card to COF. Enter the following information. Usable From/To – allows cards to be used only during specific dates. Usable to date defaults to ’99/99/99′ to allow all future usage. Status – A=active, C=closed. Only active cards will be available for use. Comment – Any text/comments relating to the card. Click OK to save the COF. The new COF is displayed. Click OK. Payment entry panel ARE210 is displayed with the Payment Transaction ID and the Approved stamp.
Utilising an existing COF on Order Entry Note: When a COF already exists, the system will bring up the list of existing COF(s) and allow you to choose one of the cards.	Enter an order as per normal order entry. Flag the Payment terms on the order header to prompt payment. Enter the order details and click OK to confirm the order. DSE131 Payment Entry panel appears. Enter the payment details with payment method as CC = credit card and click OK. The system will display all the currently active cards that are in the usable date range in COF. Select the card you wish to pay with. DSE131 Payment entry is displayed with the selected card details under Banking reference. Click Confirm to accept the payment. Note: You can opt to use a new card instead of using an existing COF, to do this click function New card on ARW040 instead of selecting an existing card. The system will bring up the service providers landing page to enter the new credit card information. Once the new card details are entered on the landing page as in the previous section, you again have the option to store the new card into COF, or use it for just one payment.
Suspend/Re-activate COF	To prevent an existing COF from being used or to suspend it for a period, you can change the usable date range or change the status to closed. A closed COF can be activated anytime and the usable date range can also be changed to use the card again. Refer to Work with Card on File on how to suspend or re-activate a COF.

Process

Steps

Capture & store new credit card information via AR entry.

Note: New credit card information can be captured when the Payment handler is called via any of the following.

Cash entry (ARE005)
Order entry; for payment with order
AR Collections maintenance

Enter the Cash/Journal entry using CSH payment function.
Set the document type to CC for credit card payment.
Enter the customer account, the payment amount and allocate the payment.

When there is no COF for the customer, the system will bring up the service providers landing page to enter the credit card information. For customers with existing COF see next section: Utilising existing COF.

Enter the valid card information and click Continue. The entered details are displayed. You can make any changes, cancel the payment or confirm payment by clicking Make Payment.

Click Make Payment to process the payment.
On successful payment, the payment receipt will be displayed.

It would then transfer back to iSeries and bring up the following panel, allowing you to add the card to COF.

Enter the following information.
- Usable From/To – allows cards to be used only during specific dates. Usable to date defaults to ’99/99/99′ to allow all future usage.
- Status – A=active, C=closed. Only active cards will be available for use.
- Comment – Any text/comments relating to the card.

Click OK to save the COF. The new COF is displayed.

Click OK. Payment entry panel ARE210 is displayed with the Payment Transaction ID and the Approved stamp.

Utilising an existing COF on Order Entry

Note: When a COF already exists, the system will bring up the list of existing COF(s) and allow you to choose one of the cards.

Enter an order as per normal order entry.
Flag the Payment terms on the order header to prompt payment.
Enter the order details and click OK to confirm the order. DSE131 Payment Entry panel appears.
Enter the payment details with payment method as CC = credit card and click OK. The system will display all the currently active cards that are in the usable date range in COF.

Select the card you wish to pay with. DSE131 Payment entry is displayed with the selected card details under Banking reference.

Click Confirm to accept the payment.

Note: You can opt to use a new card instead of using an existing COF, to do this click function New card on ARW040 instead of selecting an existing card. The system will bring up the service providers landing page to enter the new credit card information. Once the new card details are entered on the landing page as in the previous section, you again have the option to store the new card into COF, or use it for just one payment.

Suspend/Re-activate COF

To prevent an existing COF from being used or to suspend it for a period, you can change the usable date range or change the status to closed. A closed COF can be activated anytime and the usable date range can also be changed to use the card again.

Refer to Work with Card on File on how to suspend or re-activate a COF.