Ir para o conteúdo

Atualizar transação

`updateTransaction()`¶

Método para realizar o processo de atualização de uma transação, utilizado em cenários de teste.

Métodos¶

Assinatura	Descrição
`void updateTransaction(UpdateTransactionRequest updateTransactionRequest, PaymentCallback<Void> insertTransactionCallback)`	Realiza o processo de atualização de uma transação.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`request`	`UpdateTransactionRequest`	Sim	Objeto de transferência de dados que conterá as informações da requisição da transação.
`callback`	`PaymentCallback`	Sim	Interface que será executada para notificações de sucesso ou erro do processo da transação.

Detalhe dos parâmetros request (UpdateTransactionRequest)

Nome	Tipo	Obrigatório	Descrição
`id`	`String`	Sim	Identificador único para a transação.
`value`	`BigDecimal`	Sim	Valor da transação.
`productType`	`Integer`	Sim	Tipo de produto envolvido na transação.
`installmentQuantity`	`Integer`	Sim	Número de parcelas do pagamento.
`acquirerName`	`String`	Sim	Nome do adquirente.
`cardBrandId`	`String`	Sim	Identificador da bandeira do cartão utilizado.
`maskedPan`	`String`	Sim	PAN (Número da Conta Principal) mascarado do cartão.
`panLast4Digits`	`String`	Sim	Últimos 4 dígitos do PAN do cartão.
`captureType`	`Integer`	Sim	Tipo de captura da transação.
`paymentStatus`	`Integer`	Sim	Status do pagamento (ex: aprovado, pendente ou rejeitado).
`paymentDate`	`Date`	Sim	Data e hora em que o pagamento foi realizado.
`acquirerId`	`String`	Sim	Identificador da transação fornecido pelo adquirente.
`acquirerResponseCode`	`String`	Sim	Código de resposta do adquirente para a transação.
`acquirerResponseDate`	`Date`	Sim	Data e hora da resposta do adquirente à transação.
`authCode`	`String`	Sim	Código de autorização fornecido pelo adquirente para a transação.
`paymentClientReceipt`	`String`	Sim	Recibo do cliente para o pagamento.
`paymentMerchantReceipt`	`String`	Sim	Recibo do comerciante para o pagamento.
`additionalValueType`	`Integer`	Sim	Tipo de valor adicional aplicado à transação (ex: imposto ou taxa).
`cashbackValue`	`BigDecimal`	Sim	Valor de cashback aplicado à transação.
`accountTypeId`	`String`	Sim	Tipo de conta utilizada para a transação (ex: corrente ou poupança).
`planId`	`String`	Sim	Identificador do plano de pagamento utilizado.
`productShortName`	`String`	Sim	Nome curto do produto envolvido na transação.
`batchId`	`String`	Sim	Identificador do lote em que a transação foi processada.
`nsu`	`String`	Sim	Identificador único da transação, usado pelo adquirente.
`cardHolder`	`String`	Sim	Nome do titular do cartão associado à transação.
`trxType`	`Integer`	Sim	Tipo de transação (ex: compra, estorno ou reversão).
`terminalSpecificId`	`String`	Sim	Identificador único do terminal utilizado na transação.
`originalValue`	`String`	Sim	Valor original da transação antes de quaisquer alterações (ex: estorno ou chargeback).
`externalAppId`	`String`	Sim	Identificador da aplicação externa envolvida na transação.
`acquirerNsu`	`String`	Sim	Identificador único de transação (NSU) do adquirente.
`ticketNumber`	`String`	Sim	Número único associado ao ticket da transação.
`rawAdditionalMessage`	`String`	Sim	Mensagem bruta enviada pelo adquirente com detalhes adicionais da transação.
`notes`	`String`	Sim	Notas ou observações adicionais relacionadas à transação.
`dni`	`String`	Sim	Número de identificação do titular ou pagador.
`qrId`	`String`	Sim	Identificador do QR code associado à transação.
`aid`	`String`	Sim	Identificador da aplicação utilizada na transação (geralmente para transações EMV ou NFC).
`appLabel`	`String`	Sim	Rótulo da aplicação utilizada na transação.
`acquirerPackage`	`String`	Sim	Pacote ou conjunto de informações que descreve a forma de pagamento utilizada pelo adquirente.
`terminalAcquirerSpecificId`	`String`	Sim	Identificador específico do terminal fornecido pelo adquirente.

callback (PaymentCallback)¶

Nome	Tipo	Obrigatório	Descrição
`onSuccess`			Método para notificação em caso de sucesso.
`onError`			Método para notificação em caso de falha.
`ErrorData.paymentsResponseCode`	`String`	Sim	Código de resposta para o erro que ocorreu. Vide Códigos de Resposta
`ErrorData.acquirerResponseCode`	`String`	Não	Código de resposta para o erro ocorrido retornado pela adquirente. Observe que apenas este erro será retornado se a transação não for autorizada pela adquirente.
`ErrorData.responseMessage`	`String`	Sim	Mensagem descritiva da causa da não autorização. Se a transação foi negada pela adquirente, conterá a mensagem retornada pela adquirente.
`ErrorData.acquirerAdditionalMessage`	`String`	Não	Mensagem enviada no campo 63 de resposta EPS, para ser impressa ou exibida no final do fluxo transacional. O aplicativo de pagamentos permanece responsável por exibir na tela ou verificar o conteúdo presente neste campo, mas também deve enviar o valor recebido para a aplicação integrada para que ela possa aplicar suas regras de negócios baseadas no conteúdo deste campo.

Exemplo¶

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();
    //setar informações obrigatórias do request

    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!");
  }
}