Getnet DocsGetnet Docs

Estornar um Pagamento

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Este guia orienta você no processamento de uma operação de estorno para reverter uma transação de pagamento anterior. Você aprenderá como referenciar a transação original e iniciar o estorno usando a integração Get Mini App2App.

Requisitos

Antes de seguir os passos, certifique-se de ter:

  • O aplicativo Get Mini instalado no dispositivo Android
  • Um dispositivo PIN pad compatível emparelhado e conectado
  • Detalhes da transação original, incluindo número de autorização, ID do pedido e data
  • O ActivityResultLauncher devidamente registrado em sua Activity ou Fragment

Você deve ter os detalhes exatos da transação original para processar um estorno. Eles são retornados na resposta do pagamento.

Processo de Estorno

Esta seção orienta você na criação de um Intent de estorno com os detalhes da transação original. O aplicativo Get Mini validará as informações e processará a reversão.

Passo 1: Criar o Intent de Estorno

Crie um Intent com a ação es.redsys.paysys.mPOSRedsys_REFUND_REQUEST e inclua todos os parâmetros necessários da transação original. O valor do estorno pode ser igual ou menor que o valor do pagamento original, permitindo estornos parciais.

A tabela abaixo lista os campos obrigatórios:

ParâmetroTipoObrigatórioDescrição
amountdoubleSimO valor a ser estornado.
dateStringSimData do pagamento original (formato AAAAMMDD).
authorizationStringSimNúmero de autorização do pagamento original.
orderStringSimNúmero do pedido do pagamento original.

Os valores de date, authorization e order devem corresponder exatamente à transação original. Discrepâncias farão com que o estorno seja recusado.

O código a seguir mostra como criar e iniciar o Intent de estorno:

// Create the Intent
Intent intent = new Intent("es.redsys.paysys.mPOSRedsys_REFUND_REQUEST");

// Add required parameters from the original transaction
intent.putExtra("amount", 10.50);
intent.putExtra("date", "20240116");
intent.putExtra("authorization", "123456");
intent.putExtra("order", "ORD-12345");

// Launch the Get Mini app
refundLauncher.launch(intent);

Passo 2: Lidar com o Resultado do Estorno

Após processar o estorno, o aplicativo Get Mini retorna o controle para o seu aplicativo com o resultado. Verifique o código de resultado e extraia os detalhes do estorno dos extras do Intent, incluindo o novo status da transação e as informações do recibo.

Para obter detalhes completos sobre o tratamento de respostas, consulte Lidar com os resultados da transação.

Próximos Passos

Agora que você processou um estorno, você pode explorar outras operações: