Setting Up Credit Card Interface Elements

This section discusses how to:

Define connection parameters.
Define accepted credit card types.
Test the credit card interface.
Test credit card transactions.

Note: The information in this section is used for credit card integration using Integration Broker, or any manual processing that you have set up for credit card processing vendors.

Pages Used to Set Up Credit Card Interface Elements

Page Name	Definition Name	Navigation	Usage
Credit Card Interface Installation	EOEC_CCI_INSTAL	select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Setup	Define connection parameters for credit card processing calls to a third-party vendor. Before you set up credit card processing options, establish your merchant account with a third-party vendor.
Card Type	EOEC_CCI_CARDTYPE	select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Credit Card Types	Define the types of credit cards you accept for credit card processing.
Test Credit Card Interface - Card Entry/Display	EOEC_CCI_TEST	select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Test Credit Card Interface, then select Card Entry/Display	Enter test credit card information that you can submit to verify that your credit card processing is functioning properly.
Test Credit Card Interface - Transaction	EOEC_CCI_TRANSACT	select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Test Credit Card Interface, then select Transaction	Enter test credit card transaction information that you can submit to verify that your credit card processing is functioning properly.

Credit Card Interface Installation Page

Use the Credit Card Interface Installation page (EOEC_CCI_INSTAL) to define connection parameters for credit card processing calls to a third-party vendor.

Before you set up credit card processing options, establish your merchant account with a third-party vendor.

Navigation

select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Setup

Note: Before you set up credit card processing options, establish your merchant account with a third-party vendor.

Note: Check the installation documentation for the product you are installing for specific details on setting up credit card interfaces.

Image: Credit Card Interface Installation page

This example illustrates the fields and controls on the Credit Card Interface Installation page. You can find definitions for the fields and controls later on this page.

Verify connection requirements with your vendor.

Credit Card Merchant ID

Enter the merchant ID supplied by your vendor.

Credit Card Hist. Backup Days (credit card history backup days)

If you create a process that archives history records, specify the number of days that you retain credit card authorization history records.

Credit Card Tracing

This field is currently not used.

On-line Transmission Retries

Enter a value from 0 through 9 to specify how many times the system should attempt to retransmit transactions in the event of transmission failure.

Address Verification Flag

Credit card transmissions can fail authorization if the address that you send doesn't exactly match the billing address for the credit card. Select from:

Add Vf ON (address verification on): Transactions fail when the address that you send does not match the credit card billing address. This is the default value.

Add Vf OFF (address verification off): Transactions do not fail when the address that you send does not match the billing address on the credit card.

Type of Interface

Select to use Integration Broker as the interface type.

Allowed Transaction Types

Credit Card Transaction Type

Select the types of transactions that your agents are allowed to submit. Disallowed transaction types are not available on the application-specific credit card transaction page. Select from:

Authorization Reversal: Your vendor can cancel the transaction after authorization and before payment is received. This makes the funds available if the transaction is cancelled.

Authorize Only: Your vendor verifies that the card is valid for the charge. For example, the customer has enough credit to pay for the order, the card is not stolen, and so forth. The vendor does not bill the credit card.

Bill Only: Your vendor bills the card without first verifying that the card is valid for the charge. Select this option if you have preauthorized the transaction and you want to submit the transaction for billing only.

Authorize and Bill: Your vendor performs both authorization and billing during the same transaction. The vendor charges the customer’s credit card on receiving authorization.

Credit Only: Your vendor credits the customer’s credit card.

Process Credits

Select to permit agents to submit credit transactions as well as billing transactions. This option is available only if you selected either Authorize and Bill or Bill Only in the Credit Card Transaction Types field.

Connection Parameters

The third-party vendor that you integrate with will provide you with information to connect with their systems. Enter that information to enable your PeopleSoft system to make the connection when you submit a transaction for processing.

Card Type Page

Use the Card Type page (EOEC_CCI_CARDTYPE) to define the types of credit cards you accept for credit card processing.

Navigation

select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Credit Card Types

Image: Card Type page

This example illustrates the fields and controls on the Card Type page. You can find definitions for the fields and controls later on this page.

Use this page to define the types of credit cards that you accept for credit card processing.

Oracle delivers data for most popular credit card types. You can modify existing definitions and add new ones.

Credit Card Type

Enter a value for the credit card.

Credit Card Name

Enter a credit card name such as Visa or MasterCard. The name should match the credit card type so that you can identify the card without memorizing the credit card type codes.

Credit Card Number Length

Enter the card's standard credit card number length. Before transmitting a request to your vendor, the system validates the length of the credit card number against this number.

Credit Card Status

Select Active if you accept this type of credit card. Select Inactive if you don’t accept this type of credit card. Inactive credit card types do not appear on the application-specific credit card transaction page or in the Test Credit Card Interface component.

The default value for this field is Inactive.

Credit Card Valid Prefixes

Enter all valid prefixes for this type of credit card. Enter multiple prefixes in comma-separated format with no spaces in between. The system removes any characters other than numbers and commas when you move to another field.

Before transmitting a request to your vendor, the system validates that the credit card number starts with a valid prefix.

