Crea pagos con cuotas y planes

Esta guía te muestra cómo procesar pagos con tarjeta de crédito en cuotas con la Getnet Payment App. Puedes dejar que el terminal calcule los intereses (modo Manual) o enviar el monto final calculado desde tu propio sistema (modo Calculado).

Antes de comenzar

Antes de seguir los pasos, necesitas:

• La Getnet Payment App instalada en el terminal.
• Usar una tarjeta de crédito como medio de pago (paymentMethod="1").
• El comercio debe estar autorizado para planes de cuotas específicos mediante la configuración de su Tax Engine.

Cómo funciona

Cuando se detecta una tarjeta de crédito, el terminal valida el plan solicitado contra las configuraciones autorizadas del comercio mediante un Tax Engine. Entender este proceso de validación te ayuda a anticipar el comportamiento del terminal:

Paso 1: Elige el modo de operación

Antes de iniciar la transacción, define el operationMode. Este parámetro controla cómo se calculan los valores de la transacción:

Si no se especifica el operationMode, el terminal usa el modo manual ("0") de forma predeterminada.

Paso 2: Crea el pago con cuotas

Para procesar un pago con cuotas, creas un Intent con la operación de pago e incluyes los parámetros específicos de cuotas.

Cómo funciona la validación del plan y de las cuotas

El terminal ejecuta un proceso de validación de dos pasos contra el Tax Engine:

1. Validación del plan: si el planId que envías coincide con los planes autorizados del comercio que devuelve el Tax Engine, el terminal omite la pantalla de selección del plan.

2. Validación de cuotas: después de validar el plan, si el valor de installments es compatible con la respuesta del Tax Engine para ese plan, el terminal también omite la pantalla de selección de cuotas.

El terminal avanza directo a la pantalla de confirmación solo cuando ambas validaciones pasan. Si alguna falla, el terminal le pide al usuario que seleccione manualmente una opción válida y autorizada.

La siguiente tabla lista los parámetros que puedes enviar en el Intent:

El siguiente bloque de código muestra un ejemplo de cómo crear un pago con cuotas:

private val REQUEST_CODE = 1001

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("getnet://payment/v1/payment"))
    
    // Mandatory for Payment
    intent.putExtra("amount", "10000") // $100.00
    intent.putExtra("originalAmount", "10000")
    intent.putExtra("callerId", "123456")
    intent.putExtra("receiptCode", "654321")
    
    // Specific for Installments and Plans
    intent.putExtra("installments", 5) 
    intent.putExtra("planId", "plan_emisor")
    intent.putExtra("interest", "false")
    intent.putExtra("operationMode", "1") // Calculated mode
    intent.putExtra("skipConfirmation", "false")
    
    startActivityForResult(intent, REQUEST_CODE)
}

Paso 3: Procesa la respuesta

Después de que el cliente completa la transacción, la Getnet Payment App devuelve a tu aplicación los detalles finales del plan confirmado mediante onActivityResult.

Parámetros de respuesta

La siguiente tabla lista los parámetros de respuesta que vas a recibir:

El siguiente bloque de código muestra un ejemplo de cómo procesar la respuesta:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    
    if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
        val extras = data?.extras
        val result = extras?.getString("result")
        
        if (result == "0") {
            // SUCCESS: Extract transaction details
            val installments = extras?.getString("installments")
            val planId = extras?.getString("planId")
            val interest = extras?.getString("interest")
            val nsu = extras?.getString("nsu")
            val authCode = extras?.getString("authorizationCode")
            val amount = extras?.getString("amount")
            
            Log.d("Payment", "Payment approved with $installments installments")
            Log.d("Payment", "Plan: $planId, Interest: $interest")
            Log.d("Payment", "NSU: $nsu, Auth Code: $authCode")
        } else {
            // FAILURE: Handle error
            val errorDetails = extras?.getString("resultDetails")
            Log.e("Payment", "Payment failed: $errorDetails (Code: $result)")
        }
    }
}

Ejemplo de una respuesta exitosa:

{
  "result": "0",
  "resultDetails": "APPROVED",
  "amount": "10000",
  "installments": "5",
  "planId": "plan_emisor",
  "interest": "false",
  "callerId": "123456",
  "nsu": "57003",
  "authorizationCode": "004433"
}

Siguientes pasos

• Reglas de cuotas por país - los IDs de plan y las restricciones de medios de pago por país.
• Estrategia de cálculo de intereses - decide si el terminal o tu app calcula los intereses.