For AI agents: the complete documentation index is at /llms.txt, and the full text of every page is at /llms-full.txt. Most pages are also available as Markdown by adding .md to the URL.

Android Library

Integrate using our Android library

Requirements

Android Studio 4.2+
Android SDK 21 (Lollipop)
Android SDK Tools
Java Version 1.8

Installation

Declare jcenter repository in the rood build.gradle file:
allprojects { repositories { jcenter() } }

Declare dependency in the app build.gradle file:

dependencies {
   implementation 'com.globalpayments.android:globalpayments-android-sdk:1.0'
}

Github

You can find a test suite of code samples for using the Android SDK in our GitHub repository.

Documentation and samples

You can find the latest SDK documentation under SDKs & Libraries. For a full list of test cards, see our Test Cards article. Code examples can be found in the API Explorer.

Sample code - Processing a payment

/// Prepare required configuration
GpApiConfig config = new GpApiConfig();
config.setServiceUrl("Service Url"); //(Sandbox URL: "https://apis.sandbox.globalpay.com/ucp")
config.setAppId("Your application ID");
config.setAppKey("Your application key");

/// Add config to container
ServicesContainer.configureService(config);

/// Prepare card
CreditCardData card = new CreditCardData();
card.setNumber("4111111111111111");
card.setExpMonth(12);
card.setExpYear(2025);
card.setCvn("123");

// Execute operation
Transaction transaction = card.charge(new BigDecimal("19.99"))
   .withCurrency("USD")
   .execute();

Test cards

Card Number	Card Type	Expiration Date	Security Code
4263970000005262	Visa	12/2025	123
2223000010005780	MasterCard	12/2025	900
5425230000004415	MasterCard	12/2025	123

Android Library | Global Payments