squarecordovaintegration's Introduction

Cordova Square Reader SDK

A Cordova plugin to interface with the native Square Reader SDK.

Install

$ cordova plugin add cordova-plugin-square-reader

$ cordova platform ios prepare

Install the Square SDK

Currently we only support iOS.

For more details refer Square Reader SDK Documentation.

Sub Step from Step 3 - "Update your Info.plist" can be skipped. Plugin will auto configure this.

Pair the card reader

NOTE: Square SDK needs to be authorized before initiating the pairing.

window['squarereader'].pairCardReaders(function () {
    console.log('Square card reader completed.');
}, function (err) {
    console.error('Square card reader pairing failed.');
    console.error(err);
});

Authorize and checkout

var retrieveAuthParams = {
    "personalAccessToken": "<YOUR PERSONAL ACCESS TOKEN>",
    "locationId": "<LOCATION ID OF>"
};
// Authorization code will be fetched from Square if previous authorization code is expired/empty
window['squarereader'].retrieveAuthorizationCode(retrieveAuthParams, function (response) {
    console.log("Application authorization code: " + response.authorization_code);

    var authorizeParams = {
        "authCode": response.authorization_code
    };

    window['squarereader'].authorizeReaderSDKIfNeeded(authorizeParams, function () {
        console.log("Application is authorized.");

        let checkoutParam = {
            "amount": "<AMOUNT_TO_AUTHORIZE"
        }
        window['squarereader'].startCheckout(checkoutParam, function (response) {
            console.log(response);
            console.log("Checkout completed successfully.");
        }, function (err) {
            console.error("Failed to checkout");
            console.error(err);
        });
    }, function (err) {
        console.log("Failed to authorize with retrieved authorization code.");
    });
}, function (err) {
    console.log('Failed to get the authorization code');
});