Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt

Use this file to discover all available pages before exploring further.

Esta guía describe cómo incorporar Pay-me SDK en tu proyecto Android antes de implementar cobros o afiliaciones.
Utiliza siempre la versión de SDK entregada o confirmada por el equipo de integraciones para tu comercio.

Descargar SDK Pay-me Android v3.3

Descarga el paquete .zip con las librerías necesarias para integrar el SDK Android.

​
Artefactos requeridos

El paquete de integración debe incluir las librerías necesarias para ejecutar el flujo de pago.

Payme.aar

Librería principal del SDK.

SecureKey3DS.aar

Librería para autenticación 3DS.

VisaSensoryBranding.aar

Librería de experiencia Visa.

MastercardSonic.aar

Librería de experiencia Mastercard.
No subas los artefactos del SDK a repositorios públicos. Trata los archivos entregados como dependencias privadas del comercio.

​
Estructura recomendada

Crea una carpeta libs dentro del proyecto y coloca ahí los artefactos entregados. 
app/
  libs/
    Payme.aar
    SecureKey3DS.aar
    VisaSensoryBranding.aar
    MastercardSonic.aar

​
Configuración Gradle

Agrega los .aar como dependencias locales del módulo Android. 
dependencies {
    implementation(files("libs/SecureKey3DS.aar"))
    implementation(files("libs/Payme.aar"))
    implementation(files("libs/VisaSensoryBranding.aar"))
    implementation(files("libs/MastercardSonic.aar"))
}
Si tu proyecto usa build.gradle con Groovy, puedes declararlo así: 
dependencies {
    implementation files('libs/SecureKey3DS.aar')
    implementation files('libs/Payme.aar')
    implementation files('libs/VisaSensoryBranding.aar')
    implementation files('libs/MastercardSonic.aar')
}

​
Plugins y configuración Android

Confirma que el módulo tenga Kotlin y viewBinding habilitados. 
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-parcelize")
}

android {
    buildFeatures {
        viewBinding = true
    }
}

​
Permisos

Declara los permisos requeridos en AndroidManifest.xml. 
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

​
Dependencias base

El SDK requiere dependencias Android, networking, serialización y seguridad. Usa como referencia las versiones mínimas indicadas por el equipo de integraciones y mantén compatibilidad con tu proyecto. 
dependencies {
    implementation("androidx.core:core-ktx:1.6.0")
    implementation("androidx.appcompat:appcompat:1.7.0")
    implementation("org.jetbrains.kotlin:kotlin-stdlib:1.9.0")
    implementation("androidx.recyclerview:recyclerview:1.2.1")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    implementation("androidx.localbroadcastmanager:localbroadcastmanager:1.1.0")

    implementation("com.squareup.retrofit2:retrofit:2.3.0")
    implementation("com.squareup.retrofit2:converter-gson:2.3.0")
    implementation("com.squareup.retrofit2:converter-scalars:2.5.0")
    implementation("com.squareup.okhttp3:logging-interceptor:3.10.0")
    implementation("com.squareup.okhttp3:okhttp:3.10.0")
    implementation("com.google.code.gson:gson:2.8.8")

    implementation("com.madgag.spongycastle:core:1.50.0.0")
    implementation("com.madgag.spongycastle:pg:1.50.0.0")
    implementation("org.bouncycastle:bcprov-jdk15on:1.56")
    implementation("com.nimbusds:nimbus-jose-jwt:7.0.1")

    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:0.30.1")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:0.30.1")
}
Si tu proyecto ya usa versiones superiores de estas dependencias, valida compatibilidad antes de degradarlas. Evita duplicar librerías con versiones incompatibles.

​
Validación rápida

Compilación

  • El proyecto sincroniza Gradle sin errores.
  • Los .aar se resuelven desde la carpeta libs.
  • No existen conflictos de versiones en dependencias compartidas.
  • Los permisos están declarados en AndroidManifest.xml.
  • viewBinding está habilitado si el proyecto lo requiere.
  • El ambiente sandbox está identificado para las primeras pruebas.
  • Las credenciales se generan y protegen desde backend.
  • No se exponen tokens ni secretos dentro de la app.
  • Los logs de prueba no imprimen información sensible.

​
Siguiente paso

Inicializar Pay-me SDK Android

Crea la instancia de PaymeClient e inicia tu primer flujo de cobro.