android

Card Validator Android SDK

Card Validator is a simple tool for validating if a card number is valid or not. It checks the card number format and the Luhn algorithm to see if the card number is valid.

---

Installation

Gradle (via JitPack)

Add JitPack repository to your root build.gradle:

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Add the dependency:

dependencies {
    implementation 'com.github.apiverve:cardvalidator-api:1.1.14'
}

---

Quick Start

Basic Usage

import com.apiverve.cardvalidator.CardValidatorAPIClient;
import com.apiverve.cardvalidator.APIResponse;
import com.apiverve.cardvalidator.APIException;

// Initialize the client
CardValidatorAPIClient client = new CardValidatorAPIClient("YOUR_API_KEY");

try {
    // Prepare query parameters
    Map<String, Object> parameters = new HashMap<>();
    parameters.put("number", "4900264223817524");

    // Execute the request
    APIResponse response = client.execute(parameters);

    if (response.isSuccess()) {
        // Handle successful response
        JSONObject data = response.getData();
        System.out.println("Success: " + data.toString());
    } else {
        // Handle API error
        System.err.println("API Error: " + response.getError());
    }
} catch (APIException e) {
    // Handle exception
    e.printStackTrace();
}

Without Parameters

// Some APIs don't require parameters
APIResponse response = client.execute();

---

Error Handling

The SDK provides detailed error handling:

try {
    APIResponse response = client.execute(parameters);

    if (response.isSuccess()) {
        // Process success
    } else {
        // Handle API-level errors
        System.err.println("Error: " + response.getError());
    }
} catch (APIException e) {
    if (e.isAuthenticationError()) {
        System.err.println("Invalid API key");
    } else if (e.isRateLimitError()) {
        System.err.println("Rate limit exceeded");
    } else if (e.isServerError()) {
        System.err.println("Server error");
    } else {
        System.err.println("Error: " + e.getMessage());
    }
}

---

Response Object

The APIResponse object provides several methods:

APIResponse response = client.execute(params);

// Check status
boolean success = response.isSuccess();
boolean error = response.isError();

// Get data
String status = response.getStatus();
String errorMsg = response.getError();
JSONObject data = response.getData();
int code = response.getCode();

// Get raw response
JSONObject raw = response.getRawResponse();

---

API Documentation

For detailed API documentation, visit: https://docs.apiverve.com/ref/cardvalidator

---

Get Your API Key

Get your API key from https://apiverve.com

---

Requirements

• Java 8 or higher
• Android API level 21 (Lollipop) or higher

---

Support

• Documentation: https://docs.apiverve.com/ref/cardvalidator
• Issues: GitHub Issues
• Email: hello@apiverve.com

---

License

This SDK is released under the MIT License. See LICENSE for details.

---

About APIVerve

APIVerve provides production-ready REST APIs for developers. Fast, reliable, and easy to integrate.