Integración con Anulación/Devolución V2¶

Una de las formas de integrarse con la aplicación de pagos Phoebus es a través de IPC. Para ello, se proporciona una biblioteca, la payments-api-x.x.x.x.aar, que contiene todo el código necesario que se utilizará para dichas llamadas.

Mediante esta API es posible realizar todo el flujo de pago, es decir, confirmación (o deshacer) y reversión. El pago se puede realizar con una cantidad predefinida o con una cantidad abierta, a ser ingresada por el operador de la terminal. Además, es posible informar una lista de tipos de pagos (débito, crédito, crédito en cuotas, etc.) permitidos.

Aunque esta integración se lleva a cabo a través de una API, la aplicación de pago puede mostrar información en la interfaz de la terminal, como mensajes (por ejemplo, "Insertar o deslizar la tarjeta"), o incluso solicitar información al operador (por ejemplo., CVV). Por lo tanto, durante la realización de cualquier operación, la aplicación que solicitó la operación no debe interactuar con la interfaz del dispositivo hasta que se complete la operación.

La siguiente es una especificación detallada de las operaciones disponibles.

Para la integración con la API de pagos, se proporciona la interfaz PaymentClient.

Flujo de Anulación/Devolución¶

A partir de la versión 3.1.5.0.

Cuando se realiza una transacción, antes se podía confirmar imprimiéndola (o mediante printReceipt), o realizando una nueva transacción. Ahora, la anulación también puede confirmarse utilizando el nuevo parámetro autoConfirm -que indica si se confirma o no independientemente de la impresión- o utilizando el nuevo método confirmReversePayment().

Métodos¶

reversePaymentV2()¶

Se debe llamar a este método cuando desee realizar una solicitud de anulación o devolución de pago. Durante su ejecución, se validarán los datos de la anulación o devolución, se puede solicitar información adicional al operador (por ejemplo, tarjeta) y se realizará la autorización del adquirente.

Tenga en cuenta que la transacción de anulación o devolución no tiene confirmación, solo reversión. Así, la confirmación se producirá de forma natural si no se envía la reversión, dependiendo del comportamiento de cada adquirente o tipo de pago. Si hay una impresión del recibo de anulación o devolución, cuando se pasa cualquiera de los parámetros printMerchantReceipt oprintCustomerReceipt con un valor true, la anulación o devolución se confirmará automáticamente. En este caso, no se permitirá reverter.

También dependiendo del comportamiento de cada adquirente o tipo de pago, es posible que no se reverta la transacción de anulación o devolución. En este caso, los reversos aprobados devolverán el valor false en el campo "ReversePayment.cancelable". Además, si se llama al método cancelReversePayment(), se devolverá un error específico indicando que no es posible realizar dicha operación (ver Códigos de respuesta).

Parámetros

Detalle de los parámetros

request (ReversePaymentRequestV2)

callback (ReversePaymentCallback)

confirmReversePayment()¶

Este método debe llamarse para confirmar una anulación que el terminal ha conseguido procesar completamente el tramo de autorización enviado por el Autorizador.

Este método no debe invocarse para una anulación que ya ha sido confirmada, es decir, cuando ya se ha ejecutado el método confirmReversePayment().

Este método no debe invocarse para una anulación ya cancelada, es decir, cuando ya se haya ejecutado el método cancelReversePayment().

Este método no debe invocarse para una anulación que haya sido denegada por el Autorizador, es decir, la transacción debe haber sido autorizada por el Autorizador.

Parámetros

Detalle de los parámetros

callback

cancelReversePayment()¶

Se debe llamar a este método para deshacer una transacción de anulación o devolución previamente autorizada. Esta transacción no debe haberse revertida todavía y debe haber sido autorizada (no denegada) previamente.

Como se dice en la descripción de reversePayment(), Es posible que no se pueda deshacer la transacción de anulación o devolución de pago de una adquirente o tipo de pago determinado. Por lo tanto, el método cancelReversePayment() puede devolver un error específico que indique que no es posible realizar dicha operación (ver Códigos de respuesta).

Parámetros

Detalle de los parámetros

callback

Ejemplo de flujo de anulación o devolución¶

import androidx.appcompat.app.AppCompatActivity;

import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

import java.math.BigDecimal;

import br.com.phoebus.android.payments.api.Credentials;
import br.com.phoebus.android.payments.api.ErrorData;
import br.com.phoebus.android.payments.api.PaymentClient;
import br.com.phoebus.android.payments.api.ReversePayment;
import br.com.phoebus.android.payments.api.ReversePaymentRequestV2;
import br.com.phoebus.android.payments.api.exception.ClientException;

public class MainActivity extends AppCompatActivity implements View.OnClickListener, PaymentClient.PaymentCallback<ReversePayment> {

    Button bt_start;
    private PaymentClient paymentClient;
    public static final String TEST_APPLICATION_ID = "0";
    public static final String TEST_SECRET_TOKEN = "000000000000000000000000";
    public static final String TAG = "TAG_DEMO";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        bt_start = (Button) this.findViewById(R.id.button);
        bt_start.setOnClickListener(this);
        paymentClient = new PaymentClient();

    }


    @Override
    public void onClick(View view) {
        doExecute();
    }

    @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(){
        ReversePaymentRequestV2 request = new ReversePaymentRequestV2();
        BigDecimal value = BigDecimal.valueOf(5000).movePointLeft(2);
        request.setValue(value);
        request.setAppTransactionId("123456");

        request.setPaymentId("999999");
        request.setPrintCustomerReceipt(true);
        request.setPrintMerchantReceipt(true);

        Credentials credentials = new Credentials();
        credentials.setApplicationId(TEST_APPLICATION_ID);
        credentials.setSecretToken(TEST_SECRET_TOKEN);

        request.setCredentials(credentials);

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


    @Override
    public void onSuccess(ReversePayment  reversePayment) {
        Log.i(TAG, reversePayment.toString());

        /*
          Si, en su regla comercial, es necesario deshacer la
          transacción por cualquier motivo, llame al método
          cancelReversePayment()
        **/
        //doCancelReversePayment(reversePayment);

    }

    @Override
    public void onError(ErrorData errorData) {
        Log.e(TAG, errorData.getResponseMessage());
        Toast.makeText(this, errorData.getResponseMessage(), Toast.LENGTH_LONG).show();
    }

    private void doCancelReversePayment(ReversePayment reversePayment) {
        try {
            paymentClient.cancelReversePayment(reversePayment.getPaymentId(),
                    new PaymentClient.PaymentCallback<ReversePayment>() {

                        @Override
                        public void onError(ErrorData errorData) {
                            Log.e(TAG, errorData.getResponseMessage());
                            Toast.makeText(MainActivity.this, errorData.getResponseMessage(), Toast.LENGTH_LONG).show();
                        }

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


                    });
        } catch (ClientException e) {
            Log.e(TAG, "Error cancelReversePayment", e);
        }


    }


}