Documentation

ASEANDCB – ASEAN Direct Carrier Billing
Software Development Kit

16th April 2015
Forest Interactive Sdn. Bhd.
Ardiansa Rachmawan

DISCLAIMER:
No part of this document may be disclosed orally, in writing, or reproduced in any form, language and/or distributed to third parties without prior consent from Forest Interactive Sdn. Bhd.

The contents of this document are subject to revision without notice due to continued progress methodology, design and manufacturing. Forest Interactive shall not be liable for any errors or damages of any kind resulting from the use of this document.

Document Version History

Version Number Version Date Revised By Description
1.0 16/04/2015 Ardiansa Rachmawan First draft of SDK

Introduction

Aseandcb is an android library provided by Forest Interactive for android apps/games developer to implements in-app purchase into their apps. Users will be able to make the purchase with Direct Carrier Billing offered by the operators that are available.

Implementing Aseandcb

Currently, Aseandcb is connected directly the most prominent telcos in South East Asia such as Globe (Philippines) and TelkomSel (Indonesia).
The library can be downloaded from http://aseandcb.com.

Copy the library into your project that is available in “libs” directory. Build all and Clean all.

Globe

Below is the flow to be implemented for Globe’s IAP:

  1. Developer will first need to register the game that is to be implemented at FI Developer Portal.
  2. It will take less than 24 hours for the game to be approved by Admin, which the developer will then receive (ForestID and ForestKey).
  3. Implement to code, done.

Once received the details for the game that has been registered, these are the steps to implement the IAP:

  1. Add uses-permission in android manifest (INTERNET).
  2. Import Globe class
  3. Declare a String for ForestID, ForestKey and Amount.
  4. Initialize Globe
  5. Make payment by calling “GlobePay” method passing the Context, ForestID, ForestKey and Amount.
  6. Handle the result of the transactions, it will return error or successful. Please handle this result after payment process has been completed.

Telkomsel

Below is the flow to be implemented for TelkomSel’s IAP:

  1. Developer will first need to register the game that is to be implemented at FI Developer Portal.
  2. It will take less than 24 hours for the game to be approved by Admin, which the developer will then receive (ForestID and ForestKey).
  3. Implement to code, done.

Once received the details for the game that has been registered, these are the steps to implement the IAP:

  1. Add uses-permission in android manifest (Read Phone State, Internet and Send SMS).
  2. Declare a String for ForestID, ForestKey and Amount.
  3. Import TelkomSel class.
  4. Initialize TelkomSel
  5. Make the payment by calling “TelkomselPay” method and passing (Context, ForestID, ForestLey and Amount).
  6. Handle the response code and description by calling method “getStatusCode” and “getStatusCodeDescription”.

This is the description of status code: