Last updated
Last updated
Table 1 enumerates the response codes passed to the application from the ONE store service(OSS).
The application that implements the AIDL and the SDK must process all response codes.all the delivered intent through Activity.startAct
Table 1. Summary of Server Response Codes for IAP API Calls
This method proceeds with checking whether support is provided for the purchase before ONE store's in-app is used.
The application can check the status by calling this method before using the ONE store in-app.
Table 2. Response Data for isBillingSupported Request
getProductDetails() - Check In-App Product Information
This method returns in-app product details that match the In-App ID.
Details of the String ArrayList which is mapped to the passed productDetailList key are summarized in Table 4.
Table 3. Response Data for getProductDetails Request
Table 4. Description of JSON Field for productDetailList of Response Data for getProductDetails Request
This is a response method for the 'request purchase' and returns the purchaseIntent for proceeding with the purchase as a response value.
If the application calls Activity.startActivityForResult() by using the purchaseIntent, the payment flow will be performed.
When the payment is completed, the end response to the 'request purchase' will be received in the intent.
Data returned to the response intent is summarized in Table 6.
Table 5. Response Data for getPurchaseIntent Request
Table 6 provides the description of the intent field delivered through onActivityResult() when the purchase is completed in the application.
Table 6. Intent Field Passed to onActivityResult() When Purchase Is Completed
Table 7 provides the description of the purchaseData JSON field which is the purchase information field within the intent field passed when the purchase is completed.
Table 7. purchaseData Field in Intent Field Passed to onActivityResult() When Purchase Is Completed
This is a method for the 'request purchase' and can deliver in addition the contents defined in Table 8 when the purchase is requested.
The gameUserId and promotionApplicable which are additional parameters are used to limit the participation in promotions.
As the response value of this method, the purchaseIntent for performing the purchase is returned.
Table 8. Extra Bundle data
The gameUserId, protectionApplicable parameters are optional and must be used only in advance for the promotion with ONE store department manager. In general, the value should not be sent. In addition, the gameUserId should be sent to a hashed unique value so that there is no privacy information protection issue when sending values in advance.
If the application calls Activity.startActivityForResult() by using the purchaseIntent, the payment flow is performed.
When the payment is completed, the end response to the 'request purchase' will be received in the intent.
Data returned to the response intent is summarized in Table 10.
Table 9. Response Data for getPurchaseIntentExtraParam Request
Table 10 provides the description of the intent field delivered through onActivityResult() when the purchase is completed in the application.
Table 10. Intent Field Passed to onActivityResult() When Purchase Is Completed
Table 11 provides the description of the purchaseData JSON field which is the purchase information field within the intent field passed when the purchase is completed.
Table 11. purchaseData Field in Intent Field Passed to onActivityResult() When Purchase Is Completed
This is a method to request the ONE store login in the application when the user has no ONE store account or receives an error code that requires the ONE store login. This method returns the loginIntent for performing a login as the response value.
If the application calls Activity.startActivityForResult() by using the loginIntent, the login flow will be performed. When the login is completed, the end response to the 'request login' will be received. Data returned after calling Activity.startActivityForResult() is summarized in Table 13.
Table 12. Response Data for getLoginIntent Request
Table 13 provides the description of the response value delivered through onActivityResult() when the login is completed in the application.
Table 13. Response Value Passed to onActivityResult() When Login Is Completed
This method returns the list of the in-app products that are not consumed after the user purchased the consumable items. When the value of the consumable items which are not consumed is returned, developers are required to consume such consumable items by using the consumePurchase() API. When it comes to the purchased subscription item, the purchase information of the subscription item will be returned while the automatic payment is being made or if the subscription item is reserved to be cancelled .
Table 14. Response Data for getPurchases Request
Table 15 is the description of JSON field for the purchaseDetailList during the response to the getPurchase request.
Table 15. Description of JSON Field for productDetailList of Response Data for getPurchase Request
This method is used for requesting the consumption of the in-app product for the purchased consumable product by using the getPurchaseIntent method.
When the in-app product is consumed, use the purchaseId included in the purchase information, and if successful, return this purchaseId value to the response data.
Table 16 is the response data value for the consumePurchase request.
Table 16. Response Data for consumePurchase Request
For the subscription which is purchased using the getPurchaseIntent method, this method is used to request to reserve the cancellation of the subscription and to reverse the reservation of the product cancellation.
When there is a request
Table 17 is the response data value for the manageRecurringProduct request.
Table 17. Response Data for manageRecurringProduct Request