Getnet DocsGetnet Docs

Crear un pago con plazos

Esta guía le orientará en el procesamiento de una transacción de pago a plazos utilizando la aplicación Get Smart. El pago a plazos (Fraccionamiento) permite a los clientes dividir una compra de importe elevado en varios pagos mensuales. Esta funcionalidad está sujeta a la elegibilidad de la tarjeta del cliente y a la configuración de su cuenta de comercio.

Requisitos

Antes de comenzar, asegúrese de tener:

  • Cuenta de comercio con la funcionalidad de plazos habilitada - Contacte con el soporte de Get Smart para verificar que su cuenta admite transacciones a plazos.
  • Cliente con una tarjeta de crédito compatible - No todas las tarjetas son elegibles para los planes de pago a plazos.
  • Aplicación Get Smart instalada y configurada en el dispositivo Android.

Los pagos a plazos requieren una configuración específica en la cuenta de comercio. Verifique con Get Smart que su cuenta tiene habilitada esta funcionalidad antes de la implementación.

Proceso de pago a plazos

Esta sección le guía a través del proceso de creación y ejecución de una transacción de pago a plazos con la integración Get Smart App2App. A diferencia de las ventas estándar, la aplicación Get Smart mostrará al cliente una pantalla de selección de plazos durante la transacción.

Paso 1: Crear y lanzar el Intent de plazos

Una transacción de pago a plazos permite a los clientes dividir el importe total en pagos mensuales. Debe crear un Intent con el tipo de transacción 7 para iniciar un pago a plazos. La aplicación Get Smart gestiona la interfaz de selección de plazos y procesa el pago según corresponda.

La tabla siguiente enumera los parámetros que debe incluir en su Intent de plazos:

ParámetroTipoObligatorioDescripción
amountdoubleSíEl importe total a cargar
typeintSíEstablecer en 7 para pagos a plazos (Venta Fraccionada)
invoiceStringNoNúmero de pedido o identificador opcional para el seguimiento

Informe ao cliente que va a iniciar un plan de pago a plazos antes de entregarle el terminal. Esto garantiza que esté preparado para seleccionar el número de plazos durante el proceso de pago.

El siguiente ejemplo de código muestra cómo crear y lanzar un Intent de pago a plazos:

// Define el código de petición para la gestión del resultado
static final int REQUEST_CODE_INSTALLMENT = 3001;

// Inicializa el Intent con la acción de Get Smart
Intent intent = new Intent("es.android.redsys.mPOS.movil.tpvAndroid_PAYMENT_REQUEST");

// Añade los parámetros de pago a plazos
intent.putExtra("amount", 600.00);
intent.putExtra("type", 7); // 7 = Plazos (Venta Fraccionada)
intent.putExtra("invoice", "ORDER-FRAC-123");

// Lanza el Intent
try {
    startActivityForResult(intent, REQUEST_CODE_INSTALLMENT);
} catch (ActivityNotFoundException e) {
    // Gestionar la ausencia de la aplicación Get Smart
    new AlertDialog.Builder(this)
        .setTitle("App Get Smart no encontrada")
        .setMessage("Por favor, instale y configure la aplicación Get Smart.")
        .setPositiveButton("OK", null)
        .show();
}

Paso 2: Gestionar la selección del cliente y el resultado de la transacción

Tras lanzar el Intent, la aplicación Get Smart muestra al cliente una pantalla de selección para elegir el número de plazos basándose en las promociones disponibles y la elegibilidad de la tarjeta. Las opciones comunes incluyen 3, 6 o 12 pagos mensuales, aunque los planes disponibles varían según el emisor de la tarjeta y las promociones vigentes.

Una vez que el cliente selecciona un plan de plazos y completa el pago, la aplicación Get Smart devuelve el control a su método onActivityResult. La respuesta incluye los datos de pago estándar junto con campos específicos que detallan el plan de plazos elegido por el cliente. La boleta impresa incluirá automáticamente el desglose de los plazos.

El siguiente ejemplo de código muestra cómo gestionar el resultado del pago a plazos:

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    
    if (requestCode == REQUEST_CODE_INSTALLMENT) {
        if (resultCode == RESULT_OK && data != null) {
            // Transacción exitosa - extraer datos de respuesta
            String authCode = data.getStringExtra("AUTHORIZATION");
            String orderId = data.getStringExtra("ORDER");
            
            // Extraer información específica de los plazos, si está disponible
            // Almacene estos detalles en sus registros digitales
            
            // La boleta impresa incluirá el desglose de los plazos
            // Asegúrese de que su sistema también registre esto como un pago fraccionado
        } else {
            // Transacción cancelada o fallida
            // Gestionar el error de forma adecuada
        }
    }
}

La boleta impresa incluye automáticamente el desglose completo de los plazos. Asegúrese de que sus registros digitales también registren que se trató de un pago fraccionado para una conciliación adecuada y soporte al cliente.

Próximos pasos

Ahora que ha procesado con éxito una transacción de pago a plazos, puede explorar más funciones de la integración Get Smart App2App: