validate()

Example

PaymentSession.validate('card', function (result) {
    // HANDLE VALIDATION RESULTS
    if (result.card) {

        //check if all hosted fields are valid
        if (result.card.isValid) {
            console.log('All hosted fields of "card" paymentType are valid');
        } else {
            //CHECK WHICH FIELDS ARE INVALID

            //check card number results
            if (result.card.number) {
                var cardNumber = result.card.number;

                //check if card number is valid
                if (cardNumber.isValid) {
                    console.log('Card number is valid.');
                } else {
                    if (cardNumber.isIncomplete) {
                        console.log('Card number is incomplete, please enter full card number.');
                    }
                    if (cardNumber.hasError) {
                        console.log('Error has been detected on Card number field.');
                    }
                    if (cardNumber.errorReason) {
                        switch (cardNumber.errorReason) {
                            case 'EMPTY':
                                console.log('Card number is mandatory field, please enter card number.');
                                break;
                            case 'INVALID_CHARACTERS':
                                console.log('There is invalid character in card number.');
                                break;
                            case 'NOT_SUPPORTED':
                                console.log('The card number you entered is not supported.');
                                break;
                            case 'INVALID_VALUE':
                                console.log('The card number you entered is incorrect, please check the number and try again.');
                                break;
                            case 'INVALID_LENGTH':
                                console.log('The card number you entered is too long.');
                                break;
                            case 'AWAITING_SERVER_RESPONSE':
                                console.log('Card type is being determined. Please try again.');
                                break;
                            case 'TIMEOUT':
                                console.log('We can not determine the card type. You can proceed updating card number or reload the page.');
                                break;
                            case 'NOT_AUTHORIZED':
                                console.log('Request is not authorized, your session is probably expired. Please reload the page.');
                                break;
                            case 'SYSTEM_ERROR':
                                console.log('System error occurred. Please reload the page.');
                                break;
                            case 'SESSION_AUTHENTICATION_LIMIT_EXCEEDED':
                                console.log('You have exceeded session authentication limit. Please reload the page in order to generate new sessionId.');
                                break;
                            default:
                                break;
                        }
                    }
                    //get selector of the invalid field
                    console.log(cardNumber.selector);
                }

                //check Expiry month results
                if (result.card.expiryMonth) {
                    var expiryMonth = result.card.expiryMonth;

                    //check if Expiry month is valid
                    if (expiryMonth.isValid) {
                        console.log('Expiry month is valid.');
                    } else {
                        if (expiryMonth.isIncomplete) {
                            console.log('Card number is incomplete, please enter the value between [1 - 12].');
                        }
                        if (expiryMonth.hasError) {
                            console.log('Error has been detected on Expiry month field.');
                        }
                        if (expiryMonth.errorReason) {
                            switch (expiryMonth.errorReason) {
                                case 'EMPTY':
                                    console.log('Expiry month is mandatory field, please enter Expiry month.');
                                    break;
                                case 'INVALID_CHARACTERS':
                                    console.log('There is invalid character in Expiry month.');
                                    break;
                                case 'INVALID_VALUE':
                                    console.log('The Expiry month you entered is incorrect.');
                                    break;
                                default:
                                    break;
                            }
                        }
                        //get selector of the invalid field
                        console.log(expiryMonth.selector);
                    }
                }

                // check other fields in "result.card" object
            }
        }
    }
});

JSON Example for Validation Result

// errorReason can be one of the following:

/**
 * General <errorReason> values:
 *
 * - EMPTY
 * - INVALID_CHARACTERS
 * - INVALID_VALUE
 * - INVALID_LENGTH
 */

/**
 * Card Number specific <errorReason> values:
 *
 * - AWAITING_SERVER_RESPONSE
 * - NOT_SUPPORTED
 * - TIMEOUT
 * - NOT_AUTHORIZED
 * - SYSTEM_ERROR
 * - SESSION_AUTHENTICATION_LIMIT_EXCEEDED
 */

/**
 * Expiry Year specific <errorReason> values:
 *
 * - EXPIRED
 */

/**
 * Account Number Confirmation specific <errorReason> values:
 *
 * - MISMATCH
 */

// validation result for "card" paymentType
{
    card: {
        isValid: false,
        nameOnCard: {
            "isValid": true,
            "isIncomplete": false,
            "hasError": false,
            "selector": "#card-holder-name"
        },
        number: {
            "isValid": false,
            "isIncomplete": false,
            "hasError": true,
            "errorReason": "INVALID_LENGTH",
            "selector": "#number"
        },
        expiryMonth: {
            "isValid": true,
            "isIncomplete": false,
            "hasError": false,
            "selector": "#expiry-month"
        },
        expiryYear: {
            "isValid": true,
            "isIncomplete": false,
            "hasError": false,
            "selector": "#expiry-year"
        },
        securityCode: {
            "isValid": true,
            "isIncomplete": false,
            "hasError": false,
            "selector": "#security-code"
        }
    }
}