Purchase verification

If you’ve enabled purchase verification, you can use the Adjust SDK to request purchase verification.

When you send purchase information with the Adjust SDK, Adjust does the following:

Sends the information to the relevant store and waits for a status response.
Forwards the status response to the Adjust SDK.

You can access the purchase verification status by using a callback. Results are returned as AdjustPurchaseVerificationResult objects containing the following properties:

verificationStatus (string): The status of the purchase.
code (number): The status code of the purchase.
message (string): Any message returned by the store.

There are two ways to verify purchases with the Adjust SDK.

Verify purchase and record event

With this approach, you will be performing verification of your purchase and having an event recorded for that verification. This will give you an overview later in the dashboard on the events (and assigned revenue) based on whether verification was successful or not.

In order to do this, you need to complete your in-app purchase and then pass parameters that Adjust SDK needs out of that purchase in order to be able to try to verify the purchase. Once you have obtained the verification parameters the SDK needs, you can perform verification and recording of an event by calling verifyAndTrackAppStorePurchase or verifyAndTrackPlayStorePurchase methods.

Next to revenue and currency of the purchase, you need to obtain the following parameters as well:

Product ID (for both, App Store and Play Store purchases)
Transaction ID (for App Store purchases)
Purchase token (for Play Store purchases)

App Store
Google Play

1
local adjust = require "plugin.adjust"
2
local json = require "json"
3

4
-- perform App Store in-app purchase
5

6
-- create an event with purchase parameters attached
7
adjustEvent = {}
8
adjustEvent.eventToken = "abc123"
9
adjustEvent.revenue = 6.0
10
adjustEvent.currency = "EUR"
11
adjustEvent.transactionId = "transaction-id"
12
adjustEvent.productId = "product-id"
13

14
-- call verifyAndTrackAppStorePurchase method
15
adjust.verifyAndTrackAppStorePurchase(adjustEvent, function(result)
16
    local json_verification_result = json.decode(result.message)
17
    print("Verification status: " .. json_verification_result.verificationStatus)
18
    print("Code: " .. json_verification_result.code)
19
    print("Message: " .. json_verification_result.message)
20
end)

1
local adjust = require "plugin.adjust"
2
local json = require "json"
3

4
-- perform Play Store in-app purchase
5

6
-- create an event with purchase parameters attached
7
adjustEvent = {}
8
adjustEvent.eventToken = "abc123"
9
adjustEvent.revenue = 6.0
10
adjustEvent.currency = "EUR"
11
adjustEvent.productId = "product-id"
12
adjustEvent.purchaseToken = "purchase-token"
13

14
-- call verifyAndTrackPlayStorePurchase method
15
adjust.verifyAndTrackPlayStorePurchase(adjustEvent, function(result)
16
    local json_verification_result = json.decode(result.message)
17
    print("Verification status: " .. json_verification_result.verificationStatus)
18
    print("Code: " .. json_verification_result.code)
19
    print("Message: " .. json_verification_result.message)
20
end)

Only verify purchase

In case you don’t want to see revenue events being automatically recorded once you verify the purchase, but you are instead interested in just getting the information on the validity of the purchase, you can also perform only the verification of the purchase. For this, you need to invoke verifyAppStorePurchase and verifyPlayStorePurchase methods.

App Store
Google Play

1
local adjust = require "plugin.adjust"
2
local json = require "json"
3

4
-- perform App Store in-app purchase
5

6
-- create a purchase map with purchase parameters attached
7
adjustPurchase = {}
8
adjustPurchase.transactionId = "transaction-id"
9
adjustPurchase.productId = "product-id"
10

11
-- call verifyAppStorePurchase method
12
adjust.verifyAppStorePurchase(adjustPurchase, function(result)
13
    local json_verification_result = json.decode(result.message)
14
    print("Verification status: " .. json_verification_result.verificationStatus)
15
    print("Code: " .. json_verification_result.code)
16
    print("Message: " .. json_verification_result.message)
17
end)

1
local adjust = require "plugin.adjust"
2
local json = require "json"
3

4
-- perform Play Store in-app purchase
5

6
-- create a purchase map with purchase parameters attached
7
adjustPurchase = {}
8
adjustPurchase.productId = "product-id"
9
adjustPurchase.purchaseToken = "purchase-token"
10

11
-- call verifyPlayStorePurchase method
12
adjust.verifyPlayStorePurchase(adjustPurchase, function(result)
13
    local json_verification_result = json.decode(result.message)
14
    print("Verification status: " .. json_verification_result.verificationStatus)
15
    print("Code: " .. json_verification_result.code)
16
    print("Message: " .. json_verification_result.message)
17
end)