- creating a product within the Qonversion dashboard and associating it with a purchase action on your screen,
- implementing and providing a
PurchaseDelegateto Qonversion No-Codes that is responsible for managing purchase and restore requests from No-Code screens.
Unity warning
On Android, when a No-Codes screen is displayed, Unity’s game loop is paused because the No-Codes screen runs as a separate Activity on top of Unity’s Activity. This means that this delegate will only work on iOS, and will not work on Android.Implementing PurchaseDelegate
To handle purchase and restore requests from No-Code screens on your end, you should implement PurchaseDelegate. It has two simple methods - purchase, accepting the requested product, and restore.
extension MyPurchaseHandler: NoCodesPurchaseDelegate {
func purchase(product: Qonversion.Product) async throws {
// Execute the purchase as you wish here
// You can throw exceptions in case of errors
}
func restore() async throws {
// Execute the restore as you wish here
// You can throw exceptions in case of errors
}
}
// You can use either coroutine interface as follows:
class MyPurchasesHandler : PurchaseDelegate {
override suspend fun purchase(product: QProduct) {
// Execute the purchase as you wish here
// You can throw exceptions in case of errors
}
override suspend fun restore() {
// Execute the restore as you wish here
// You can throw exceptions in case of errors
}
}
// Or you can use callbacks interface:
class MyPurchaseHandler : PurchaseDelegateWithCallbacks {
override fun purchase(
product: QProduct,
onSuccess: PurchaseDelegateWithCallbacks.OnSuccess,
onError: PurchaseDelegateWithCallbacks.OnError
) {
// Execute the purchase as you wish here
// And call onSuccess once everything is done to close the No-Code screen
onSuccess()
// Call onError with exception in case of error.
}
override fun restore(
onSuccess: PurchaseDelegateWithCallbacks.OnSuccess,
onError: PurchaseDelegateWithCallbacks.OnError
) {
// Execute the restore as you wish here
// And call onSuccess once everything is done to close the No-Code screen
onSuccess()
// Call onError with exception in case of error.
}
}
class MyPurchasesHandler implements PurchaseDelegateWithCallbacks {
@Override
public void purchase(@NonNull QProduct product, @NonNull OnSuccess onSuccess, @NonNull OnError onError) {
// Execute the purchase as you wish here
// And call onSuccess once everything is done to close the No-Code screen
onSuccess.invoke();
// Call onError with exception in case of error.
}
@Override
public void restore(@NonNull OnSuccess onSuccess, @NonNull OnError onError) {
// Execute the restore as you wish here
// And call onSuccess once everything is done to close the No-Code screen
onSuccess.invoke()
// Call onError with exception in case of error.
}
}
class MyPurchaseDelegate implements PurchaseDelegate {
async purchase(product: Product): Promise<void> {
// Execute the purchase as you wish here
// You can throw exceptions in case of errors
}
async restore(): Promise<void> {
// Execute the restore as you wish here
// You can throw exceptions in case of errors
}
}
class MyPurchaseDelegate implements NoCodesPurchaseDelegate {
@override
Future<void> purchase(QProduct product) async {
// Execute the purchase as you wish here
// You can throw exceptions in case of errors
}
@override
Future<void> restore() async {
// Execute the restore as you wish here
// You can throw exceptions in case of errors
}
}
public class MyPurchaseDelegate : NoCodesPurchaseDelegate
{
public void Purchase(Product product, System.Action onSuccess, System.Action<string> onError)
{
// Execute the purchase as you wish here
// Call onSuccess() when purchase completes successfully
// Call onError("error message") in case of errors
try
{
// Your purchase logic here
onSuccess();
}
catch (System.Exception e)
{
onError(e.Message);
}
}
public void Restore(System.Action onSuccess, System.Action<string> onError)
{
// Execute the restore as you wish here
// Call onSuccess() when restore completes successfully
// Call onError("error message") in case of errors
try
{
// Your restore logic here
onSuccess();
}
catch (System.Exception e)
{
onError(e.Message);
}
}
}
class MyPurchaseDelegate implements Qonversion.PurchaseDelegate {
async purchase(product: Qonversion.Product): Promise<void> {
// Execute the purchase as you wish here
// You can throw exceptions in case of errors
}
async restore(): Promise<void> {
// Execute the restore as you wish here
// You can throw exceptions in case of errors
}
}
class MyPurchaseDelegate implements PurchaseDelegate {
async purchase(product: Product): Promise<void> {
// Execute the purchase as you wish here
// You can throw exceptions in case of errors
}
async restore(): Promise<void> {
// Execute the restore as you wish here
// You can throw exceptions in case of errors
}
}
Providing PurchaseDelegate
Once you’ve implemented the PurchaseDelegate, you need to provide it to Qonversion No-Codes. There are two equal ways to do it - during the initialization via configuration or after - via the No-Codes method.
// Providing during the initialization
let purchaseDelegate = MyPurchaseHandler()
let configuration = NoCodesConfiguration(projectKey: "projectKey", purchaseDelegate: purchaseDelegate)
NoCodes.initialize(with: configuration)
// Or after initialization
let purchaseDelegate = MyPurchaseHandler()
NoCodes.shared.set(purchaseDelegate: purchaseDelegate)
// Providing during the initialization
val purchaseDelegate = MyPurchaseHandler()
val noCodesConfig = NoCodesConfig.Builder(this, "projectKey")
.setPurchaseDelegate(purchaseDelegate)
.build()
NoCodes.initialize(noCodesConfig)
// Or after initialization
val purchaseDelegate = MyPurchaseHandler()
NoCodes.shared.setPurchaseDelegate(purchaseDelegate)
// Providing during the initialization
final PurchaseDelegateWithCallbacks purchaseDelegate = new MyPurchaseHandler();
final NoCodesConfig noCodesConfig = new NoCodesConfig.Builder(this, "projectKey")
.setPurchaseDelegate(purchaseDelegate)
.build();
NoCodes.initialize(noCodesConfig);
// Or after initialization
final PurchaseDelegateWithCallbacks purchaseDelegate = new MyPurchaseHandler();
NoCodes.getSharedInstance().setPurchaseDelegate(purchaseDelegate);
// Providing during the initialization
const purchaseDelegate = MyPurchaseHandler()
const noCodesConfig = new NoCodesConfigBuilder('projectKey')
.setPurchaseDelegate(purchaseDelegate)
.build();
NoCodes.initialize(noCodesConfig);
// Or after initialization
const purchaseDelegate = MyPurchaseHandler()
NoCodes.getSharedInstance().setPurchaseDelegate(purchaseDelegate);
// Providing during the initialization
final purchaseDelegate = MyPurchaseDelegate();
final noCodesConfig = NoCodesConfigBuilder('projectKey')
.setPurchaseDelegate(purchaseDelegate)
.build();
NoCodes.initialize(noCodesConfig);
// Or after initialization
final purchaseDelegate = MyPurchaseDelegate();
await NoCodes.getSharedInstance().setPurchaseDelegate(purchaseDelegate);
// Providing during the initialization
var purchaseDelegate = new MyPurchaseDelegate();
var noCodesConfig = new NoCodesConfigBuilder("projectKey")
.SetPurchaseDelegate(purchaseDelegate)
.Build();
NoCodes.Initialize(noCodesConfig);
// Or after initialization
var purchaseDelegate = new MyPurchaseDelegate();
NoCodes.GetSharedInstance().SetPurchaseDelegate(purchaseDelegate);
// Providing during the initialization
const purchaseDelegate = MyPurchaseHandler()
const noCodesConfig = new Qonversion.NoCodesConfigBuilder('projectKey')
.setPurchaseDelegate(purchaseDelegate)
.build();
Qonversion.NoCodes.initialize(noCodesConfig);
// Or after initialization
const purchaseDelegate = MyPurchaseHandler()
Qonversion.NoCodes.getSharedInstance().setPurchaseDelegate(purchaseDelegate);
// Providing during the initialization
const purchaseDelegate = MyPurchaseHandler()
const noCodesConfig = new NoCodesConfigBuilder('projectKey')
.setPurchaseDelegate(purchaseDelegate)
.build();
NoCodes.initialize(noCodesConfig);
// Or after initialization
const purchaseDelegate = MyPurchaseHandler()
NoCodes.getSharedInstance().setPurchaseDelegate(purchaseDelegate);
Availability
The described feature is available in the following SDK versions| Platform | SDK version |
|---|---|
| iOS | 6.1.0+ |
| Android | No-Codes 1.2.1+ |
| React Native | 10.1.0+ |
| Flutter | 11.1.0+ |
| Unity | 9.0.0+ |
| Cordova | 7.0.0+ |
| Capacitor | 1.0.0+ |
Success and Failure Actions Create Remote Config