La integración de Main Apps se realiza por medio de SDKs. Para comenzar, instala la Demo App del Kit de Desarrollo en el dispositivo SmartPOS. Esta app puede servir como referencia en la integración.

Luego, sigue estos pasos para poder utilizar los SDKs:

1. Agrega la biblioteca del Kit de Desarrollo en el directorio app/libs.
2. Incluye la dependencia para la biblioteca en el archivo .gradle del módulo en el que se usará el SDK. Así:

dependencies {
     ....
     implementation files("libs/nativesdk-0.1.0.aar")
     ...
}

3. La configuración correcta de metadata en el archivo AndroidManifest.xml es crucial para garantizar el funcionamiento óptimo y la integración completa de nuestras SDKs en tu aplicación. La metadata permite definir configuraciones esenciales y personalizadas que el SDK necesita para operar adecuadamente, adaptándose a las necesidades específicas de cada aplicación y su entorno de uso. Para ello, configura la siguiente información:

   • CLIENT_ID: para identificar las transacciones de los integradores, indica la credencial Client ID que fue asignada a la aplicación creada en Tus integraciones.

   xml

   Copiar

   <application
       ...>
   
       <meta-data
   
           android:name="com.mercadolibre.android.sdk.CLIENT_ID"
           android:value="123456789L" />
   
       <!-- Otras configuraciones de la aplicación -->
   </application>

   Importante

   Es crucial que el nombre de la metadata sea exactamente com.test.android.sdk.CLIENT_ID. Cualquier variación en el nombre puede resultar en la falta de reconocimiento del campo por parte del SDK.
   
   Además, asegúrate de que el valor del Client ID termine con la letra "L" para indicar que es un número del tipo Long. Esto es necesario para que el SDK procese correctamente el valor.
   • OAUTH_ENABLED: utiliza el campo OAUTH_ENABLED para activar el protocolo de autorización OAuth, necesario para cuando los dispositivos se utilicen con cuentas diferentes a la del desarrollador de la aplicación. Este campo es opcional y, si no se agrega en la metadata, se considerará el valor predeterminado false.

   xml

   Copiar

   <application
       ...>
   
       <meta-data
   
           android:name="com.mercadolibre.android.sdk.OAUTH_ENABLED"
           android:value="true" />
   
       <!-- Otras configuraciones de la aplicación -->
   
   </application>

   Importante

   Es crucial que el nombre de la metadata sea exactamente com.mercadolibre.android.sdk.OAUTH_ENABLED. Cualquier variación en el nombre puede resultar en la falta de reconocimiento del campo por parte del SDK.
   
   Asegúrate de definir correctamente el valor del campo sólo con true o false, de acuerdo con la necesidad de habilitar o no el protocolo OAuth . Si no se especifica, el valor predeterminado será false.

4. Aún en el archivo AndroidManifest.xml, define la actividad principal que se establecerá como launcher de la app. Agrega los siguientes intent-filter:

<intent-filter>

   ...

   <category android:name="android.intent.category.LAUNCHER" />

   <category android:name="android.intent.category.HOME" />

</intent-filter>

4. Crea la clase heredada de la clase Application de Android e ingresa la configuración del SDK:

          
class MainApplication : Application() {
   override fun onCreate() {
       super.onCreate()
       val config = MPConfigBuilder(this, "123456789")
           .withBluetoothConfig()
           .withBluetoothUIConfig()
           .build()
       MPManager.initialize(this, config)
   }
}

        

          
public class MainApplication extends Application {

 @Override
 public void onCreate() {
   super.onCreate();
   MPConfig config = new MPConfigBuilder(this, "123456789")
     .withBluetoothConfig()
     .withBluetoothUIConfig()
     .build();
   MPManager.INSTANCE.initialize(this, config);
 }
}

        

5. Empieza a utilizar el SDK para procesar pagos:

          
val paymentFlow = MPManager.paymentFlow

val uriSuccess = paymentFlow.buildCallbackUri(
   "mercadopago://launcher_native_app",
   "success",
   hashMapOf("attr" to "123"),
   "demo_app"
)

val uriError = paymentFlow.buildCallbackUri(
   "mercadopago://launcher_native_app",
   "error",
   hashMapOf("attr" to "456"),
   "demo_app"
)

paymentFlow.launchPaymentFlowActivity(
   amount,
   description,
   uriSuccess,
   uriError,
   context,
   lastPaymentMethodSelected
) { response ->
   response.doIfError { error ->
       error.message?.let { errorMessage -> setLayoutError(errorMessage) }
   }
}

        

          
PaymentFlow paymentFlow = MPManager.INSTANCE.getPaymentFlow();

HashMap<String, String> metadata = new HashMap<>();

Uri uriSuccess = paymentFlow.buildCallbackUri(
 "mercadopago://launcher_native_app",
 "success",
 metadata,
 "demo_app"
);

Uri uriError = paymentFlow.buildCallbackUri(
 "mercadopago://launcher_native_app",
 "error",
 metadata,
 "demo_app"
);

Function1<MPResponse, Unit> callback = (MPResponse response) -> {
 return;
};

paymentFlow.launchPaymentFlowActivity(
 "1",
 "My Payment Description",
 uriSuccess,
 uriError,
 getApplicationContext(),
 "credit",
 callback
);