source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/visa/mpos.sdk.ios.pods.git'
use_frameworks!

target :"<your-app-target>" do
    pod 'payworks',           '2.65.0'
    pod 'payworks.paybutton', '2.65.0'
end

Open your
App.xcworkspace.
Payworks libraries contain Swift frameworks. To enable compatibility between Objective-C and Swift, create an empty Swift file in your project. Click
create bridging header
at the prompt that asks: "Would you like to configure an Objective-C bridging header?"
If you want to use the SceneUI approach introduced with iOS 13, be advised that it is only compatible with iOS 13 or higher.
For Bluetooth devices such as Miura card readers
: To connect as an external accessory and to receive messages while the app is running in the background, add these additional entries to your
Info.plist
:
Key: Supported external accessory protocols (
UISupportedExternalAccessoryProtocols
); Value:
com.miura.shuttle
(for Miura readers)
Key: Required background modes (
UIBackgroundModes
); Value: App communicates with an accessory (
external-accessory
)
Import the header in your view controller:

@import mpos_ui

- (IBAction)paymentButtonClicked:(id)sender {
    MPUMposUi *ui = [MPUMposUi initializeWithProviderMode:MPProviderModeMOCK
                                       merchantIdentifier:@"merchantIdentifier"
                                           merchantSecret:@"merchantSecretKey"];
    
    
    // Start with a mocked card reader:
    MPAccessoryParameters *ap = [MPAccessoryParameters mockAccessoryParameters];

    // When using the Bluetooth Miura, use the following parameters:
    // MPAccessoryParameters *ap = [MPAccessoryParameters externalAccessoryParametersWithFamily:MPAccessoryFamilyMiuraMPI
    //                                                                                 protocol:@"com.miura.shuttle"
    //                                                                                optionals:nil];


    // When using Verifone readers via WiFi or Ethernet, use the following parameters:
    // MPAccessoryParameters *ap = [MPAccessoryParameters tcpAccessoryParametersWithFamily:MPAccessoryFamilyVerifoneVIPA
    //                                                                              remote:@"192.168.254.123"
    //                                                                                port:16107
    //                                                                           optionals:nil];
    
    MPTransactionParameters *tp = [MPTransactionParameters chargeWithAmount:[NSDecimalNumber decimalNumberWithString:@"5.00"]
                                                                   currency:MPCurrencyEUR
                                                                  optionals:^(id<MPTransactionParametersOptionals>  _Nonnull optionals) {
                                                                      optionals.subject = @"Bouquet of Flowers";
                                                                      optionals.customIdentifier = @"yourReferenceForTheTransaction";
                                                                  }];
    
    ui.configuration.terminalParameters = ap;
    ui.configuration.summaryFeatures = MPUMposUiConfigurationSummaryFeatureSendReceiptViaEmail;

    // Add this if you would like to collect the customer signature on a printed merchant receipt
    //ui.configuration.signatureCapture = MPUMposUiConfigurationSignatureCaptureOnReceipt;
    
    
    UIViewController *viewController = [ui createTransactionViewControllerWithTransactionParameters:tp
                                                                                          completed:^(UIViewController * _Nonnull controller, MPUTransactionResult result, MPTransaction * _Nullable transaction)
                                        {
                                            [self dismissViewControllerAnimated:YES completion:NULL];
                                            
                                            UIAlertView* alert = [[UIAlertView alloc] initWithTitle:@"Result"
                                                                                            message:@""
                                                                                           delegate:nil
                                                                                  cancelButtonTitle:nil
                                                                                  otherButtonTitles:@"OK",nil];
                                            
                                            if (result == MPUTransactionResultApproved) {
                                                alert.message = @"Payment was approved!";
                                            } else {
                                                alert.message = @"Payment was declined/aborted!";
                                            }
                                            
                                            [alert show];
                                        }];
    
    
    UINavigationController *modalNav = [[UINavigationController alloc] initWithRootViewController:viewController];
    modalNav.navigationBar.barStyle = UIBarStyleBlack;
    if (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPhone) {
        modalNav.modalPresentationStyle = UIModalPresentationFullScreen;
    } else { // Show as Form on iPad
        modalNav.modalPresentationStyle = UIModalPresentationFormSheet;
    }
    [self presentViewController:modalNav animated:YES completion:NULL];
}

The
merchantIdentifier
and
merchantSecretKey
values, which identify to which merchant the payment is routed. You can create new merchants and get their credentials in the Gateway Manager.
Whether the merchant is a
TEST
or
LIVE
merchant.
The card reader model the merchant uses.

MPUMposUI *ui = 
    [MPUMposUI
        initializeWithProviderMode:<TEST or LIVE, loaded from your backend>
                merchantIdentifier:<MerchantIdentifier loaded from your backend>
                    merchantSecret:<MerchantSecretKey loaded from your backend>];

Set the tint of the navigation bar using
navigationBarTint
.
Set the color of the text in the navigation bar using
navigationBarTextColor
.

ui.configuration.appearance.navigationBarTint = [UIColor colorWithRed:0.61 green:0.15 blue:0.69 alpha:1];
ui.configuration.appearance.navigationBarTextColor = [UIColor whiteColor];

allprojects {
    repositories {
        jcenter()
        maven {
            url "https://repo.visa.com/mpos-releases/"
        }
    }
}

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:7.2.2"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.21"
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

android {
    ...
    compileOptions {
        sourceCompatibility = 1.8
        targetCompatibility = 1.8
    }

    buildTypes {
        release {
            // ...
        }
        debug {
            // Required for our internal libraries
            // https://developer.android.com/studio/build/dependencies#resolve_matching_errors
            matchingFallbacks = ['release']
        }
    }
    packagingOptions {       
         exclude 'META-INF/*'
         exclude 'LICENSE.txt'
         exclude 'asm-license.txt'
    }
}

plugins {
    id 'com.android.application'
    id 'kotlin-android'
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
 
    implementation 'io.payworks:mpos.android.ui:2.96.0'

    // Add these three dependencies if you want to use a Miura card reader
    implementation 'io.payworks:mpos.java.accessories.miura:2.96.0'
    implementation 'io.payworks:mpos.android.comlinks.bluetooth:2.96.0'
    implementation 'io.payworks:mpos.java.comlinks.tcp:2.96.0'
                    
    // Add these two dependencies if you want to use a Verifone card reader
    implementation 'io.payworks:mpos.java.accessories.vipa:2.96.0'
    implementation 'io.payworks:mpos.java.comlinks.tcp:2.96.0'
}

   
  <application
        [...]
        android:largeHeap="true">
            [...]
    </application>
                

void paymentButtonClicked() {
    MposUi ui = MposUi.initialize(this, ProviderMode.MOCK,
            "merchantIdentifier", "merchantSecretKey");

    ui.getConfiguration().setSummaryFeatures(EnumSet.of(
            // Add this line, if you do want to offer printed receipts
            // MposUiConfiguration.SummaryFeature.PRINT_RECEIPT,
            MposUiConfiguration.SummaryFeature.SEND_RECEIPT_VIA_EMAIL)
    );

    // Start with a mocked card reader:
    AccessoryParameters accessoryParameters = new AccessoryParameters.Builder(AccessoryFamily.MOCK)
                                                            .mocked()
                                                            .build();
    ui.getConfiguration().setTerminalParameters(accessoryParameters);

    // Add this line if you would like to collect the customer signature on the receipt (as opposed to the digital signature)
    // ui.getConfiguration().setSignatureCapture(MposUiConfiguration.SignatureCapture.ON_RECEIPT);


    /* When using the Bluetooth Miura, use the following parameters:
    AccessoryParameters accessoryParameters = new AccessoryParameters.Builder(AccessoryFamily.MIURA_MPI)
                                                                     .bluetooth()
                                                                     .build();
    ui.getConfiguration().setTerminalParameters(accessoryParameters);
    */




    /* When using Verifone readers via WiFi or Ethernet, use the following parameters:
    AccessoryParameters accessoryParameters = new AccessoryParameters.Builder(AccessoryFamily.VERIFONE_VIPA)
                                                                     .tcp("192.168.254.123", 16107)
                                                                     .build();
    ui.getConfiguration().setTerminalParameters(accessoryParameters);
    */

    TransactionParameters transactionParameters = new TransactionParameters.Builder()
                                                            .charge(new BigDecimal("5.00"), io.mpos.transactions.Currency.EUR)
                                                            .subject("Bouquet of Flowers")
                                                            .customIdentifier("yourReferenceForTheTransaction")
                                                            .build();

    Intent intent = ui.createTransactionIntent(transactionParameters);
    startActivityForResult(intent, MposUi.REQUEST_CODE_PAYMENT);}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {

    if (requestCode == MposUi.REQUEST_CODE_PAYMENT) {
        if (resultCode == MposUi.RESULT_CODE_APPROVED) {
            // Transaction was approved
            Toast.makeText(this, "Transaction approved", Toast.LENGTH_LONG).show();
        } else {
            // Card was declined, or transaction was aborted, or failed
            // (e.g. no internet or accessory not found)
            Toast.makeText(this, "Transaction was declined, aborted, or failed",
                    Toast.LENGTH_LONG).show();
        }
        // Grab the processed transaction in case you need it
        // (e.g. the transaction identifier for a refund).
        // Keep in mind that the returned transaction might be null
        // (e.g. if it could not be registered).
        Transaction transaction = MposUi.getInitializedInstance().getTransaction();
    }
}

The merchantIdentifier
and
merchantSecretKey
values. These values identify which merchant the payment is routed to. You can create new merchants and get their credentials in the Gateway Manager.
Whether the merchant is a
TEST
or
LIVE
merchant.
The card reader model the merchant uses.

MposUi ui = MposUi.initialize(this,
    <ProviderMode.TEST or ProviderMode.LIVE, loaded from your backend>,
    <MerchantIdentifier loaded from your backend>, <MerchantSecretKey loaded from your backend>);

Set the color of the icon and top action bar using
setColorPrimary
.
Set the color of the status bar using
setColorPrimaryDark
(Android L and later).
Set the primary text color using
setTextColorPrimary
.

ui.getConfiguration().getAppearance()
     .setColorPrimary(Color.parseColor("#9c27b0"))
     .setColorPrimaryDark(Color.parseColor("#7b1fa2"))
     .setTextColorPrimary(Color.WHITE);

1 2 3