Use Check Digit Algorithm

Select Y (yes) to use the modulus (MOD) 10 check digit algorithm to validate credit card numbers before transmitting requests to your vendor. The MOD 10 check digit algorithm verifies whether card numbers you enter into the system are legitimate.

The default value for this field is N.

Credit Card Expiration Days

Enter a four digit numerical expiration value.

Test Credit Card Interface - Card Entry/Display Page

Use the Test Credit Card Interface - Card Entry/Display page (EOEC_CCI_TEST) to enter test credit card information that you can submit to verify that your credit card processing is functioning properly.

Navigation

select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Test Credit Card Interface, then select Card Entry/Display

Image: Test Credit Card Interface - Card Entry/Display page

This example illustrates the fields and controls on the Test Credit Card Interface - Card Entry/Display page. You can find definitions for the fields and controls later on this page.

Use this page to enter test credit card information that you can submit to verify that your credit card processing is functioning properly.

The test that you can run on this page:

Verifies that the card number you enter meets the requirements defined in the Credit Card Valid Prefixes field for the associated card type on the Card Type page.
If you have set the Use Check Digit Algorithm field value to Y, verifies that the card number is valid based on the MOD 10 check digit algorithm.
Verifies that you have entered values in the Exp. Month, Expiration Year, First Name and Last Name fields on this page.

You can use the following credit card sample data in your test transactions:

Credit Card Type	Credit Card Number
American Express	378282246310005
Diners Club/Carte Blanche	38000000000006
Discover	6011111111111117
MasterCard	5555555555554444
Visa	4111111111111111

Card Type

Select a card type to test. Available values are defined on the Credit Card Types page.

Credit Card Number

Enter the credit card number to test.

Exp. Month (expiration month), Expiration Year, Card Verification Number, First Name and Last Name

Enter card information to test.

Card verification number is optional in running credit card tests.

Toggle Display

Click to switch between display-only and editable modes.

Test

Click to begin the test.

Test Results

The results of the test appear in this text box. If the card number is valid, the message VALID CARD NUMBER appears. If the card number is not valid, an explanatory message appears; the card number is incorrect or the card is expired, for example.

Credit Card Transaction Test Page

Use the Test Credit Card Interface - Transaction page (EOEC_CCI_TRANSACT) to enter test credit card transaction information that you can submit to verify that your credit card processing is functioning properly.

Navigation

select Enterprise Components, then select Component Configurations, then select Credit Card Interface, then select Test Credit Card Interface, then select Transaction

Image: Test Credit Card Interface - Transaction page

This example illustrates the fields and controls on the Test Credit Card Interface - Transaction page. You can find definitions for the fields and controls later on this page.

Use this page to enter test credit card transaction information that you can submit to verify that your credit card processing is functioning properly.

The test that you can run on this page verifies that your environment is set up correctly to process online credit card transactions using XML Compliant integration.

Note: This does not test the environment that is set up for batch credit card transactions.

Sequence and Request ID

Display a combination of numbers that distinguishes the transaction from other transactions. The combination of numbers are similar to a run control or job number.

Amount

Enter a transaction amount and click the Look up button to select a transaction currency.

Token

The token is a response value that is returned from the Credit Card processing service. It is another validation that can be referenced in regards to a specific transaction.

Trans. Type (transaction type)

Choose a transaction type to test:

Auth/Bill (Authorization/Bill): Perform both authorization and billing during the same transaction.

AuthRev (Authorization Reversal): Cancel the transaction after authorization and before payment is received.

Authorize: (default value) Verify that the card is valid for the charge.

Bill: Bill the card without first verifying that the card is valid for the charge.

Credit: Credit the customer’s credit card.

Class ID

Select TestTransaction (the default) or one of the following interface types that has been specified on the Credit Card Interface Installation page.

ProcessBrokerTransaction: Select if you want to test your XML-based interface.

InterlinkTransaction: Select if you want to test your Business Interlink interface.

Process

Click to process the test transaction.

Return Code

Enter a return code to test whether proper error messages and results are returned. Available codes and their descriptions are discussed in the Return Codes section subsequently.

Test Results

The results of the transaction test appear in this text box. Test result interpretations are discussed in the following sections.

Return Codes

You can enter any of the following return codes and click Process to view the corresponding description and error message in the Test Results area. These return codes and their corresponding error messages can appear in multiple areas. For example, when you are using the Test Credit Card Interface component, they appear on this test page. In an application, they appear as appropriate for that application's method of interacting with the credit card interface.

Return Code	Description
-3	Error Opening Trace File
-4	Vendor Error − ICS_INIT failed
-5	Unsupported Service
-6	Credit card number is invalid
-7	Phone number is too long
-8	State field length is invalid
-9	Zip Code field is too long
-10	Amount must be greater than zero
-11	Vendor Error − ICS_SEND failed
-12	Decryption Failed
-15	Request ID is required
-16	Currency is required
-17	Phone is required
-18	Email ID is required
-19	Zip Code is required
-20	City is required
-21	Country code is required
-23	Address 1 is required
-99	Trace Run Only