Posibles errores
A continuación encontrará listas de errores que pueden ocurrir durante la integración de los Bricks. Ya sean relacionadas con envío de variables o comunicación con servicios externos (APIs de Mercado Pago).
Variables pasadas por el integrador
Durante el proceso de integración del Brick, es posible que al momento de instanciar el Brick se muestren al integrador diferentes errores relacionados con el envío de variables. Estos errores se mostrarán mediante un log en la consola del navegador (el comprador no recibe ningún mensaje).
| Error | Mensaje | Código de causa |
| Objeto de configuración vacío | [Initialization error] Settings object is empty, please pass required properties [Error de inicialización] El objeto de configuración está vacío, pase las propiedades requeridas. | settings_empty |
| Ausencia de la propiedad amount (monto total de la compra) | [Initialization error] Amount property is required [Error de inicialización] Se requiere la propiedad amount. | missing_amount_property |
| Ausencia de los callbacks de onReady y onError | [Initialization error] Callbacks onReady and onError are required [Error de inicialización] Se requieren los callbacks onReady y onError. | missing_required_callbacks |
| Ausencia de un ID de un elemento HTML que sirva como container del Brick | [Initialization error] You must provide an HTML element ID as a container to allow component rendering [Error de inicialización] Debe proporcionar un ID de elemento HTML como contenedor para permitir la representación de componentes. | missing_container_id |
| Ausencia de la propiedad locale (idioma deseado) | [Initialization error] Locale property is required [Error de inicialización] Se requiere la propiedad de configuración regional. | missing_locale_property |
| Error genérico ocurrido durante la inicialización del Brick, generalmente alguna validación que falló debido a un valor enviado por el integrador | [Initialization error] Brick incorrectly initialized: {error} [Error de inicialización] Brick inicializado incorrectamente. | incorrect_initialization |
Comunicación con servicios externos (APIs de Mercado Pago)
| Error | Mensaje para el usuario | Mensaje para el integrador | ¿Crítico? | Código de causa |
| Incapacidad para generar Secure Fields dentro del formulario del Brick de Card Payment | Ocurrió un error | The integration with Secure Fields failed Falló la integración con Secure Fields, | Si | fields_setup_failed |
| No se pudo obtener la información del medios de pago según la public_key del integrador | Ocurrió un error. Por favor, inténtalo nuevamente más tarde. | An error occurred while trying to search for payment methods Ocurrió un error al intentar buscar métodos de pago. | No | get_payment_methods_failed |
| No se pudo crear el token que representa la información de la tarjeta | Ocurrió un error y no se pudo procesar el pago. Por favor, inténtalo de nuevo más tarde. | Failed to create card token No se pudo crear el token de la tarjeta. | No | card_token_creation_failed |
| Error al buscar tipos de documentos de identificación según el país definido en el SDK de MercadoPago.js | Ocurrió un error. Por favor, inténtalo nuevamente más tarde. | Failed to get identification types Error al obtener los tipos de identificación. | No | get_identification_types_failed |
| No se pudo obtener la información de la tarjeta basada en el bin | Ocurrió un error. Por favor, inténtalo nuevamente más tarde. | Failed to get payment methods using card bin No se pudo realizar el pago con el bin de la tarjeta. | No | get_card_bin_payment_methods_failed |
| Error al buscar bancos emisores de tarjetas | Ocurrió un error. Por favor, inténtalo nuevamente más tarde. | Failed to get card issuer(s) No se pudo obtener el(los) emisor(es) de la tarjeta. | No | get_card_issuers_failed |
| Error al buscar la cantidad y los montos de las cuotas de pago según el amount enviado por el integrador | Ocurrió un error. Por favor, inténtalo nuevamente más tarde. | Failed to get payment installments Error al obtener las cuotas de pago. | No | get_payment_installments_failed |
| Campos de pago incompletos por algún motivo (cuotas, emisor de la tarjeta, payment_method_id) | Ocurrió un error. Por favor, inténtalo nuevamente más tarde. | Se devolverá uno de los siguientes mensajes según el tipo de error: -The payment method id is missing -The payment installments are missing -The card issuer is missing -Falta el id del medio de pago. -Faltan las cuotas de pago. -Falta el emisor de la tarjeta. | No | missing_payment_information |
Cómo actualizar datos enviados durante la inicialización de un Brick
En caso de querer actualizar los valores enviados durante la inicialización de un Brick, es necesario explicitar la asincronicidad del código y valerse de la función de unmount disponible en el Controller del Brick antes de actualizar los datos. Además, el objeto de configuraciones debe ser enviado completo, dado que se trata de una renderización.
Es importante recordar que no se debe simplemente llamar a la función de renderización con los nuevos valores, ya que esto provocaría una duplicación del Brick en pantalla, y la segunda renderización mostrará un error.
El ejemplo de código a continuación ejemplifica el flujo utilizando la actualización de una preferencia en el Payment Brick, pero el flujo en sí es válido para la actualización necesaria en datos de inicialización de cualquier Brick.
amount debe ser un número entero.Javascript
//First render
const renderPaymentBrick = async (bricksBuilder) => {
const settings = {
initialization: {
amount: 100,
preferenceId: "<YOUR_FIRST_PREFERENCE_ID>"
},
...
window.paymentBrickController = await bricksBuilder.create(
"payment",
"paymentBrick_container",
settings
);
};
await renderPaymentBrick(bricksBuilder);
//Second render
window.paymentBrickController.unmount()
const secondRenderPaymentBrick = async (bricksBuilder) => {
const settings = {
initialization: {
amount: 100,
preferenceId: "<YOUR_SECOND_PREFERENCE_ID>"
},
...
window.paymentBrickController = await bricksBuilder.create(
"payment",
"paymentBrick_container",
settings
);
};
await secondRenderPaymentBrick(bricksBuilder);
...
// Brick Container
<div id="paymentBrick_container"></div>Error "Container Not Found"
Para que la renderización ocurra correctamente, es necesario que el ID del contenedor en el DOM donde se renderizará el Brick sea proporcionado de manera idéntica a la función de creación del Brick. Se puede utilizar cualquier cadena como nombre y, siempre y cuando los nombres sean iguales, este error no ocurrirá. Ten en cuenta que las clases no son aceptadas como contenedor para el Brick, es necesario que sea un ID.
Otro punto importante es asegurarse de que al llamar a la función de renderización del Brick, su contenedor ya esté renderizado en la pantalla. Reforzamos este punto debido a la posibilidad de que el contenedor del brick esté dentro de otros contenedores. Esta secuencia de renderización es importante para evitar el error mencionado.
A continuación, tenemos un fragmento de código que ejemplifica este punto utilizando el Payment Brick.
Javascript
const renderPaymentBrick = async (bricksBuilder) => {
const settings = { ... };
window.paymentBrickController = await bricksBuilder.create(
"payment",
"paymentBrick_container",
settings
);
};
await renderPaymentBrick(bricksBuilder);
...
<div id="paymentBrick_container"></div>Uso de Bricks con Next.js
Next.js es un framework para crear interfaces con componentes React. Por lo tanto, es posible utilizar nuestra SDK de React para integrar Bricks, así como otras soluciones proporcionadas a través de la SDK de React.
Sin embargo, nuestra SDK fue estructurada para renderizar en el cliente (Client Side Rendering), mientras que Next.js generalmente funciona con el Server Side Rendering (SSR). Por lo tanto, al utilizar nuestra SDK, es necesario tener esto en cuenta.
Es posible realizar esta integración mediante la importación dinámica de la SDK, como se indica en la documentación de Next.js. A continuación, encontrarás un ejemplo de código para importar dinámicamente un componente proporcionado en nuestra SDK, el Payment Brick.
react-jsx
//index.tsx
import Head from "next/head";
import styles from "../styles/Home.module.css";
import dynamic from "next/dynamic";
const CheckoutMercadoPago = dynamic(() => import("./checkoutMercadoPago"), {
ssr: false,
});
export default function Home() {
return (
<>
<Head>
<title>Checkout Brick + NextJS</title>
<meta name="description" content="Generated by create next app" />
</Head>
<main className={styles.main}>
<CheckoutMercadoPago />
</main>
</>
);
}
react-jsx
//checkoutMercadoPago.tsx
import { initMercadoPago, Payment } from "@mercadopago/sdk-react";
initMercadoPago("<YOUR_PUBLIC_KEY>");
const CheckoutMercadoPago = () => {
const initialization = {
amount: <YOUR_AMOUNT>,
preferenceId: "<YOUR_PREFERENCE_ID>"
};
const customization = {
paymentMethods: {
ticket: "all",
bankTransfer: "all",
creditCard: "all",
debitCard: "all",
mercadoPago: "all",
},
};
const onSubmit = async ({ selectedPaymentMethod, formData }) => {
// callback llamado al hacer clic en el botón enviar datos
return new Promise((resolve, reject) => {
fetch("/process_payment", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(formData),
})
.then((response) => response.json())
.then((response) => {
// recibir el resultado del pago
resolve();
})
.catch((error) => {
// manejar la respuesta de error al intentar crear el pago
reject();
});
});
};
const onError = async (error) => {
// callback llamado para todos los casos de error de Brick
console.log(error);
};
const onReady = async () => {
/*
Callback llamado cuando el Brick está listo.
Aquí puede ocultar cargamentos de su sitio, por ejemplo.
*/
};
return (
<Payment
initialization={initialization}
customization={customization}
onSubmit={onSubmit}
onReady={onReady}
onError={onError}
/>
);
};
export default CheckoutMercadoPago;