Request Parameters
This reference documents the Intent actions and parameter specifications required to communicate with the Get Mini application. All parameters must be passed as Intent extras using the putExtra() method. Parameter keys are case-sensitive and must match the specifications exactly.
Intent Actions
To initiate a transaction or query request, your application must create an Intent with one of the following action strings.
| Operation | Action String |
|---|---|
| Payment | es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST |
| Query | es.redsys.paysys.mPOSRedsys_QUERY_REQUEST |
| Refund | es.redsys.paysys.mPOSRedsys_REFUND_REQUEST |
Each Intent action handles a specific operation type. The operation is determined by the action string and the parameters you include in the Intent extras.
Request Parameters
The following sections list all available request parameters for each operation type. Use intent.putExtra() to include these fields in your request.
Payment Parameters
For payment transactions, use the action es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST and include the following parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
amount | double | Yes | Transaction amount (e.g., 12.50). |
invoice | String | No | Order number or identifier. |
Query Parameters
For query operations, use the action es.redsys.paysys.mPOSRedsys_QUERY_REQUEST and include the following parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
dateFrom | String | Yes | Start date for the query range in YYYYMMDD format (e.g., 20240101). |
dateUntil | String | Yes | End date for the query range in YYYYMMDD format (e.g., 20240131). |
Refund Parameters
For refund transactions, use the action es.redsys.paysys.mPOSRedsys_REFUND_REQUEST and include the following parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
amount | double | Yes | The amount to be refunded. Can be equal to or less than the original transaction amount. |
date | String | Yes | Date of the original payment in YYYYMMDD format (e.g., 20240115). |
authorization | String | Yes | Authorization number returned from the original payment transaction. |
order | String | Yes | Order number returned from the original payment transaction. |
Parameter Validation
The Get Mini application validates all incoming parameters before processing. Common validation errors include:
- Missing required parameters (
amount,date,authorization,order) - Invalid parameter format (incorrect date format, negative amounts)
- Incorrect data types for parameters
Always validate your parameters before launching the Intent to avoid transaction errors and provide a better user experience.
Related Resources
For implementation guidance and response handling, see:
- Response Parameters - Complete reference for transaction response data
- Process a Single-Step Payment - Step-by-step guide for implementing payments
- Refund a Payment - Step-by-step guide for implementing refunds