Once the SDK is added to your project, using the Payment API can be done with the provided helper classes.


Receive POS information

Here you can find simple information about a myPOS terminal like TID, currency name, currency code, merchant information, etc.

MyPOSAPI.registerPOSInfo(MainActivity.this, new OnPOSInfoListener() {
            public void onReceive(POSInfo info) {
                //info is received


Make a payment

1. Make a payment

// Build the payment call
 MyPOSPayment payment = MyPOSPayment.builder()
         // Mandatory parameters
         // Foreign transaction ID. Maximum length: 128 characters
o // Optional parameters
o // Enable tipping mode
o .tippingModeEnabled(true)
o // Operator code. Maximum length: 4 characters
o .operatorCode("1234")
o // Reference number. Maximum length: 20 alpha numeric characters
o .reference("asd123asd", ReferenceType.REFERENCE_NUMBER)
o // card scheme brandnig
o .mastercardSonicBranding(true)
o .visaSensoryBranding(true)

 // Start the transaction
 MyPOSAPI.openPaymentActivity(MainActivity.this, payment, 1);


2. Handle the payment result

In your calling activity, override the onActivityResult method to handle the result of the payment:

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    // The same request code as when calling MyPOSAPI.openPaymentActivity
    if (requestCode == 1) {
        // The transaction was processed, handle the response
        if (resultCode == RESULT_OK) {
            // Something went wrong in the Payment core app and the result couldn't be returned properly
            if (data == null) {
                Toast.makeText(this, "Transaction cancelled", Toast.LENGTH_SHORT).show();
            int transactionResult = data.getIntExtra("status", TransactionProcessingResult.TRANSACTION_FAILED);

            Toast.makeText(this, "Payment transaction has completed. Result: " + transactionResult, Toast.LENGTH_SHORT).show();

            // TODO: handle each transaction response accordingly
            if (transactionResult == TransactionProcessingResult.TRANSACTION_SUCCESS) {
                // Transaction is successful
        } else {
            // The user cancelled the transaction
            Toast.makeText(this, "Transaction cancelled", Toast.LENGTH_SHORT).show();


Checking if the transaction is approved can be done by reading the transaction_approved boolean extra from the response:

boolean transaction_approved = data.getBooleanExtra("transaction_approved", false);

if (transaction_approved) {
    // Transaction is approved
} else {
    // Transaction was not approved
    // The response code is in the "response_code" string extra