co.poynt.os.services.v1

Interface IPoyntActivationService

All Superinterfaces:

android.os.IInterface

All Known Implementing Classes:

IPoyntActivationService.Stub

public interface IPoyntActivationService
extends android.os.IInterface

Provides necessary interfaces to support custom activation of Poynt devices. This service will be called from within Poynt oobe flow. Typical integration includes the following steps:

All implementers of this Service must add meta data to the 'Service' element in their Android Manifest file for Poynt to recognize and invoke your service as needed. Here's the example service declaration in AndroidManifest.xml

 
  Sample Service
         <service
             android:name=".CustomActivationService"
             android:enabled="true"
             android:exported="true">

             <!-- define the intent filter with an action as IPoyntActivationService interface -->
             <intent-filter>
                 <action android:name="co.poynt.os.services.v1.IPoyntActivationService" />
             </intent-filter>

             <!-- define the details of your activation service inside an xml resource -->
             <!-- This xml will be used by the poynt system to expose this activation service to
                  oobe during device activation. -->
             <meta-data
                 android:name="co.poynt.os.service.capability"
                 android:resource="@xml/activation_capabilities"/>

             <!-- Optional: Provide a logo that will appear on screen -->
             <meta-data
                 android:name="co.poynt.os.service.logo"
                 android:resource="@drawable/app_logo" />
         </service>
  Sample Activation XML
         <?xml version="1.0" encoding="utf-8"?>
         <!-- This xml defines what capabilities are supported by the activation service that uses this xml.
              Capabilities will be used by PoyntOS/OOBE on behalf of the service to
              get device acivated for themerchant/customer. -->
             <capability xmlns:android="http://schemas.android.com/apk/res/android">

             <!-- REQUIRED: application id of this app this appid is issued by poynt web portal
                  IMPORTANT: Replace this appid with your appid.-->
             <!--<appid>urn:aid:0f39b7a3-b9db-41f1-9cdb-9f04a3620ade</appid>-->
             <appid>urn:aid:d3462a56-737b-4419-b54c-39a59f4dc8d6</appid>

             <!-- REQUIRED: type of capbility, should be one of
               please see CapabilityType defined in PoyntSDK for list of types supported.
             -->
             <type>ACTIVATION</type>

             <!-- descriptive name of this capability -->
             <provider>Sample Activation Provider</provider>>

             </capability>
 
 

Since:

beta3

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IPoyntActivationService.Stub Local-side IPC implementation stub class.

Method Summary

Modifier and Type	Method and Description
void	activate(java.lang.String requestId, IPoyntActivationServiceListener callback) Called to activation merchant business.

Methods inherited from interface android.os.IInterface

asBinder

Method Detail

activate

void activate(java.lang.String requestId,
              IPoyntActivationServiceListener callback)
       throws android.os.RemoteException

Called to activation merchant business. Result will be returned in IPoyntActivationServiceListener.onResponse(co.poynt.api.model.Business, co.poynt.os.model.PoyntError, java.lang.String), If this service wishes to launch a new Activity to get merchant input during activation call IPoyntActivationServiceListener.onLaunchActivity(android.content.Intent, java.lang.String),

Parameters:

requestId - Request id of the call originator.

callback - IPoyntActivationServiceListener

Throws:

android.os.RemoteException