- Status
- OneTimeToken
El objeto status informa cómo terminó la transacción. El SDK lo entrega mediante ¿Falla del backend o falla del SDK? Lee
Una falla del lado del SDK (red, renderizado, excepción inesperada) llega así:En Web,
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 comoINTERNAL_ERRORconmessage.codeUNSUPPORTED_STATUSymessage.reasondefinido comounsupported status: <value>.substatus: se transmite exactamente como lo devuelve el backend. En Web, un substatus vacío o ausente llega comonull.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.
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.reasonesunsupported status: <value>.FORM_INVALID. El formulario enviado no es válido. No es final.ELEMENT_NOT_FOUND. El elemento que se pasó apaymentMethodList.mount()no está en el DOM, o el contenedor del formulario se eliminó mientras el formulario se cargaba. UnelementSelectorde configuración que no coincide con nada hace questart()se rechace conelementSelector "<selector>" was not found in the document.en su lugar.COLLECT_FAILED. En modo manual (pasascreatePayment), la billetera de Mercado Pago no pudo recopilar los datos del pago.message.reasonempieza conMERCADO_PAGO_.UNEXPECTED_ERROR. Un fallo que el SDK no clasifica.message.reasonincluye el mensaje de error.
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í: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 destatus 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 usarpaymentMethodList, 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
El tipo de método de pago que se va a verificar (p. ej.
APPLE_PAY, GOOGLE_PAY, PAYPAL, CARD).Valor de retorno
Devuelve unPromise<boolean>:
- Se resuelve en
truesi 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
falsesi 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.
Relacionado
- Objetos que pasas. Lo que tu app entrega al SDK.
onStatus. Dónde se entregaStatus.- Toma el control del SDK. Dónde se entrega
OneTimeToken.