In-Game Purchases

Enable players to purchase items, upgrades, or currency within your game to enhance their experience and generate revenue.

There are two types of purchases — permanent (e.g., ad removal) and consumable (e.g., in-game coins).

Support

Check if in-game purchases are supported to offer items or upgrades within the game.

bridge.payments.isSupported

Purchase

Allow players to buy items or upgrades in your game to enhance their gameplay experience.

let options = { }

switch (bridge.platform.id) {
    case 'yandex':
        options = {
            id: 'PURCHASE_ID' // ID from settings
        }
        break
}

bridge.payments.purchase(options)
    .then(() => {
        // success
    })
    .catch(error => {
        // error
    })

Consume Purchase

Consume purchased items, such as in-game currency, once they are used, to manage inventory and player progression.

let options = { }

switch (bridge.platform.id) {
    case 'yandex':
        options = {
            purchaseToken: 'PURCHASE_TOKEN' // token
        }
        break
}

bridge.payments.consumePurchase(options)
    .then(() => {
        // success
    })
    .catch(error => {
        // error
    })

Catalog of All Items

Retrieve a list of all available in-game items that players can purchase to display in the game store.

bridge.payments.getCatalog()
    .then(catalogItems => {
        // success
        switch (bridge.platform.id) {
            case 'yandex':
                catalogItems.forEach(catalogItem => {
                    console.log('ID: ' + catalogItem.id)
                    console.log('Title: ' + catalogItem.title)
                    console.log('Description: ' + catalogItem.description)
                    console.log('Image URI: ' + catalogItem.imageURI)
                    console.log('Price: ' + catalogItem.price)
                    console.log('Price Currency Code: ' + catalogItem.priceCurrencyCode)
                    console.log('Price Currency Image: ' + catalogItem.priceCurrencyImage)
                    console.log('Price Value: ' + catalogItem.priceValue)
                })
                break
        }
    })
    .catch(error => {
        // error
    })

List of Purchased Items

Retrieve a list of items that the player has purchased to manage their inventory and provide access to purchased content.

bridge.payments.getPurchases()
    .then(purchases => {
        // success
        switch (bridge.platform.id) {
            case 'yandex':
                purchases.forEach(purchase => {
                    console.log('Product ID: ' + purchase.productID)
                    console.log('Purchase Token: ' + purchase.purchaseToken)
                })
                break
        }
    })
    .catch(error => {
        // error
    })