Parámetros de la petición
Esta referencia documenta las acciones de Intent y las especificaciones de los parámetros necesarios para comunicarse con la aplicación Get Mini. Todos los parámetros deben pasarse como extras de Intent utilizando el método putExtra(). Las claves de los parámetros distinguen entre mayúsculas y minúsculas (case-sensitive) y deben coincidir exactamente con las especificaciones.
Acciones de Intent
Para iniciar una transacción o una solicitud de consulta, su aplicación debe crear un Intent con una de las siguientes cadenas de acción.
| Operación | Cadena de acción |
|---|---|
| Pago | es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST |
| Consulta | es.redsys.paysys.mPOSRedsys_QUERY_REQUEST |
| Devolución | es.redsys.paysys.mPOSRedsys_REFUND_REQUEST |
Cada acción de Intent gestiona un tipo de operación específico. La operación se determina por la cadena de acción y los parámetros que incluya en los extras del Intent.
Parámetros de la petición
Las siguientes secciones enumeran todos los parámetros de petición disponibles para cada tipo de operación. Utilice intent.putExtra() para incluir estos campos en su petición.
Parámetros de pago
Para las transacciones de pago, utilice la acción es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST e incluya los siguientes parámetros:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amount | double | Sí | Importe de la transacción (por ejemplo, 12.50). |
invoice | String | No | Número o identificador del pedido. |
Parámetros de consulta
Para las operaciones de consulta, utilice la acción es.redsys.paysys.mPOSRedsys_QUERY_REQUEST e incluya los siguientes parámetros:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
dateFrom | String | Sí | Fecha de inicio para el rango de la consulta en formato AAAAMMDD (por ejemplo, 20240101). |
dateUntil | String | Sí | Fecha de fin para el rango de la consulta en formato AAAAMMDD (por ejemplo, 20240131). |
Parámetros de devolución
Para las transacciones de devolución, utilice la acción es.redsys.paysys.mPOSRedsys_REFUND_REQUEST e incluya los siguientes parámetros:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amount | double | Sí | El importe a devolver. Puede ser igual o inferior al importe de la transacción original. |
date | String | Sí | Fecha del pago original en formato AAAAMMDD (por ejemplo, 20240115). |
authorization | String | Sí | Número de autorización devuelto por la transacción de pago original. |
order | String | Sí | Número de pedido devuelto por la transacción de pago original. |
Validación de parámetros
La aplicación Get Mini valida todos los parámetros entrantes antes de procesarlos. Los errores de validación comunes incluyen:
- Faltan parámetros obligatorios (
amount,date,authorization,order) - Formato de parámetro no válido (formato de fecha incorrecto, importes negativos)
- Tipos de datos incorrectos para los parámetros
Valide siempre sus parámetros antes de iniciar el Intent para evitar errores de transacción y proporcionar una mejor experiencia al usuario.
Recursos relacionados
Para obtener orientación sobre la implementación y la gestión de respuestas, consulte:
- Parámetros de respuesta - Referencia completa de los datos de respuesta de la transacción
- Crear un pago - Guía paso a paso para implementar pagos
- Devolver un pago - Guía paso a paso para implementar devoluciones