Menú: API reference

Intents de Android

Iniciar un pago

Intent que abre honei Terminal para cobrar un importe y devuelve el resultado a tu app.

INTENTapp.honei.terminal.INIT_PAYMENT
Ver la guía

Lanzar el Intent

Java
Intent intent = new Intent("app.honei.terminal.INIT_PAYMENT");
intent.putExtra("amount", "25.00");
startActivityForResult(intent, 1001);

Parámetros

Clave Tipo Descripción
amount String Importe que se cobra, con punto decimal (por ejemplo "25.00"). Debe ser mayor que 0 y no superar 10000. Se redondea a dos decimales.

Datos del resultado

Clave Tipo Descripción
status String Estado final del pago (ver abajo).
amount Double Importe cobrado, sin propina.
tip Double Propina elegida por el cliente, si la hay.
paymentId String Identificador del pago.

Valores de status

  • completed: pago completado.
  • declined: rechazado por el terminal o el banco.
  • cancelled: el usuario ha cancelado el flujo de pago.
  • timed_out: el flujo de pago ha caducado.
  • not_completed: el pago se inició, pero no llegó a finalizar.

Intent rechazado

Si honei Terminal no acepta el Intent, no llega a abrirse el cobro. Devuelve RESULT_CANCELED con un extra error, sin status:

error Motivo
invalid_amount El importe falta, no es un número o está fuera de rango.
unauthorized_caller El negocio tiene configurada una app autorizada para cobrar y la tuya no es esa.

Códigos de resultado

  • RESULT_OK: se devuelve cuando el pago es completed.
  • RESULT_CANCELED: se devuelve para cualquier otro estado, y también si el Intent se rechaza.