API Reference

Transferencia con QR

Resumen

Esta guía te llevará paso a paso por una solución sencilla para aceptar pagos dentro de tu aplicación Android. El SDK de Milio para Android te permite integrar múltiples métodos de pago en tu aplicación, incluyendo Visa y MasterCard.

Además, como se observa en la interfaz de usuario, podrás implementar funcionalidades relacionadas con la gestión de saldos y transferencias. Entre las acciones posibles están:

Transferencia con QR: Permite realizar pagos o transferencias escaneando un código QR.

Transacciones

Transferencia por QR

Flujo de Proceso:

  1. Autenticación: La empresa debe autenticarse utilizando las credenciales proporcionadas. Login autenticación
  2. Creación de Transferencia: Una vez autenticada, se crea la transferencia, lo que genera un QR con un token. Generación QR de cobro
  3. Especificación de Datos: Mediante el sdk, se debe indicar la cuenta de origen y los datos del tercero.

Al momento de inicializar el SDK y abrir la ventana para la transferencia por QR, este contiene un JSON que incluye el token asociado a la cuenta destino. Este token es generado previamente y representa la información necesaria para identificar la cuenta receptora y el monto a transferir. Al leer este QR, el SDK utiliza sus credenciales y configuración para procesar la transferencia automáticamente, garantizando que el dinero sea enviado a la cuenta correcta con el valor especificado.

🔹 Opción 1: Transferencia Sin Tokenizar (Ingresando los datos manualmente)

Para realizar pago sin tokenizar la tarjeta, este proceso no genera ningún registro, sino que únicamente recauda los fondos.

{
    "card": {
        "cardNumber": "4364749491074401",
        "cardExpiryDate": "12/26",
        "cardCVV": "652",
        "cardName": "Buffy Lanz"
    },
    "phone": "3026580102",
    "third": "Buffy Lanz"
}

🔹 Opción 2: Recarga Tokenizada (Usando un banco de un tercero previamente registrado)

Para realizar un cobro con tarjeta tokenizada, es necesario que previamente exista un tercero registrado en la compañía y que dicho tercero tenga una tarjeta asociada. En este flujo, la cuenta de la tarjeta del tercero será el destino de los fondos que se dispersarán. Una vez finalizada la transferencia, el cliente decide si se guarda la tarjeta.

El SDK requiere un tercero asociado a la transacción para cobros con tarjeta tokenizada. Si no tienes uno registrado, puedes crearlo en la plataforma mediante los siguientes enlaces:

{
    "thirdBankUUID": "dfb56715-ed55-4839-b0"
}

📍 Explicación de los Campos

CampoTipoDescripción
cardObject(Solo en recargas sin tokenizar) Datos de la tarjeta ingresada manualmente.
cardNumberStringNúmero de tarjeta de crédito/débito del remitente.
cardExpiryDateStringFecha de vencimiento en formato "MM/YY".
cardCVVStringCódigo de seguridad de la tarjeta.
cardNameStringNombre del titular de la tarjeta.
phoneString(Solo en recargas sin tokenizar) Teléfono del usuario que realiza la transacción.
thirdString(Solo en recargas sin tokenizar) Nombre del titular de la cuenta.
thirdBankUUIDString(Solo en recargas tokenizadas) Identificador único del banco emisor.

Iniciar SDK

Sin tarjeta tokenizada

const data = {
    "card": {
        "cardNumber": "4364749491074401",
        "cardExpiryDate": "12/26",
        "cardCVV": "652",
        "cardName": "Buffy Lanz"
    },
    "phone": "3026580102",
    "third": "Buffy Lanz"
}

MilioSdk.openTransferenciaQr(data)
      .then(response => /*Data de respuesta*/)
      .catch(error => /*Data de error*/);

Con tarjeta tokenizada

const data = {
    "thirdBankUUID": "dfb56715-ed55-4839-b0"
}

MilioSdk.openTransferenciaQr(data)
      .then(response => /*Data de respuesta*/)
      .catch(error => /*Data de error*/);

Ejemplo visual del SDK levantado


Este SDK es una herramienta poderosa para desarrolladores que buscan integrar soluciones financieras innovadoras y seguras en sus aplicaciones Android. ¡Descubre cómo el SDK de Transferencias Milio puede potenciar tu aplicación! 🚀