Do you want to accept payments from mobile users in different countries, different payment system by writing just few of code lines? GamePay SDK is a global mobile payment gateway that accepts payments from more than 200 countries with 100+ alternative payment options. We now provide SDK for Android which will become a native part of your application, it eliminates the necessity to open a web browser for payments. Less steps, faster process, there's no doubt your conversion rate will get boost! All you have to do is to integrate the framework into your project to start accepting in-app payment. It is quick and easy! We'll guide you through the process here.
- Easy integration of payment gateway
- Secure payment processing
- Fully compatible with Android applications
- Example project provided for easy setup and usage
Android Studio 4.0+, Android API Level 24+ (Android 5.0+)
You can integrate the SDK into your Android app in three simple ways:
Add the following dependency to your app/build.gradle file:
dependencies {
implementation 'com.terminal3:gamepaysdk:1.0.2'
}- Setup Project Credentials: To run Demo app, you need to setup your server and project keys. Obtain these Paymentwall API credentials in the application settings of your Merchant Account at Paymentwall.com
object Constants {
// Endpoint on the merchant's server that make a charge requests to Brick API.
const val MERCHANT_CHARGE_ENDPOINT = "https://merchant-server.com/api/charge"
// Secure URL to which the 3DS widget will redirect after successful authentication.
// After redirection, the merchant should call MERCHANT_CHARGE_ENDPOINT again with the `token` to finalize the charge.
const val THREE_DS_RETURN_URL = "https://merchant-server.com/return-url"
// production test
const val PW_PROJECT_KEY = "";
const val PW_SECRET_KEY = ""; // Should be get from merchant's server
...
}- Run the Demo:
- Select your device/emulator
- Click Run button
Please check the demo app and the docs to see how to update your current code.
Version 1.0.1 Features:
- Initial release with core payment functionality
- Brick payment method support
- Automatic 3D Secure handling
- Comprehensive error handling
SDK integration requires a project keys. Obtain these Paymentwall API credentials in the application settings of your Merchant Account at Paymentwall.com
- Project Key: Your public project identifier
- Secret Key: Your private project secret (for server-side operations)
- Log in to your Paymentwall Merchant Account
- Go to Application Settings
- Find your project credentials
- Copy the Project Key and Secret Key
For detailed integration instructions, please refer to our comprehensive documentation:
- Implement Event Handler:
class MainActivityViewModel : ViewModel(), IGPAPIEventHandler {
init {
GPApi.setEventHandler(this)
}
override fun onResp(resp: BaseResp?) {
when (resp?.resultCode) {
ResponseCode.SUCCESSFUL -> {
isProcessing = false
paymentStatus = PaymentStatus.Success("Payment completed successfully!")
}
ResponseCode.FAILED -> {
isProcessing = false
paymentStatus = PaymentStatus.Failed("Payment failed!")
}
ResponseCode.CANCEL -> {
isProcessing = false
paymentStatus = PaymentStatus.Cancelled("Payment cancelled!")
}
ResponseCode.ERROR -> {
isProcessing = false
val errMessage = resp.data.getStringExtra("error_message") ?: "An error occurred!"
paymentStatus = PaymentStatus.Unknown(errMessage)
}
ResponseCode.MERCHANT_PROCESSING -> {
val serviceType = resp.data.getStringExtra(GPApi.KEY_SERVICE_TYPE) ?: ""
if (GPApi.SERVICE_TYPE_BRICK == serviceType) {
val email = resp.data.getStringExtra(GPApi.KEY_BRICK_EMAIL) ?: ""
val token = resp.data.getStringExtra(GPApi.KEY_BRICK_TOKEN) ?: ""
// Process the payment with current charge details
if (token.isNotEmpty() && email.isNotEmpty()) {
processPayment(token, email)
} else {
paymentStatus = PaymentStatus.Unknown("Invalid payment data received")
}
}
}
}
}
}
- Create a payment request:
class MainActivityViewModel : AppCompatActivity(), IGPAPIEventHandler {
fun createPaymentRequest(): UnifiedRequest {
val request = UnifiedRequest()
request.pwProjectKey = Constants.PW_PROJECT_KEY
request.pwSecretKey = Constants.PW_SECRET_KEY
request.amount = chargeAmount
request.currency = chargeCurrency
request.userId = uid
request.userEmail = Constants.USER_EMAIL
request.itemId = Constants.ITEM_GEM_ID
request.itemName = Constants.ITEM_NAME
request.merchantName = Constants.MERCHANT_NAME
request.timeout = 30000
request.signVersion = 3
request.addBrick()
request.enableFooter()
request.addGooglePay()
request.addPayAlto()
request.addPayAltoParams(Const.P.WIDGET, "t3_1")
request.addPayAltoParams(Const.P.COUNTRY_CODE, country)
return request
}
}- Start Payment:
class MainActivity : ComponentActivity() {
private fun createPaymentRequest() {
val request = vm.createPaymentRequest()
GPApi.sendReq(this, request)
}
}For technical support and questions:
- 📧 Email: integration@terminal3.com
- 📖 Documentation: Integration Guide
This project is licensed under the MIT License - see the LICENSE file for details.