Purchase manually

Purchasely provides customizable presentation templates you but if you want to create your own and only use Purchasely for handling the purchase process you can. We offer methods to:

  • Get a product

  • Get a plan

  • Get a users subscriptions

  • Purchase a product

  • Restore all products

Getting all products

Swift
Objective-C
Kotlin
Java
React Native
Cordova
Swift
Purchasely.allProducts(success: { (products) in
// Returns an array of products and its available plans
}, failure: { (error) in
// Display error
})
Objective-C
[Purchasely allProductsWithSuccess:^(NSArray<PLYProduct *> * _Nonnull products) {
NSLog(@"%ld products available", products.count);
}
failure:^(NSError * _Nullable error) {
NSLog(@"Error %@", error);
}];
Kotlin
Purchasely.allProducts(
onSuccess = { products ->
// Returns an array of products and its available plans
},
onError = {
// display error
}
)
Java
Purchasely.allProducts(new ProductsListener() {
@Override
public void onSuccess(@NonNull List<PLYProduct> list) {
// Returns an array of products and its available plans
}
@Override
public void onFailure(@NonNull Throwable throwable) {
// Display error
}
});
React Native
const products = await Purchasely.allProducts();
console.log('Products', products);
Cordova
Purchasely.allProducts(products => {
console.log("Products " + products);
}, (error) => {
console.log(error);
}
);

Getting a product

Swift
Objective-C
Kotlin
Java
React Native
Cordova
Swift
Purchasely.product(with: "PRODUCT_VENDOR_ID", success: { (product) in
// Returns a product and its available plans
}, failure: { (error) in
// Display error
})
Objective-C
[Purchasely productWith:@"PRODUCT_VENDOR_ID" success:^(PLYProduct * _Nonnull) {
// Display the product and its plans
} failure:^(NSError * _Nullable) {
// Display error
}];
Kotlin
Purchasely.product("PRODUCT_VENDOR_ID",
onSuccess = { product ->
// Returns a product and its available plans
},
onError = { throwable ->
//display an error
}
)
Java
Purchasely.product("PRODUCT_VENDOR_ID", new ProductListener() {
@Override
public void onSuccess(@Nullable PLYProduct product) {
// Returns a product and its available plans
}
@Override
public void onFailure(@NotNull Throwable throwable) {
//display an error
}
});
React Native
try {
const product = await Purchasely.productWithIdentifier('PRODUCT_VENDOR_ID');
console.log(' ==> Product');
console.log(product.vendorId);
console.log(product.name);
console.log(product.plans);
} catch (e) {
console.log(e);
}
Cordova
Purchasely.productWithIdentifier('PRODUCT_VENDOR_ID', (product) => {
console.log(' ==> Product');
console.log(product.vendorId);
console.log(product.name);
console.log(product.plans);
}, (error) => {
console.log(error);
});

Getting a plan

Swift
Objective-C
Kotlin
Java
React Native
Cordova
Swift
Purchasely.plan(with: "PLAN_VENDOR_ID", success: { (plan) in
// Use the plan to display a price or start a purchase
}, failure: { (error) in
// Display error
})
Objective-C
[Purchasely planWith:@"PLAN_VENDOR_ID" success:^(PLYPlan * plan) {
// Use the plan to display a price or start a purchase
} failure:^(NSError * error) {
// Display error
}];
Kotlin
Purchasely.plan("PLAN_VENDOR_ID",
onSuccess = { plan ->
// Use the plan to display a price or start a purchase
},
onError = { throwable ->
//display an error
}
)
Java
Purchasely.plan("PLAN_VENDOR_ID", new PlanListener() {
@Override
public void onSuccess(@Nullable PLYPlan plan) {
// Use the plan to display a price or start a purchase
}
@Override
public void onFailure(@NotNull Throwable throwable) {
//display an error
}
});
React Native
try {
const plan = await Purchasely.planWithIdentifier('PLAN_VENDOR_ID');
console.log(' ==> Plan');
console.log(plan.vendorId);
console.log(plan.name);
console.log(plan.price);
console.log(plan.amount);
console.log(plan.period);
console.log(plan.hasIntroductoryPrice);
console.log(plan.introPrice);
console.log(plan.introAmount);
console.log(plan.introDuration);
} catch (e) {
console.log(e);
}
Cordova
Purchasely.planWithIdentifier('PLAN_VENDOR_ID', (plan) => {
console.log(' ==> Plan');
console.log(plan.vendorId);
console.log(plan.name);
console.log(plan.price);
console.log(plan.amount);
console.log(plan.period);
console.log(plan.hasIntroductoryPrice);
console.log(plan.introPrice);
console.log(plan.introAmount);
console.log(plan.introDuration);
}, (error) => {
console.log(error);
});

Purchasing a plan

