Referencia de métodos del SDK

El framework Get Mini está organizado en módulos especializados. Esta referencia documenta las clases y métodos principales utilizados para el procesamiento de pagos, gestión de dispositivos y consultas de transacciones.

Configuración global (CommonUtils)

La clase CommonUtils maneja configuraciones globales que deben configurarse antes de cualquier otra interacción con el SDK.

Método	Parámetros	Descripción
`setEntorno`	String (ej., “int”, “real”)	Establece el entorno de ejecución (Desarrollo, Integración, CCAL o Real).
`setAppLicense`	String	Configura la licencia de la aplicación proporcionada por Get Mini.

Hardware y conexión (RedsysPinpadManager)

Esta clase gestiona la conexión Bluetooth y la interacción en tiempo real con el hardware PIN pad.

findBluetoothDevices

Escanea accesorios PIN pad emparejados con el sistema iOS. Los resultados se devuelven a través del callback del delegado onProcessOK como un array de EAAccessory.

connectAndConfigureDevice

Establece una conexión con un dispositivo específico y realiza la configuración obligatoria del terminal (inyección de claves).

Parámetro	Tipo	Descripción
`device`	id (EAAccessory)	El objeto accesorio descubierto vía `findBluetoothDevices`.
`merchan`	MerchanDTO	Objeto que contiene FUC, Terminal y Clave de Comercio.
`withDelegate`	id<RedsysBTPinpadInitDelegate>	Delegado para monitorear el progreso de la inicialización.

payWithPinpadBluetooth

El método principal para procesar transacciones con tarjeta presente (Ventas).

Parámetro	Tipo	Descripción
`device`	id	El accesorio de hardware conectado.
`merchan`	MerchanDTO	Credenciales del comercio.
`config`	PinpadConfig	El objeto de configuración devuelto por `onInitFinished`.
`andPagoDTO`	PagoDTO	Detalles de la transacción (Monto y Moneda).
`withDelegate`	id<RedsysBTPinpadPaymentDelegate>	Delegado para recibir resultados de pago y manejar retroalimentación DCC.

Operaciones de pasarela (RedsysTransactionManager)

Esta clase gestiona llamadas de Servicio Web para operaciones que pueden o no requerir presencia de tarjeta.

peticionDevolucion

Procesa una devolución estándar vinculada a una transacción anterior.

Parámetro	Tipo	Descripción
`dictDevolucion`	EnvioDevolucionDTO	Contiene la operación original y el monto de la devolución.
`withBlock`	CompletionBlock	Devuelve un `DevolucionResponseDTO` o un `NSError`.

peticionConsultaFechaPagina

Utilizado para consultar el historial de operaciones, con filtros opcionales por tipo de operación (Pago, Devolución, Confirmación o Preautorización).

Parámetro	Tipo	Descripción
`dictConsultaFecha`	ConsultaFechasDTO	Parámetros de búsqueda (Rango de fechas, Terminal, Página).
`conValores`	NSDictionary	Filtros opcionales (ej., `setTipoOperacion:@"CONFIRMACION"`).
`withBlock`	CompletionBlock	Devuelve un `ListaOperacionesDTO`.

peticionPagoPorReferencia

Procesa un pago con tarjeta en archivo (recurrente) utilizando un token obtenido previamente.

peticionPaygold

Genera un enlace de pago enviado por SMS o Email al cliente.

Objetos de transferencia de datos clave (DTOs)

DTO	Propósito
PagoDTO	Define el monto (en céntimos), la moneda, el nombre de factura y los datos de contacto del cliente.
MerchanDTO	Alberga credenciales del comercio para inicialización del PIN pad.
RespuestaTransaccionDTO	Devuelto después de pagos; contiene el `identificadorRTS` y `literales`.
OperacionDTO	Representa una transacción única en una lista de historial, usada para emitir devoluciones.

Notas de implementación

Hilos: La mayoría de los métodos usan callbacks basados en bloques que se ejecutan asíncronamente. Asegúrate de que las actualizaciones de UI se realicen en el hilo principal.
Precisión de DTO: Los montos se manejan típicamente como enteros (céntimos) en métodos de PinpadManager pero como cadenas (ej., “10.00”) en métodos de devolución de TransactionManager. Refiérete a guías específicas para formateo.
Permisos: Usa PerfilComercioManager para verificar características activas del terminal antes de llamar métodos de transacción.