com.adjust.sdk.purchase

These are the minimal steps required to integrate the adjust purchase SDK into your Cordova project. We are going to assume you are using the command line interface.

After you have added iOS and/or Android as a platform for your project, enter the following command in your project folder:

> cordova plugin add path_to_folder/cordova_purchase_sdk
Installing "com.adjust.sdk.purchase" for android
Installing "com.adjust.sdk.purchase" for ios

Add the following code to initialize the adjust purchase SDK in your index.js file, after you have received deviceready event:

var adjustPurchaseConfig = new ADJPConfig("{YourAppToken}", ADJPConfig.EnvironmentSandbox);

Adjust.init(adjustPurchaseConfig);

You can increase or decrease the amount of logs you see in tests by calling setLogLevel on your ADJPConfig instance with one of the following parameters:

adjustPurchaseConfig.setLogLevel(ADJPConfig.LogLevelVerbose);   // enable all logging
adjustPurchaseConfig.setLogLevel(ADJPConfig.LogLevelDebug);     // enable more logging
adjustPurchaseConfig.setLogLevel(ADJPConfig.LogLevelInfo);      // the default
adjustPurchaseConfig.setLogLevel(ADJPConfig.LogLevelWarn);      // disable info logging
adjustPurchaseConfig.setLogLevel(ADJPConfig.LogLevelError);     // disable warnings as well
adjustPurchaseConfig.setLogLevel(ADJPConfig.LogLevelAssert);    // disable errors as well

In order to verify in-app purchases, you need to call the verifyPurchaseiOS method on the AdjustPurchase instance for purchase verification on iOS, or the verifyPurchaseAndroid method for purchase verification on Android. Please make sure to call this method after the transaction has been finished and your item purchased.

// ...

// Purchase verification request on iOS.
AdjustPurchase.verifyPurchaseiOS("{Receipt}", "{TransactionId}", "{ProductId}", function(verificationInfo) {
    console.log("Verification State = " + verificationInfo.verificationState);
    console.log("Status code = " + verificationInfo.statusCode);
    console.log("Message = " + verificationInfo.message);
});

// Purchase verification request on Android.
AdjustPurchase.verifyPurchaseAndroid("{ItemSKU}", "{PurchaseToken}", "{DeveloperPayload}", function(verificationInfo) {
    console.log("Verification State = " + verificationInfo.verificationState);
    console.log("Status code = " + verificationInfo.statusCode);
    console.log("Message = " + verificationInfo.message);
});

// ...

Method of the adjust purchase SDK used to make iOS verification request exects you to pass following parameters:

Receipt         // App receipt
TransactionId   // Finished transaction identifier
ProductId       // Your purchased product identifier
Callback        // Callback method which will process the verification response

Method of the adjust purchase SDK used to make Android verification request exects you to pass following parameters:

ItemSKU           // Unique order ID (SKU)
ItemToken         // A token that uniquely identifies a purchase
DeveloperPayload  // A developer-specified string that contains supplemental information about an order
Callback          // Callback method which will process the verification response

As described in the code above, you need to pass a method which is going to process the verification response to the verifyPurchaseiOS or verifyPurchaseAndroid methods.

The response to purchase verification is represented with an ADJPVerificationInfo object and it contains following information:

verificationInfo.verificationState   // State of purchase verification.
verificationInfo.statusCode          // Integer which displays backend response status code.
verificationInfo.message             // Message describing purchase verification state.

The verification state can have one of the following values:

ADJPConfig.ADJPVerificationStatePassed         - Purchase verification successful.
ADJPConfig.ADJPVerificationStateFailed         - Purchase verification failed.
ADJPConfig.ADJPVerificationStateUnknown        - Purchase verification state unknown.
ADJPConfig.ADJPVerificationStateNotVerified    - Purchase was not verified.

• If the purchase was successfully verified by Apple/Google servers, ADJPVerificationStatePassed will be reported together with the status code 200.
• If the Apple/Google servers recognized the purchase as invalid, ADJPVerificationStateFailed will be reported together with the status code 406.
• If the Apple/Google servers did not provide us with an answer for our request to verify your purchase, ADJPVerificationStateUnknown will be reported together with the status code 204. This means that we did not recieve any information from Apple/Google servers regarding validity of your purchase. This does not say anything about the purchase itself. It might be both - valid or invalid. This state will also be reported if any other situation prevents us from reporting the correct state of your purchase verification. More details about these errors can be found in the message property.
• If ADJPVerificationStateNotVerified is reported, that means that the call to verifyPurchaseiOS or verifyPurchaseAndroid method was done with invalid parameters or that in general for some reason verification request was not even sent from the purchase SDK. Again, more information about error which caused this may be found in message property.

After a purchase is successfully verified, you can track it with our official adjust SDK and keep track of revenue in your dashboard. You can also pass in an optional transaction ID created in an event in order to avoid tracking duplicate revenues. The last ten transaction IDs are remembered and revenue events with duplicate transaction IDs are skipped.

At the moment, the transaction duplication protection mechanism is working only for the iOS platform.

Using the examples from above, you can do this as follows:

// ...

AdjustPurchase.verifyPurchaseiOS("{Receipt}", "{TransactionId}", function(verificationInfo) {
    if (verificationInfo.verificationState == ADJPConfig.ADJPVerificationStatePassed) {
        var adjustEvent = new AdjustEvent("{YourEventToken}");
        adjustEvent.setRevenue(0.01, "EUR");
        
        // iOS feature only!
        adjustEvent.setTransactionId("{TransactionId}");
        
        Adjust.trackEvent(adjustEvent);
    }
});

Once ADJPVerificationStatePassed or ADJPVerificationStateFailed are reported, you can be secure that this decision was made by Apple/Google servers and can rely on them to track or not to track your purchase revenue. Once ADJPVerificationStateUnknown is reported, you can decide what do you want to do with this purchase.

For statistical purposes, it may be wise to have a single defined event for each of these scenarios in the adjust dashboard. This way, you can have better overview of how many of your purchases was marked as passed, how many of them failed and how many of them were not able to be verified and returned an unknown status. You can also keep track of unverified purchases if you would like to.

If you decide to do so, your method for handling the response can look like this:

// ...

// Example shows verification request for iOS.
// Same logic applies for Android verification request as well.
AdjustPurchase.verifyPurchaseiOS("{Receipt}", "{TransactionId}", function(verificationInfo) {
    if (verificationInfo.verificationState == ADJPConfig.ADJPVerificationStatePassed) {
        var adjustEvent = new AdjustEvent("{YourEventPassedToken}");
        adjustEvent.setRevenue(0.01, "EUR");
        
        // iOS feature only!
        adjustEvent.setTransactionId("{TransactionId}");
        
        Adjust.trackEvent(adjustEvent);
    } else if (verificationInfo.verificationState == ADJPConfig.ADJPVerificationStateFailed) {
        var adjustEvent = new AdjustEvent("{YourEventFailedToken}");
        Adjust.trackEvent(adjustEvent);
    } else if (verificationInfo.verificationState == ADJPConfig.ADJPVerificationStateUnknown) {
        var adjustEvent = new AdjustEvent("{YourEventUnknownToken}");
        Adjust.trackEvent(adjustEvent);
    } else {
        var adjustEvent = new AdjustEvent("{YourEventNotVerifiedToken}");
        Adjust.trackEvent(adjustEvent);
    }
});

Purchase Verification is not intended to be used to approve/reject delivery of goods sold. Purchase Verification is intended to align reported transaction data with actual transaction data.

The adjust purchase SDK is licensed under the MIT License.