Swift
Objective-C
Kotlin
Java
React Native
Cordova
Swift
Purchasely.purchase(plan: plan, success: {
// Unlock / reload content and display a success / thank you message to user
}, failure: { (error) in
// Display error
})
Objective-C
[Purchasely purchaseWithPlan:plan success:^{
// Unlock / reload content and display a success / thank you message to user
} failure:^(NSError * error) {
// Display error
}];
Kotlin
Purchasely.purchase(this@MainActivity, plan, object: PurchaseListener {
override fun onPurchaseStateChanged(state: State) {
when(state) {
is State.PurchaseComplete -> //Display success purchase
is State.NotAvailable -> //Purchase is not available on this device
is State.Error -> //An error happened, look at state.error
is State.PurchaseDeferred -> //Purchase was made but verification did not happen yet
else -> //look at all possible states for the one you may want to handle
}
}
})
Java
Purchasely.purchase(this, plan, (PurchaseListener) state -> {
if(state instanceof State.PurchaseComplete) {
//Display success purchase
} else if(state instanceof State.NotAvailable) {
//Purchase is not available on this device
} else if(state instanceof State.Error) {
//An error happened, look at state.error
} else if(state instanceof State.PurchaseDeferred) {
//Purchase was made but verification did not happen yet
} else {
//look at all possible states for the one you may want to handle
}
});
React Native
try {
const plan = await Purchasely.purchaseWithPlanVendorId(
'PLAN_VENDOR_ID'
);
console.log('Purchased ' + plan);
} catch (e) {
console.log(e);
}
Cordova
Purchasely.purchaseWithPlanVendorId("PLAN_VENDOR_ID", (plan) => {
console.log('Purchased ' + plan);
}, (error) => {
console.log(error);
});

Restoring all products

Swift
Objective-C
Kotlin
Java
React Native
Cordova
Swift
Purchasely.restoreAllProducts(success: {
// Reload content and display a success / thank you message to user
}, failure: { (error) in
// Display error
})
Objective-C
[Purchasely restoreAllProductsWithSuccess:^{
// Reload content and display a success / thank you message to user
} failure:^(NSError * _Nonnull) {
// Display error
}];
Kotlin
Purchasely.restoreAllProducts(object: PurchaseListener {
override fun onPurchaseStateChanged(state: State) {
when(state) {
is State.RestorationComplete -> //Display success restoration
is State.RestorationNoProducts -> //No products to restore
is State.RestorationFailed -> //An error happened, look at state.error
else -> //look at all possible states for the one you may want to handle
}
}
})
Java
Purchasely.restoreAllProducts((PurchaseListener) state -> {
if(state instanceof State.RestorationComplete) {
//Display success restoration
} else if(state instanceof State.RestorationNoProducts) {
//No products to restore
} else if(state instanceof State.RestorationFailed) {
//An error happened, look at state.error
} else {
//look at all possible states for the one you may want to handle
}
});
React Native
try {
const restored = await Purchasely.restoreAllProducts();
console.log('Restoration success ? ' + restored);
} catch (e) {
console.log(e);
}
Cordova
Purchasely.restoreAllProducts(() => {
console.log("Successfully restored");
}, (error) => {
console.log("Restoration failed: " + error);
});

Getting user subscriptions

Swift
Objective-C
Kotlin
Java
React Native
Cordova
Swift
Purchasely.userSubscriptions(success: { (subscriptions) in
// Subscription object contains the plan purchased and the source it was purchased from (iOS or Android)
// Calling unsubscribe() will either switch the user to its AppStore settings
// or display a procedure on how to unsubscribe on Android
}, failure: { (error) in
// Display error
})
Objective-C
[Purchasely userSubscriptionsWithSuccess:^(NSArray<PLYSubscription *> * _Nullable) {
// Subscription object contains the plan purchased and the source it was purchased from (iOS or Android)
// Calling unsubscribe() will either switch the user to its AppStore settings
// or display a procedure on how to unsubscribe on Android
} failure:^(NSError * _Nullable) {
// Display error
}];
Kotlin
Purchasely.userSubscriptions(
onSuccess = { list ->
// Subscription object contains the plan purchased and the source it was purchased from (iOS or Android)
// Calling unsubscribe() will either switch the user to its Google Play settings
// or display a procedure on how to unsubscribe on iOS
},
onError = { throwable ->
//Display error
}
)
Java
Purchasely.userSubscriptions(new SubscriptionsListener() {
@Override
public void onSuccess(@NotNull List<PLYSubscriptionData> list) {
// Subscription object contains the plan purchased and the source it was purchased from (iOS or Android)
// Calling unsubscribe() will either switch the user to its Google Play settings
// or display a procedure on how to unsubscribe on iOS
}
@Override
public void onFailure(@NotNull Throwable throwable) {
//Display error
}
});
React Native
try {
const subscriptions = await Purchasely.userSubscriptions();
console.log(' ==> Subscriptions');
if (subscriptions[0] !== undefined) {
console.log(subscriptions[0].plan);
console.log(subscriptions[0].subscriptionSource);
console.log(subscriptions[0].nextRenewalDate);
console.log(subscriptions[0].cancelledDate);
}
} catch (e) {
console.log(e);
}
Cordova
Purchasely.userSubscriptions(subscriptions => {
console.log("Subscriptions " + subscriptions);
}, (error) => {
console.log(error);
}
);