GlobalCardValidator Class

Properties   Methods   Events   Configuration Settings   Errors  

The GlobalCardValidator component is used to verify with Global Payments that a given card number is formatted properly, and could be a valid card number. Validating a card before actually submitting a transaction for authorization can reduce the fees that may be associated with invalid or declined transactions.

Class Name

InPayDirect_GlobalCardValidator

Procedural Interface

 inpaydirect_globalcardvalidator_open();
 inpaydirect_globalcardvalidator_close($res);
 inpaydirect_globalcardvalidator_register_callback($res, $id, $function);
 inpaydirect_globalcardvalidator_get_last_error($res);
 inpaydirect_globalcardvalidator_get_last_error_code($res);
 inpaydirect_globalcardvalidator_set($res, $id, $index, $value);
 inpaydirect_globalcardvalidator_get($res, $id, $index);
 inpaydirect_globalcardvalidator_do_config($res, $configurationstring);
 inpaydirect_globalcardvalidator_do_getdebitnetworkinfo($res);
 inpaydirect_globalcardvalidator_do_interrupt($res);
 inpaydirect_globalcardvalidator_do_iscommercialcard($res);
 inpaydirect_globalcardvalidator_do_reset($res);
 inpaydirect_globalcardvalidator_do_validatecard($res);

Remarks

Utilization of this class catches accidentally mistyped card numbers and allows buyers to re-input their number without having the transaction declined. It can also determine the type of credit card (Visa, MasterCard, Discover, etc) so that you can easily determine if the customer is presenting a payment type which you do not support. The class can also parse swiped track data and perform these same checks on it.

There are four checks performed by the ValidateCard method on the customer's credit card information:

• The card number is checked for validity using the Luhn mod-10 algorithm.
• The type of the card (Visa, MasterCard, etc.) is computed from the card number.
• The expiration date is checked against the current system date.
• The length of the card number is checked to see if it's a valid length for the computed card type.

In addition, the IsCommercialCard method will attempt to determine if the specified CardNumber is a commercial or purchasing card, and the GetDebitNetworkInfo method will attempt to determine if the CardNumber is a debit card. This way you can pass Level 2 data (Tax amount and purchase order number) for commercial cards, or ask for a PIN for debit cards, and receive a lower interchange rate for the transaction.

This class will query the Global Transport Server to perform the above checks. The UserId and Password is only required for the GetDebitNetworkInfo method, neither IsCommercialCard or ValidateCard require authentication to use. The first three checks made by the ValidateCard method may also be performed off-line by setting the ValidationMode configuration setting to "Local" instead of "Global". In this case, the mod-10 check will be computed mathematically by the class, and the expiration date will be checked against the current system time. The CardTypeDescription will be computed using an internal set of rules, but do note that these will not be as up-to-date as the rules the Global Payments Server uses. The length check will only be performed when ValidationMode is set to "Global" mode.