Getnet DocsGetnet Docs

Parâmetros de Solicitação

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

Esta referência documenta as ações de Intent e as especificações de parâmetros necessárias para a comunicação com o aplicativo Get Mini. Todos os parâmetros devem ser passados como extras de Intent usando o método putExtra(). As chaves dos parâmetros diferenciam maiúsculas de minúsculas (case-sensitive) e devem corresponder exatamente às especificações.

Ações de Intent

Para iniciar uma transação ou solicitação de consulta, o seu aplicativo deve criar um Intent com uma das seguintes strings de ação.

OperaçãoString de ação
Pagamentoes.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST
Consultaes.redsys.paysys.mPOSRedsys_QUERY_REQUEST
Estornoes.redsys.paysys.mPOSRedsys_REFUND_REQUEST

Cada ação de Intent lida com um tipo de operação específico. A operação é determinada pela string de ação e pelos parâmetros que você inclui nos extras do Intent.

Parâmetros de Solicitação

As seções a seguir listam todos os parâmetros de solicitação disponíveis para cada tipo de operação. Use intent.putExtra() para incluir esses campos na sua solicitação.

Parâmetros de Pagamento

Para transações de pagamento, use a ação es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST e inclua os seguintes parâmetros:

ParâmetroTipoObrigatórioDescrição
amountdoubleSimValor da transação (por exemplo, 12.50).
invoiceStringNãoNúmero ou identificador do pedido.

Parâmetros de Consulta

Para operações de consulta, use a ação es.redsys.paysys.mPOSRedsys_QUERY_REQUEST e inclua os seguintes parâmetros:

ParâmetroTipoObrigatórioDescrição
dateFromStringSimData de início para o intervalo da consulta no formato AAAAMMDD (por exemplo, 20240101).
dateUntilStringSimData de término para o intervalo da consulta no formato AAAAMMDD (por exemplo, 20240131).

Parâmetros de Estorno

Para transações de estorno, use a ação es.redsys.paysys.mPOSRedsys_REFUND_REQUEST e inclua os seguintes parâmetros:

ParâmetroTipoObrigatórioDescrição
amountdoubleSimO valor a ser estornado. Pode ser igual ou menor que o valor da transação original.
dateStringSimData do pagamento original no formato AAAAMMDD (por exemplo, 20240115).
authorizationStringSimNúmero de autorização retornado da transação de pagamento original.
orderStringSimNúmero do pedido retornado da transação de pagamento original.

Validação de Parâmetros

O aplicativo Get Mini valida todos os parâmetros recebidos antes do processamento. Erros comuns de validação incluem:

  • Parâmetros obrigatórios ausentes (amount, date, authorization, order)
  • Formato de parâmetro inválido (formato de data incorreto, valores negativos)
  • Tipos de dados incorretos para parâmetros

Sempre valide os seus parâmetros antes de iniciar o Intent para evitar erros de transação e fornecer uma melhor experiência ao usuário.

Recursos Relacionados

Para obter orientações de implementação e tratamento de respostas, consulte: