Getnet DocsGetnet Docs

Parámetros de respuesta

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 referencia documenta todos los parámetros devueltos por la aplicación Get Mini tras un intento de transacción. Cuando la operación finaliza, devuelve un Intent a la devolución de llamada (callback) ActivityResult de su aplicación con los detalles de la transacción almacenados como extras.

Acceso a los datos de respuesta

Los parámetros de respuesta se recuperan del Intent utilizando los métodos getStringExtra() o getIntExtra() con las claves de parámetro que se enumeran a continuación. Todas las claves distinguen entre mayúsculas y minúsculas (case-sensitive) y deben coincidir exactamente.

Parámetros de respuesta por operación

La app Get Mini devuelve un conjunto de extras distinto para cada operación. Lee las claves de la operación que lanzaste. Todas distinguen mayúsculas y minúsculas.

Después de un pago

ClaveTipoDescripción
TICKET_IMAGEStringURL del PDF generado con el ticket certificado.
AUTORIZATION_NUMBERStringNúmero de autorización.
IDENTIFIER_RTSStringIdentificador de la transacción.
ORDERStringNúmero de pedido.
STATEStringCódigo resultado.
ERROR_MSGStringDescripción del error.

La clave de autorización se escribe AUTORIZATION_NUMBER, sin la ‘H’. Usa esa cadena exacta.

Después de una consulta

ClaveTipoDescripción
TICKET_IMAGEStringURL del PDF generado con el ticket certificado.
STATEStringCódigo resultado.
ERROR_MSGStringDescripción del error.

Después de una devolución

ClaveTipoDescripción
TICKET_IMAGEStringURL del PDF generado con el ticket certificado.
STATEStringCódigo resultado.
ERROR_MSGStringDescripción del error.

Acceso a los recibos

Los métodos de acceso a los recibos varían según la versión de Android. La aplicación Get Mini proporciona diferentes mecanismos para acceder a los recibos de las transacciones:

MétodoVersión de AndroidDescripción
Extra TICKET_IMAGE< Android QRuta del archivo al PDF del recibo almacenado en el dispositivo.
intent.getData()≥ Android QURI de contenido para acceder al PDF del recibo. Requiere FLAG_GRANT_READ_URI_PERMISSION.

Para Android Q y versiones superiores, utilice intent.getData() para recuperar la URI del recibo en lugar del extra TICKET_IMAGE.

Valores de estado

STATE lleva el código resultado de la operación y, cuando la operación se deniega, el código de denegación.

Consulta Códigos de resultado y errores para saber cómo leerlo.

Mejores prácticas para la gestión de datos

Al procesar los parámetros de respuesta, siga estas pautas para garantizar una gestión sólida de las transacciones:

  • Verificar los datos del Intent - Compruebe siempre que el Intent no es nulo antes de extraer los parámetros
  • Comprobar STATE primero - Verifique siempre el parámetro STATE antes de procesar otros campos
  • Guardar campos críticos - Guarde AUTORIZATION_NUMBER, ORDER e IDENTIFIER_RTS para todas las transacciones exitosas
  • Gestionar campos faltantes - No todos los parámetros están presentes en todas las respuestas. Compruebe si hay valores nulos antes de utilizar cadenas (strings)
  • Añadir marcas de tiempo (timestamps) - Guarde su propia marca de tiempo al registrar los datos de la transacción para una conciliación precisa
  • Gestionar recibos - Gestione tanto los métodos de ruta de archivo como de URI, dependiendo de la versión de Android

El parámetro ORDER debe guardarse para las transacciones de pago exitosas, ya que es necesario para procesar las devoluciones.

Recursos relacionados