# Parâmetros de Solicitação

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ção | String de ação |
| :---- | :---- |
| Pagamento | `es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST` |
| Consulta | `es.redsys.paysys.mPOSRedsys_QUERY_REQUEST` |
| Estorno | `es.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âmetro | Tipo | Obrigatório | Descrição |
| :---- | :---- | :---- | :---- |
| `amount` | double | Sim | Valor da transação (por exemplo, 12.50). |
| `invoice` | String | Não | Nú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âmetro | Tipo | Obrigatório | Descrição |
| :---- | :---- | :---- | :---- |
| `dateFrom` | String | Sim | Data de início para o intervalo da consulta no formato AAAAMMDD (por exemplo, 20240101). |
| `dateUntil` | String | Sim | Data 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âmetro | Tipo | Obrigatório | Descrição |
| :---- | :---- | :---- | :---- |
| `amount` | double | Sim | O valor a ser estornado. Pode ser igual ou menor que o valor da transação original. |
| `date` | String | Sim | Data do pagamento original no formato AAAAMMDD (por exemplo, 20240115). |
| `authorization` | String | Sim | Número de autorização retornado da transação de pagamento original. |
| `order` | String | Sim | Nú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

<Callout type="note">

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.

</Callout>

## Recursos Relacionados

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

* [Parâmetros de resposta](/pt/get-mini/get-mini-app2app/reference/response-parameters) - Referência completa para dados de resposta de transação
* [Processar um pagamento em etapa única](https://docs.globalgetnet.com/pt/products/local-processor-spain/get-mini?doc=getmini-app2app-processing-a-payment) - Guia passo a passo para implementar pagamentos
* [Estornar um pagamento](https://docs.globalgetnet.com/pt/products/local-processor-spain/get-mini?doc=getmini-app2app-processing-a-refund) - Guia passo a passo para implementar estornos