Ir para o conteúdo

Actualizar transacción

updateTransaction()

Método para realizar el proceso de actualización de una transacción, utilizado en escenarios de prueba.

Métodos

Suscripción Descripción
void updateTransaction(UpdateTransactionRequest updateTransactionRequest, PaymentCallback<Void> insertTransactionCallback) Realiza el proceso de actualización de una transacción.

Parámetros

Nombre Tipo Obligatorio Descripción
request RemoveTransactionRequest Sí Objeto de transferencia de datos que contendrá la información de la solicitud de la transacción.
callback PaymentCallback Sí Interfaz que será ejecutada para notificaciones de éxito o error del proceso de la transacción.

Detalle de los Parámetros request (RemoveTransactionRequest)

Nombre Tipo Obligatorio Descripción
id String Sí Identificador único para la transacción.
value BigDecimal Sí Valor de la transacción.
productType Integer Sí Tipo de producto involucrado en la transacción.
installmentQuantity Integer Sí Número de cuotas del pago.
acquirerName String Sí Nombre del adquirente.
cardBrandId String Sí Identificador de la marca del tarjeta utilizada.
maskedPan String Sí PAN (Número de Cuenta Principal) enmascarado de la tarjeta.
panLast4Digits String Sí Últimos 4 dígitos del PAN de la tarjeta.
captureType Integer Sí Tipo de captura de la transacción.
paymentStatus Integer Sí Estado del pago (ej: aprobado, pendiente o rechazado).
paymentDate Date Sí Fecha y hora en que se realizó el pago.
acquirerId String Sí Identificador de la transacción proporcionado por el adquirente.
acquirerResponseCode String Sí Código de respuesta del adquirente para la transacción.
acquirerResponseDate Date Sí Fecha y hora de la respuesta del adquirente a la transacción.
authCode String Sí Código de autorización proporcionado por el adquirente para la transacción.
paymentClientReceipt String Sí Recibo del cliente para el pago.
paymentMerchantReceipt String Sí Recibo del comerciante para el pago.
additionalValueType Integer Sí Tipo de valor adicional aplicado a la transacción (ej: impuesto o tarifa).
cashbackValue BigDecimal Sí Valor de reembolso (cashback) aplicado a la transacción.
accountTypeId String Sí Tipo de cuenta utilizada para la transacción (ej: corriente o de ahorro).
planId String Sí Identificador del plan de pago utilizado.
productShortName String Sí Nombre corto del producto involucrado en la transacción.
batchId String Sí Identificador del lote en el que se procesó la transacción.
nsu String Sí Identificador único de la transacción, utilizado por el adquirente.
cardHolder String Sí Nombre del titular de la tarjeta asociada con la transacción.
trxType Integer Sí Tipo de transacción (ej: compra, reembolso o reversión).
terminalSpecificId String Sí Identificador único del terminal utilizado en la transacción.
originalValue String Sí Valor original de la transacción antes de cualquier modificación (ej: reembolso o chargeback).
externalAppId String Sí Identificador de la aplicación externa involucrada en la transacción.
acquirerNsu String Sí Identificador único de la transacción (NSU) del adquirente.
ticketNumber String Sí Número único asociado con el ticket de la transacción.
rawAdditionalMessage String Sí Mensaje en crudo enviado por el adquirente con detalles adicionales de la transacción.
notes String Sí Notas u observaciones adicionales relacionadas con la transacción.
dni String Sí Número de identificación del titular o pagador.
qrId String Sí Identificador del código QR asociado con la transacción.
aid String Sí Identificador de la aplicación utilizada en la transacción (generalmente para transacciones EMV o NFC).
appLabel String Sí Etiqueta de la aplicación utilizada en la transacción.
acquirerPackage String Sí Paquete o conjunto de información que describe la forma de pago utilizada por el adquirente.
terminalAcquirerSpecificId String Sí Identificador específico del terminal proporcionado por el adquirente.

callback (PaymentCallback)

Nombre Tipo Obligatorio Descripción
onSuccess Método para notificación en caso de éxito.
onError Método para notificación en caso de error.
ErrorData.paymentsResponseCode String Sí Código de respuesta para el error que ocurrió. Ver Códigos de Respuesta
ErrorData.acquirerResponseCode String No Código de respuesta para el error ocurrido retornado por el adquirente. Tenga en cuenta que solo este error será retornado si la transacción no es autorizada por el adquirente.
ErrorData.responseMessage String Sí Mensaje descriptivo de la causa de la no autorización. Si la transacción fue rechazada por el adquirente, contendrá el mensaje retornado por el adquirente.
ErrorData.acquirerAdditionalMessage String No Mensaje enviado en el campo 63 de respuesta EPS, para ser impreso o mostrado al final del flujo transaccional. La aplicación de pagos sigue siendo responsable de mostrarlo en pantalla o verificar el contenido de este campo, pero también debe enviar el valor recibido a la aplicación integrada para que pueda aplicar sus reglas de negocio basadas en el contenido de este campo.

Ejemplo

public class MyActivity extends Activity implements PaymentClient.PaymentCallback {

  private PaymentClient paymentClient;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_payment);

    paymentClient = new PaymentClientImpl();
  }

  @Override
  protected void onResume() {
    super.onResume();
    paymentClient.bind(this);
  }

  @Override
  protected void onDestroy() {
    try {
      paymentClient.unbind(this);
    } catch (Exception e) {
      Log.e(TAG, e.getMessage());
    }
    super.onDestroy();
  }

  public void doExecute() {

    UpdateTransactionRequest updateTransactionRequest = new UpdateTransactionRequest();
    //establecer la información obligatoria de la solicitud

    try {
      paymentClient.updateTransaction(updateTransactionRequest, this);
    } catch (ClientException e) {
      Log.e(TAG, "Error", e);
    }
  }

  @Override
  public void onError(ErrorData errorData) {
    Log.e(TAG, "Error: " + errorData.getResponseMessage());
  }

  @Override
  public void onSuccess(Object o) {
    Log.i(TAG, "Success!");
  }
}