Integration Details Between Merchant and WLPG SDK

This section provides detailed integration instructions for integrating the WLPG SDK with merchant mobile applications.

5.1 Integration of WLPG SDK to Merchant Application

5.1.1 Copy .aar File

The merchant must place the pgsdk.aar file in the merchant mobile application library directory:

app/libs/pgsdk.aar

5.1.2 Mapping .aar File to Gradle

In the merchant application's build.gradle (app module) file, add the following configuration:

repositories {
    flatDir {
        dirs 'libs'
    }
}

dependencies {
    implementation(name: 'pgsdk', ext: 'aar')
}

After updating the build.gradle file, Gradle must be synchronized to apply the changes.

5.1.3 Permissions

The merchant application must declare the following permission in AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

5.1.4 Initialize Transaction/Payments

The merchant application must invoke the SDK's initiatePayment API to initiate transactions with WLPG. The API requires the following parameters:

Required Parameters:

1. terminalId
2. terminalPassword
3. jwtUsername
4. jwtPassword
5. action
6. currencyCode
7. ipAddress
8. amount
9. trackId
10. firstName
11. lastName
12. countryCode
13. postalCode
14. administrativeArea
15. email
16. address1
17. locality
18. cardType
19. phoneNumber

Implementation Code:

val paymentData = PaymentData(
    terminalId,
    terminalPassword,
    jwtUsername,
    jwtPassword,
    action,
    currencyCode,
    ipAddress,
    amount,
    trackId,
    firstName,
    lastName,
    countryCode,
    postalCode,
    administrativeArea,
    email,
    address1,
    locality,
    cardType,
    phoneNumber
)

PGService().initiatePayment(
    this@CurrentActivity,
    paymentData,
    object : PGInterface {
        override fun onPGResult(result: PaymentResult) {
            // Handle payment result
        }
    }
)

Parameter Details:

5.1.5 Handle Payment Response

The SDK provides callback results through the onPGResult callback function. The payment result contains the following fields:

override fun onPGResult(result: PaymentResult) {
    // Process payment result
    val paymentId = result.paymentId
    val transactionResult = result.result
    val authCode = result.auth
    // Additional processing based on result
}

Payment Result Response Fields: