Saltar al contenido principal
Los objetos que el SDK devuelve a tu app: el estado final de una transacción y el token de un solo uso cuando creas el pago desde tu backend.
El objeto status informa cómo terminó la transacción. El SDK lo entrega mediante onStatus.

Qué recibes

El payload contiene tres elementos:
  • status: se transmite exactamente como lo devuelve el backend, para los estados que esta versión del SDK conoce. En Web son (pagos: CREATED, SUCCEEDED, PENDING, DECLINED, REJECTED, CANCELED, ERROR, EXPIRED, REFUNDED, VERIFIED, READY_TO_PAY; inscripciones: ENROLLED, ENROLL_IN_PROCESS, UNENROLLED, UNENROLL_IN_PROCESS, READY_TO_ENROLL, CREATED, PENDING, DECLINED, REJECTED, CANCELED, ERROR, EXPIRED). En todas las plataformas, cualquier otro valor llega como INTERNAL_ERROR con message.code UNSUPPORTED_STATUS y message.reason definido como unsupported status: <value>.
  • substatus: se transmite exactamente como lo devuelve el backend. En Web, un substatus vacío o ausente llega como null.
  • message: contexto adicional. Su forma depende del origen:
En Web, cualquier otro estado de pago y cualquier estado de inscripción llevan message: null.En React Native, onStatus recibe sin cambios el estado del SDK nativo subyacente: una app que se ejecuta en iOS recibe los valores de iOS de esta página, y una app que se ejecuta en Android recibe los de Android.

Estados que emite el propio SDK

Dos estados no se transmiten desde el backend, el SDK los emite localmente:
  • INTERNAL_ERROR: se genera cuando falló una llamada a un servicio del backend, o cuando algo falló dentro del SDK (carga, renderizado de la vista, red, excepción inesperada).
  • USER_CANCEL: se genera cuando el usuario cierra un formulario o una vista sin completar el flujo.
En Web, INTERNAL_ERROR con message.code FORM_INVALID no es final. El SDK lo genera cuando envías un formulario que no es válido, con transaction.submit() o con transaction.start({ paymentMethod }) en la lista de métodos de pago. El formulario sigue montado y el usuario puede corregirlo.En Web, los valores de message.code para source: "sdk" incluyen:
  • UNSUPPORTED_STATUS. El backend devolvió un estado que el SDK no conoce. message.reason es unsupported status: <value>.
  • FORM_INVALID. El formulario enviado no es válido. No es final.
  • ELEMENT_NOT_FOUND. El elemento que se pasó a paymentMethodList.mount() no está en el DOM, o el contenedor del formulario se eliminó mientras el formulario se cargaba. Un elementSelector de configuración que no coincide con nada hace que start() se rechace con elementSelector "<selector>" was not found in the document. en su lugar.
  • COLLECT_FAILED. En modo manual (pasas createPayment), la billetera de Mercado Pago no pudo recopilar los datos del pago. message.reason empieza con MERCADO_PAGO_.
  • UNEXPECTED_ERROR. Un fallo que el SDK no clasifica. message.reason incluye el mensaje de error.
En iOS, los valores de message.code para source: "sdk" son los siguientes. message.context indica el punto de llamada que produjo el error.En Web, una cancelación durante un desafío de 3DS, por ejemplo al cerrar el desafío o presionar el botón de retroceso del navegador, llega como status: "PENDING" con substatus: "USER_CANCEL" y message: null, porque el pago ya existe en el backend. Llamar a transaction.unmount() en una transacción iniciada que no ha entregado un estado también emite USER_CANCEL, a menos que haya un pago en curso.

¿Falla del backend o falla del SDK? Lee message.source

INTERNAL_ERROR cubre ambos casos, así que el status por sí solo no te dice de dónde provino la falla. Un rechazo del backend (por ejemplo, una sesión de checkout no válida o vencida) llega así:
Una falla del lado del SDK (red, renderizado, excepción inesperada) llega así:
En Web, reason es el valor de messages[], message o description del backend. Para INVALID_CHECKOUT_SESSION, el SDK agrega una pista de que una transacción headless necesita una sesión creada con el workflow SDK_SEAMLESS.Cuando message.source es "backend", la API de Yuno rechazó una llamada: code y raw incluyen el error propio del backend, así que empieza a depurar ahí (validez de la sesión, workflow, credenciales). Cuando es "sdk", la falla se originó dentro del SDK y context indica el módulo o el punto de llamada que la produjo.

Valores de estado del backend

El backend define el conjunto de valores posibles de status y substatus. Consulta la referencia del workflow de cada flujo:

Verificar la disponibilidad de métodos de pago (Web)

Al crear una interfaz personalizada de selección de métodos de pago en lugar de usar paymentMethodList, puedes consultar si un método de pago específico es compatible con el dispositivo del comprador y está habilitado para la sesión de checkout actual antes de mostrar su opción. Llama a transaction.isPaymentMethodAvailable:

Parámetros

string
requerido
El tipo de método de pago que se va a verificar (p. ej. APPLE_PAY, GOOGLE_PAY, PAYPAL, CARD).

Valor de retorno

Devuelve un Promise<boolean>:
  • Se resuelve en true si el método de pago está habilitado en la sesión de checkout y es compatible con las capacidades del dispositivo/navegador (por ejemplo, al verificar que el dispositivo esté listo para Apple Pay o Google Pay).
  • Se resuelve en false si el método está deshabilitado en la sesión, no es compatible con el dispositivo/navegador del comprador, o si la transacción fue reemplazada.
  • Nunca se rechaza: los errores y las llamadas de red abortadas se resuelven de forma segura en false.
  • Solo está disponible en transacciones de pago. Llamarlo en una transacción de inscripción lanza un error.
Disponible en Yuno SDK Web 2.1.2 y versiones posteriores.