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.

playgama_bridge_payments_is_supported()

Check if getting catalog is supported.

playgama_bridge_payments_is_get_catalog_supported()

Check if getting purchases list is supported.

playgama_bridge_payments_is_get_purchases_supported()

Check if purchase consuming is supported.

playgama_bridge_payments_is_consume_purchase_supported()

Purchase

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

var options
switch playgama_bridge_platform_id() {
    case "yandex":
        options = {
            "id": "PRODUCT_ID"
        }
        break
    case "facebook":
        options = {
            "productID": "PRODUCT_ID"
        }
        break
    case "playdeck":
        options = { 
            "amount": 1,
            "description": "DESCRIPTION",
            "externalId": "EXTERNAL_ORDER_ID" // Unique order identifier in your system, which you can use to check in postback that payment was successful
        }
        break
}

playgama_bridge_payments_purchase(json_stringify(options))

// callback via Async Social Event
if async_load[? "type"] == "playgama_bridge_payments_purchase_callback" {
    if async_load[? "success"] {
        // your logic here
    }
}

// callback via script
function playgama_bridge_payments_purchase_callback(success, data) {
    if success {
        // your logic here
    }
}

Consume Purchase

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

var options
switch playgama_bridge_platform_id() {
    case "yandex":
        options = {
            "purchaseToken": "PURCHASE_TOKEN"
        }
        break
    case "facebook":
        options = {
            "purchaseToken": "PURCHASE_TOKEN"
        }
        break
}

playgama_bridge_payments_consume_purchase(json_stringify(options))

// callback via Async Social Event
if async_load[? "type"] == "playgama_bridge_payments_consume_purchase_callback" {
    if async_load[? "success"] {
        // your logic here
    }
}

// callback via script
function playgama_bridge_payments_consume_purchase_callback(success) {
    if success {
        // your logic here
    }
}

Catalog of All Items

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

playgama_bridge_payments_get_catalog()

// callback via Async Social Event
if async_load[? "type"] == "playgama_bridge_payments_get_catalog_callback" {
    if async_load[? "success"] {
        var catalog = json_parse(async_load[? "success"])
    }
}

// callback via script
function playgama_bridge_payments_get_catalog_callback(success, data) {
    if success {
        var catalog = json_parse(data)
    }
}

List of Purchased Items

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

playgama_bridge_payments_get_purchases()

// callback via Async Social Event
if async_load[? "type"] == "playgama_bridge_payments_get_purchases_callback" {
    if async_load[? "success"] {
        var purchases = json_parse(async_load[? "success"])
    }
}

// callback via script
function playgama_bridge_payments_get_purchases_callback(success, data) {
    if success {
        var purchases = json_parse(data)
    }
}