Payments

Prerequisite Information

The following section features some questions to ascertain the precise integration scenario for ‘No Code Payment’.

• Have you encrypted your APK with services like SafetyNet? (Yes /No)
  • Yes – If you have encrypted your APK using services such as SafetyNet, then you must integrate now.gg Payment SDK.
  • No – Continue to the next question.
• How do you verify Payments in your app? (Select from drop-down)
  • Server side
    • Continue to Payment Configurations.
  • Client side
    • If you have enabled client-side payment verification, then you must integrate now.gg Payment SDK.
  • Don’t Verify
    • Select your APK and In-app Products.

Payment Configurations

Use the following information based on your selection in the Prerequisite Information section:

To add In-app products:

• Login to nowStudio.
• Click on All Apps
  • Click on View Details against your app name.
• Click on Payments on the top navigation.
• Click on In-App Products section on the left sidebar.
• Select either:
  • Bulk Import
  • Add Product

Bulk Import

Using this option, you can bulk import your in-app products to nowStudio.

To do this:

• Click on Bulk Import button on the top-right corner.
• Click on the + icon, as shown below:
  
• Select the .csv file containing your in-app products
  (You should prepare the CSV file based on the provided format. Download the CSV format by clicking on the ‘Download CSV Format’ link.)
• Enable base currency (Optional)
  • If you enable the base currency option, we will update any products without a price listed for specific regions in the CSV.
    • The new price for that region will be based on the selected base price and the latest currency exchange rate.
• Select a Base Currency from the drop-down list.
• Click on Import.

Add Product

Note: nowStudio enables you to add translations for in-app products to provide a localized experience for your users worldwide. If a user’s language preference matches the translation languages you’ve added, they’ll see the translated version for your IAP products.

To do this, provide us with:

• Product ID
• Display Title
  • This field supports multiple values (translations) separated by a new line. Refer here for more information.
• Description
  • This field supports multiple values (translations) separated by a new line. Refer here for more information.
• Icon – Click on Pick file
  • Dimensions – 1024 x 1024px
  • Image format – .JPG, .JPEG, .PNG
  • Maximum size – 10 Mb
• Select Pricing
  You may select/create a price template or set a custom price for the product you are adding.
  
  • Price Template
    • Select a previously created price template or
    • Create a New Price Template
      • Click on Manage Templates
      • After creating the template, you can select it.
  • Custom Price
    • Click on Set Custom Price
    • Enter the Default price
      • Based on the default price you entered, all country-specific prices will be calculated using the exchange rates at the time.
      • You may also provide custom country-specific prices.
    • Click on Save.
  • Base Price for your product is fetched from the selected price template or the set custom price.
    • You can click on View Local Price to convert the listed base price into your currency.
    • If required, you may edit the Price Template / Custom Price.
• Click on Save.
  Once the product is added, it will be displayed within the in-app products section:
  
• You can also export the added in-app products by clicking on Export CSV , as shown above.

Modify in-app product

To modify an added in-app product:

• Within the In-app Products section:
  • Click on View Details in front of the in-app product you wish to modify.
• Once you have made the required changes, click on Save.

Delete Product

To delete an added in-app product:

• Within the In-app Products section:
  • Click on View Details in front of the in-app product you wish to delete.
  • Click on Delete in the bottom corner.
  • On the confirmation window, click Delete.
• The in-app product will be removed.

To add subscriptions:

• Login to nowStudio.
• Click on All Apps
  • Click on View Details against the app for which you want to create a subscription.
• Click on Payments on the top navigation.
• Click on Subscriptions section on the left sidebar.
• Click on Create Subscription in the top-right corner.

Create Subscription

Note: nowStudio enables you to add translations for subscriptions to provide a localized experience for your users worldwide. If a user’s language preference matches the translation languages you’ve added, they’ll see the translated version.

To do this, provide us with:

• Product ID
  • Product ID can only include numbers, lowercase and uppercase letters, underscores, and periods.
• Subscription Details
  • Name
    • Short name for your subscription. Users will see this in emails.
    • This field supports multiple values (translations) separated by a new line. Refer here for more information.
  • Description
    • An optional description for your subscription.
    • This field supports multiple values (translations) separated by a new line. Refer here for more information.
  • Benefits
    • Click on Add Benefit and include up to 4 benefits to help users understand what they get when they subscribe.
    • This field supports multiple values (translations) separated by a new line. Refer here for more information.
• Billing Period
  • Select the billing period for your subscription from the drop-down list.
  • The supported billing period include:
    • Monthly (Default selection)
    • Weekly
    • Every 4 weeks
    • Every 2 months
    • Every 3 months
    • Every 4 months
    • Every 6 months
    • Every 8 months
    • Yearly
• Select Pricing
  • Use the drop-down menu to:
    • Select a previously created price template, or
    • Create a New Price Template If you haven’t created one.
      • After creating the template, you can select it.
      • Click on Edit Template, to edit the selected price template.
        • Price templates can be reused across multiple apps that you add.
        • To manage and configure your price templates, please follow this link.
  • Base Price for your product is fetched from the selected price template.
    • You can click on View Local Price to view or convert the listed base price into your currency.
• Click on Save.
  Once the Subscription is added, it will be displayed within the Subscriptions section:
  

Subscription Status Callback API

(Developer Provided)

This section illustrates the API specs for you to provide us with a SubscriptionStatusCallback API to send subscription status updates.

The following is the associated workflow:

• nowStudio will use this API to send the request data to your game backend.
• Your game backend can authenticate the request using the API key provided by us (Webhook API Key).
• You can assign the purchase entitlement to the user based on the subscription’s current status. (Defined here).
• After we send the request data using the callback URL you have provided, we will wait for a response from your API.
  • If we do not get a response with status code 200 with success as true, we will keep retrying for some time.

 POST

Authorization: "<API-Key Here>"
 Content-type: application/json

{
     "success": true, 
     "reason": "reason_for_failure". // Optional Param. Only required if success is false. 
 }