google::play::billing::LaunchPurchaseFlowParams

#include <billing/models.h>

Params for launching the purchase flow.

Summary

See BillingClient::LaunchPurchaseFlow for more details.

Public attributes

is_offer_personalized = false
bool
Specifies whether the offer is personalized to the buyer.
obfuscated_account_id
std::string
The obfuscated account id for the purchase.
obfuscated_profile_id
std::string
The obfuscated profile id for the purchase.
offer_token
std::string
Unique token representing the product offer that is being purchased.
quantity = 1
int64_t
The quantity of the product requested to be purchased.

Public attributes

is_offer_personalized

bool google::play::billing::LaunchPurchaseFlowParams::is_offer_personalized = false

Specifies whether the offer is personalized to the buyer.

This is used to disclose to the buyer that the product's price was personalized using automated decision-making.

You must consult Art. 6 (1) (ea) CRD of the Consumer Rights Directive 2011/83/EU to determine if the price you are offering to users is personalized.

obfuscated_account_id

std::string google::play::billing::LaunchPurchaseFlowParams::obfuscated_account_id

The obfuscated account id for the purchase.

If non-empty, specifies an optional obfuscated string that is uniquely associated with the purchaser's user account in your game.

If you specify this value, Google Play can use it to detect irregular activity, such as many devices making purchases on the same account in a short period of time. Do not use this field to store any Personally Identifiable Information (PII) such as emails in cleartext. Attempting to store PII in this field will result in purchases being blocked. Google Play recommends that you use either encryption or a one-way hash to generate an obfuscated identifier to send to Google Play.

This identifier is limited to 64 characters.

Leave empty if you do not want to specify an obfuscated account id.

obfuscated_profile_id

std::string google::play::billing::LaunchPurchaseFlowParams::obfuscated_profile_id

The obfuscated profile id for the purchase.

If non-empty, specifies an optional obfuscated string that is uniquely associated with the purchaser's user profile in your game.

If you specify this value, Google Play can use it to detect irregular activity, such as many devices making purchases on the same account in a short period of time. Do not use this field to store any Personally Identifiable Information (PII) such as emails in cleartext. Attempting to store PII in this field will result in purchases being blocked. Google Play recommends that you use either encryption or a one-way hash to generate an obfuscated identifier to send to Google Play.

This identifier is limited to 64 characters.

Leave empty if you do not want to specify an obfuscated profile id.

offer_token

std::string google::play::billing::LaunchPurchaseFlowParams::offer_token

Unique token representing the product offer that is being purchased.

quantity

int64_t google::play::billing::LaunchPurchaseFlowParams::quantity = 1

The quantity of the product requested to be purchased.

This value defaults to 1 and must be greater than 0. The product must also have multi-quantity enabled.

Note that the quantity of the product purchased is not guaranteed to be the quantity requested. The buyer may have the option to change the quantity of the product to be purchased during the checkout process. On a successful purchase, the actual quantity of the product purchased is returned in ProductPurchaseDetails::quantity.

Note that support for multi-quantity checkout may not be available in some countries / regions. If the buyer or the product is not eligible for multi-quantity checkout, only a single product will be purchased.

Note that usage of this parameter requires your application to be allow-listed. Please contact your Google Partner if your game requires access.