Integración avanzada API Pay Bi

[menu_lateral_paybi titulo_tipo=”imagen” grupos=”%5B%7B%22grupo_id%22%3A%22inicio%22%2C%22grupo%22%3A%22Empezar%22%2C%22icono%22%3A%22bi-icons-casa%22%7D%2C%7B%22grupo_id%22%3A%22autenticacion%22%2C%22grupo%22%3A%22Autenticaci%C3%B3n%22%2C%22icono%22%3A%22bi-icons-usuario-aceptar%22%7D%2C%7B%22grupo_id%22%3A%22catalogo%22%2C%22grupo%22%3A%22Cat%C3%A1logo%22%2C%22icono%22%3A%22bi-icons-internet%22%7D%2C%7B%22grupo_id%22%3A%22nucleo%20del%20cobro%22%2C%22grupo%22%3A%22N%C3%BAcleo%20del%20Cobro%22%2C%22icono%22%3A%22bi-icons-enlace%22%7D%2C%7B%22grupo_id%22%3A%22opcional%22%2C%22grupo%22%3A%22Opcional%22%2C%22icono%22%3A%22bi-icons-factura-laptop%22%7D%2C%7B%22grupo_id%22%3A%22consulta%22%2C%22grupo%22%3A%22Consulta%22%2C%22icono%22%3A%22bi-icons-buscador%22%7D%2C%7B%22grupo_id%22%3A%22configuracion%20una%20sola%20vez%22%2C%22grupo%22%3A%22Configuraci%C3%B3n%20una%20sola%20vez%22%2C%22icono%22%3A%22bi-icons-usuario-ajustes%22%7D%2C%7B%22grupo_id%22%3A%22el%20paso%20que%20mas%20se%20pasa%20por%20alto%22%2C%22grupo%22%3A%22El%20paso%20que%20m%C3%A1s%20se%20pasa%20por%20alto%22%2C%22icono%22%3A%22bi-icons-lista%22%7D%2C%7B%22grupo_id%22%3A%22implementacion%20de%20referencia%22%2C%22grupo%22%3A%22Implementaci%C3%B3n%20de%20referencia%22%2C%22icono%22%3A%22bi-icons-archivo%22%7D%2C%7B%22grupo_id%22%3A%22antes%20de%20salir%20a%20produccion%22%2C%22grupo%22%3A%22Antes%20de%20salir%20a%20producci%C3%B3n%22%2C%22icono%22%3A%22bi-icons-desktop-aceptar%22%7D%5D” enlaces=”%5B%7B%22enlace_grupo_id%22%3A%22inicio%22%2C%22texto%22%3A%22Arquitectura%22%2C%22ancla%22%3A%22seccion1%22%7D%2C%7B%22enlace_grupo_id%22%3A%22autenticacion%22%2C%22texto%22%3A%22M%C3%A9todo%20Login%22%2C%22ancla%22%3A%22autenticacion%22%7D%2C%7B%22enlace_grupo_id%22%3A%22catalogo%22%2C%22texto%22%3A%22M%C3%A9todo%20Redes%20sociales%22%2C%22ancla%22%3A%22MetodoRedessociales%22%7D%2C%7B%22enlace_grupo_id%22%3A%22nucleo%20del%20cobro%22%2C%22texto%22%3A%22M%C3%A9todo%20Link%22%2C%22ancla%22%3A%22MetodoLink%22%7D%2C%7B%22enlace_grupo_id%22%3A%22opcional%22%2C%22texto%22%3A%22Link%20con%20Factura%20Electr%C3%B3nica%22%2C%22ancla%22%3A%22linkconfacturaelectronica%22%7D%2C%7B%22enlace_grupo_id%22%3A%22opcional%20%22%2C%22texto%22%3A%22M%C3%A9todo%20de%20Imagen%22%2C%22ancla%22%3A%22metodoimagen%22%7D%2C%7B%22enlace_grupo_id%22%3A%22consulta%22%2C%22texto%22%3A%22M%C3%A9todo%20Mostrar%20Links%22%2C%22ancla%22%3A%22metodomostrarlinks%22%7D%2C%7B%22enlace_grupo_id%22%3A%22consulta%22%2C%22texto%22%3A%22M%C3%A9todo%20Buscar%20Link%22%2C%22ancla%22%3A%22metodobuscarlink%22%7D%2C%7B%22enlace_grupo_id%22%3A%22consulta%22%2C%22texto%22%3A%22M%C3%A9todo%20Mostrar%20Carteras%22%2C%22ancla%22%3A%22metodomostrarcarteras%22%7D%2C%7B%22enlace_grupo_id%22%3A%22configuracion%20una%20sola%20vez%22%2C%22texto%22%3A%22URLs%20de%20%C3%A9xito%20o%20rechazo%22%2C%22ancla%22%3A%22configuracionunasolavez%22%7D%2C%7B%22enlace_grupo_id%22%3A%22el%20paso%20que%20mas%20se%20pasa%20por%20alto%22%2C%22texto%22%3A%22Desencriptar%20la%20confirmaci%C3%B3n%20de%20pago%22%2C%22ancla%22%3A%22desencriptarlaconfirmaciondepago%22%7D%2C%7B%22enlace_grupo_id%22%3A%22implementacion%20de%20referencia%22%2C%22texto%22%3A%22Backend%20completo%20en%20PHP%22%2C%22ancla%22%3A%22implementaciondereferencia%22%7D%2C%7B%22enlace_grupo_id%22%3A%22implementacion%20de%20referencia%22%2C%22texto%22%3A%22Backend%20completo%20en%20Node.js%22%2C%22ancla%22%3A%22BackendcompletoenNodejs%22%7D%2C%7B%22enlace_grupo_id%22%3A%22implementacion%20de%20referencia%22%2C%22texto%22%3A%22Caso%20de%20estudio%3A%20integraci%C3%B3n%20completa%22%2C%22ancla%22%3A%22Casodeestudiointegracioncompleta%22%7D%2C%7B%22enlace_grupo_id%22%3A%22antes%20de%20salir%20a%20produccion%22%2C%22texto%22%3A%22Checklist%20de%20salida%20a%20producci%C3%B3n%22%2C%22ancla%22%3A%22checklistdesalidaaproduccion%22%7D%5D” titulo_imagen=”7859″]

Guia de integracion para desarrolladores

Guía de Integración

API Pay Bi

Referencia técnica oficial de la API Pay Bi: autenticación, creación de links, factura electrónica, y lectura segura de la confirmación de pago.

Incluye ejemplos en PHP y Node.js.

[texto_separadores_paybi separadores=”superior” etiqueta=”01 · ARQUITECTURA” titulo=”Cómo encajan los métodos entre sí” el_id=”seccion1″]

Pay Bi expone una API REST por POST con cuerpo multipart/form-data . Casi todos los métodos comparten dos parámetros: llave (fija, de tu comercio) y token (vence al hacer un nuevo login). El flujo típico para cobrar dentro de tu sitio es: autenticar → obtener catálogo de redes → crear el link → redirigir al comprador → leer la confirmación en tu URL de retorno.

[/texto_separadores_paybi]

[cards_pasos_paybi pasos=”%5B%7B%22pill%22%3A%22Paso%201%22%2C%22titulo%22%3A%22Login%22%2C%22descripcion%22%3A%22Tu%20backend%20obtiene%20un%20token%20temporal.%5CnCada%20login%20invalida%20el%20anterior.%22%7D%2C%7B%22pill%22%3A%22Paso%202%22%2C%22titulo%22%3A%22Redes%20sociales%22%2C%22descripcion%22%3A%22Consultas%20el%20cat%C3%A1logo%20de%20canales%20para%20saber%20qu%C3%A9%20c%C3%B3digo%20usar%20al%20crear%20el%20link.%22%7D%2C%7B%22pill%22%3A%22Paso%203%22%2C%22titulo%22%3A%22Crear%20Link%22%2C%22descripcion%22%3A%22Env%C3%ADas%20producto%2C%20monto%20y%20red%20social.%20Recibes%20una%20URL%20de%20pago%20por%20cada%20red%20enviada.%22%7D%2C%7B%22pill%22%3A%22Paso%204%22%2C%22titulo%22%3A%22Checkout%22%2C%22descripcion%22%3A%22El%20comprador%20paga%20en%20una%20pesta%C3%B1a%20nueva%20de%20Pay%20Bi.%20No%20es%20embebible%20por%20seguridad.%22%7D%2C%7B%22pill%22%3A%22Paso%205%22%2C%22titulo%22%3A%22Retorno%22%2C%22descripcion%22%3A%22Pay%20Bi%20redirige%20a%20tu%20URL%20configurada%20con%20campos%20encriptados%20AES-256-CBC.%22%7D%5D”][banner_icono_paybi variante=”warning” icono=”bi-icons-advertencia”]

El link no se puede embeber en un iframe o modal. Por política de seguridad de Pay Bi, todo link de pago abre en una pestaña nueva del navegador. Tu integración debe diseñarse para abrir esa pestaña y luego reaccionar a la URL de retorno, no para incrustar el checkout dentro de tu página.

[/banner_icono_paybi][banner_icono_paybi]

Todo esto corre en tu servidor, nunca en el navegador del comprador. El login y la creación de links requieren la llave y credenciales de tu comercio, así que deben ejecutarse desde tu backend. Lo mismo aplica al endpoint que recibe la confirmación de pago (URL de éxito/rechazo): ahí es donde desencriptas el resultado con tu llave CST , y esa llave tampoco debe llegar nunca al cliente.

[/banner_icono_paybi][banner_icono_paybi variante=”warning” icono=”bi-icons-advertencia”]

La API tiene un límite global de solicitudes por hora por empresa. Cada llamada a cualquier método — login, crear link, listar redes, etc. — cuenta hacia el mismo límite compartido. Diseña tu integración para minimizar llamadas: reutiliza el token en vez de hacer login en cada request, y cachea catálogos como redes sociales o carteras en lugar de consultarlos en cada operación. Si tu volumen de transacciones requiere un límite más alto, contacta al banco en comercio@ebi.com.gt

[/banner_icono_paybi]

[texto_separadores_paybi separadores=”superior” etiqueta=”02 · AUTENTICACIÓN” titulo=”Método Login” el_id=”autenticacion”]

Intercambia usuario y contraseña del comercio por un token temporal. Ese token se reutiliza en el resto de métodos. Importante: cada nuevo login invalida el token anterior — no hagas login en cada request, guarda y reutiliza el token mientras siga vigente.

[/texto_separadores_paybi]

Inicio de sesión

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22usuario%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22Usuario%20de%20login%20en%20el%20sistema%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22clave%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22Contrase%C3%B1a%20de%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]

Respuesta

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22result%22%2C%22contenido%22%3A%22Indicador%20de%20respuesta%3A%20%5C%22success%5C%22%20si%20fue%20v%C3%A1lida.%22%7D%2C%7B%22etiqueta%22%3A%22message%22%2C%22contenido%22%3A%22Detalle%20de%20la%20respuesta%20del%20m%C3%A9todo.%22%7D%2C%7B%22etiqueta%22%3A%22data.token%22%2C%22contenido%22%3A%22Token%20temporal%20para%20consumir%20el%20resto%20de%20m%C3%A9todos.%22%7D%5D”]

Ejemplo de respuesta real

[bloque_codigo ajustar_lineas=”si” codigo=”JTdCJTBBJTIycmVzdWx0JTIyJTNBJTIwJTIyc3VjY2VzcyUyMiUyQyUwQSUyMm1lc3NhZ2UlMjIlM0ElMjAlMjIlQzIlQTFQcm9jZXNvJTIwZmluYWxpemFkbyUyMSUyQyUyMHRva2VuJTIwZ2VuZXJhZG8lMjBjb3JyZWN0YW1lbnRlJTIyJTJDJTBBJTIyZGF0YSUyMiUzQSUyMCU3QiUwQSUyMnRva2VuJTIyJTNBJTIwJTIyNjY3ZGI3YWU1ZDZlYTRiZDg1MTZlMmM0ZGNlYmY4MTVkOTk5NGFjYSUyMiUwQSU3RCUwQSU3RA==”][bloques_codigo][pestana_codigo lenguaje=”php” codigo=”JTNDJTNGcGhwJTBBJTI0bGxhdmUlMjAlM0QlMjAlMjcyNGRkNjI0OTc4N2Q5MTg3MGJmODliMzZmYWU0MzA3YmNiZDIxMjI2JTI3JTNCJTBBJTI0dXN1YXJpbyUyMCUzRCUyMCUyN3R1X3VzdWFyaW8lNDB0dWNvbWVyY2lvLmNvbSUyNyUzQiUwQSUyNGNsYXZlJTIwJTNEJTIwJTI3dHVfY2xhdmVfc2VjcmV0YSUyNyUzQiUwQSUwQSUyNGNoJTIwJTNEJTIwY3VybF9pbml0JTI4JTI3aHR0cHMlM0ElMkYlMkZhZG1saW5rLmViaS5jb20uZ3QlMkZhcGklMkZsb2dpbiUyNyUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1BPU1QlMkMlMjB0cnVlJTI5JTNCJTBBY3VybF9zZXRvcHQlMjglMjRjaCUyQyUyMENVUkxPUFRfUkVUVVJOVFJBTlNGRVIlMkMlMjB0cnVlJTI5JTNCJTBBY3VybF9zZXRvcHQlMjglMjRjaCUyQyUyMENVUkxPUFRfUE9TVEZJRUxEUyUyQyUyMCU1QiUwQSUyMCUyMCUyMCUyMCUyN2xsYXZlJTI3JTIwJTIwJTIwJTNEJTNFJTIwJTI0bGxhdmUlMkMlMEElMjAlMjAlMjAlMjAlMjd1c3VhcmlvJTI3JTIwJTNEJTNFJTIwJTI0dXN1YXJpbyUyQyUwQSUyMCUyMCUyMCUyMCUyN2NsYXZlJTI3JTIwJTIwJTIwJTNEJTNFJTIwJTI0Y2xhdmUlMkMlMEElNUQlMjklM0IlMEElMEElMjRyZXNwdWVzdGElMjAlM0QlMjBqc29uX2RlY29kZSUyOGN1cmxfZXhlYyUyOCUyNGNoJTI5JTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfY2xvc2UlMjglMjRjaCUyOSUzQiUwQSUwQSUyRiUyRiUyMEd1YXJkYSUyMGVsJTIwdG9rZW4lMjBlbiUyMHNlc2klQzMlQjNuJTIwbyUyMGNhY2glQzMlQTklMjAlRTIlODAlOTQlMjBOTyUyMHJlcGl0YXMlMjBsb2dpbiUyMGVuJTIwY2FkYSUyMHJlcXVlc3QlMEFpZiUyMCUyOCUyNHJlc3B1ZXN0YSU1QiUyN3Jlc3VsdCUyNyU1RCUyMCUzRCUzRCUzRCUyMCUyN3N1Y2Nlc3MlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjRfU0VTU0lPTiU1QiUyN3BheWJpX3Rva2VuJTI3JTVEJTIwJTNEJTIwJTI0cmVzcHVlc3RhJTVCJTI3ZGF0YSUyNyU1RCU1QiUyN3Rva2VuJTI3JTVEJTNCJTBBJTdE”][pestana_codigo lenguaje=”javascript” codigo=”aW1wb3J0JTIwYXhpb3MlMjBmcm9tJTIwJTI3YXhpb3MlMjclM0IlMEFpbXBvcnQlMjBxcyUyMGZyb20lMjAlMjdxcyUyNyUzQiUwQSUwQWNvbnN0JTIwTExBVkUlMjAlM0QlMjAlMjcyNGRkNjI0OTc4N2Q5MTg3MGJmODliMzZmYWU0MzA3YmNiZDIxMjI2JTI3JTNCJTBBJTBBYXN5bmMlMjBmdW5jdGlvbiUyMGxvZ2luUGF5QmklMjglMjklMjAlN0IlMEElMjAlMjAlMjAlMjBjb25zdCUyMCU3QiUyMGRhdGElMjAlN0QlMjAlM0QlMjBhd2FpdCUyMGF4aW9zLnBvc3QlMjglMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRmxvZ2luJTI3JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcXMuc3RyaW5naWZ5JTI4JTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwbGxhdmUlM0ElMjBMTEFWRSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHVzdWFyaW8lM0ElMjBwcm9jZXNzLmVudi5QQVlCSV9VU0VSJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY2xhdmUlM0ElMjBwcm9jZXNzLmVudi5QQVlCSV9QQVNTJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdCJTIwJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaGVhZGVycyUzQSUyMCU3QiUyMCUyN0NvbnRlbnQtVHlwZSUyNyUzQSUyMCUyN2FwcGxpY2F0aW9uJTJGeC13d3ctZm9ybS11cmxlbmNvZGVkJTI3JTIwJTdEJTIwJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTI5JTNCJTBBJTBBJTIwJTIwJTIwJTIwaWYlMjAlMjhkYXRhLnJlc3VsdCUyMCUzRCUzRCUzRCUyMCUyN3N1Y2Nlc3MlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMkYlMkYlMjBDYWNoJUMzJUE5YWxvJTIwJTI4UmVkaXMlMkMlMjBtZW1vcmlhJTJDJTIwZXRjLiUyOSUyMCVFMiU4MCU5NCUyMG5vJTIwcmVwaXRhcyUyMGxvZ2luJTIwcG9yJTIwcmVxdWVzdCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMGRhdGEuZGF0YS50b2tlbiUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSUwQSUyMCUyMCUyMCUyMHRocm93JTIwbmV3JTIwRXJyb3IlMjhkYXRhLm1lc3NhZ2UlMjklM0IlMEElN0QlMEElMEFleHBvcnQlMjAlN0IlMjBsb2dpblBheUJpJTIwJTdEJTNC”][pestana_codigo][pestana_codigo][pestana_codigo][/bloques_codigo][banner_icono_paybi variante=”danger”]

Nunca expongas usuario, clave ni la llave en el frontend. El login debe correr exclusivamente en tu servidor. El navegador del comprador solo debería recibir la URL de pago final que genera el método link, nunca tus credenciales de Pay Bi.

[/banner_icono_paybi]

Errores comunes

Toda respuesta de error sigue el mismo formato: result: "error" , un message descriptivo, y data: [] . Maneja los errores de forma genérica — si result no es "success" , registra message y trata la solicitud como fallida.
[tabla_faqebi_manuales_1 encabezado_1=”CAUSA” encabezado_2=”MESSAGE” filas=”%5B%7B%22titulo%22%3A%22Llave%20de%20acceso%20inv%C3%A1lida%22%2C%22descripcion%22%3A%22%5BKey%5D%3A%20Llave%20de%20acceso%20inv%C3%A1lida%22%7D%2C%7B%22titulo%22%3A%22Demasiados%20intentos%20fallidos%20desde%20la%20misma%20IP%22%2C%22descripcion%22%3A%22%5BPermisos%5D%3A%20Su%20direcci%C3%B3n%20Ip%20est%C3%A1%20bloqueada%2C%20por%20favor%20contactar%20a%5Cnsoporte%22%7D%2C%7B%22titulo%22%3A%22Falta%20alg%C3%BAn%20campo%20obligatorio%20en%20la%20solicitud%22%2C%22descripcion%22%3A%22%5BDatos%20requeridos%5D%3A%20Datos%20insuficientes%20para%20el%20uso%20del%20m%C3%A9todo%22%7D%5D”][bloque_codigo codigo=”JTdCJTBBJTIwJTIwJTIwJTIwJTIycmVzdWx0JTIyJTNBJTIwJTIyZXJyb3IlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjJtZXNzYWdlJTIyJTNBJTIwJTIyJTVCS2V5JTVEJTNBJTIwTGxhdmUlMjBkZSUyMGFjY2VzbyUyMGludiVDMyVBMWxpZGElMjIlMkMlMEElMjAlMjAlMjAlMjAlMjJkYXRhJTIyJTNBJTIwJTVCJTVEJTBBJTdE”]
[texto_separadores_paybi separadores=”superior” etiqueta=”03 · CATÁLOGO” titulo=”Método Redes sociales” el_id=”MetodoRedessociales”]Identifica el canal de venta por donde se publicará el link de pago (puede ser tu propio sitio web, no necesariamente una red social literal). Devuelve un listado de códigos que luego se usan en Crear / editar link.[/texto_separadores_paybi]

Listar redes sociales

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22token%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Token%20generado%20en%20el%20m%C3%A9todo%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]

Respuesta · data[]

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22codigo%22%2C%22contenido%22%3A%22C%C3%B3digo%20a%20usar%20luego%20en%20redes_sociales%20del%20m%C3%A9todo%20link.%22%7D%2C%7B%22etiqueta%22%3A%22nombre%22%2C%22contenido%22%3A%22Nombre%20legible%20del%20canal.%22%7D%5D”]

Ejemplo de respuesta real

[bloque_codigo ajustar_lineas=”si” codigo=”JTdCJTBBJTIwJTIwJTIwJTIwJTIycmVzdWx0JTIyJTNBJTIwJTIyc3VjY2VzcyUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMm1lc3NhZ2UlMjIlM0ElMjAlMjIlQzIlQTFCdXNxdWVkYSUyMGV4aXRvc2ElMjElMjIlMkMlMEElMjAlMjAlMjAlMjAlMjJkYXRhJTIyJTNBJTIwJTVCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdCJTIwJTIyY29kaWdvJTIyJTNBJTIwJTIyMTY3MzI2ODM1NjY5NjVkNzAlMjIlMkMlMjAlMjJub21icmUlMjIlM0ElMjAlMjJDJUMzJUIzZGlnbyUyMFFSJTIyJTIwJTdEJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdCJTIwJTIyY29kaWdvJTIyJTNBJTIwJTIyMTYyMTI4MjczN2M3NWQyMmIlMjIlMkMlMjAlMjJub21icmUlMjIlM0ElMjAlMjJFbWFpbCUyMiUyMCU3RCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3QiUyMCUyMmNvZGlnbyUyMiUzQSUyMCUyMjE2MjE4Nzc0NjkyYzk0NDZmJTIyJTJDJTIwJTIybm9tYnJlJTIyJTNBJTIwJTIyRmFjZWJvb2slMjIlMjAlN0QlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0IlMjAlMjJjb2RpZ28lMjIlM0ElMjAlMjIxNjIxODc3NDkwNzM1YzJmZiUyMiUyQyUyMCUyMm5vbWJyZSUyMiUzQSUyMCUyMkluc3RhZ3JhbSUyMiUyMCU3RCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3QiUyMCUyMmNvZGlnbyUyMiUzQSUyMCUyMjE2MjEyODI3MzdmZTUyNDUwJTIyJTJDJTIwJTIybm9tYnJlJTIyJTNBJTIwJTIyV2hhdHNBcHAlMjIlMjAlN0QlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0IlMjAlMjJjb2RpZ28lMjIlM0ElMjAlMjIxNjIxMjgyNzM3MWU5MDVjZiUyMiUyQyUyMCUyMm5vbWJyZSUyMiUzQSUyMCUyMlglMjIlMjAlN0QlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0IlMjAlMjJjb2RpZ28lMjIlM0ElMjAlMjIxNjIxMjgyNzM3MDU5OTQyYiUyMiUyQyUyMCUyMm5vbWJyZSUyMiUzQSUyMCUyMkJvdCVDMyVCM24lMjBkZSUyMFBhZ28lMjIlMjAlN0QlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0IlMjAlMjJjb2RpZ28lMjIlM0ElMjAlMjIxNzI5ODUxNTEwNzNiNjJiNSUyMiUyQyUyMCUyMm5vbWJyZSUyMiUzQSUyMCUyMkFQSSUyMiUyMCU3RCUwQSUyMCUyMCUyMCUyMCU1RCUwQSU3RA==”]

Qué hace cada canal al pagar

No todos los canales se comportan igual una vez que el comprador paga. Esto determina cuál te conviene usar según cómo integres el botón en tu backend.

[tabla_faqebi_manuales_1 encabezado_1=”CANAL” encabezado_2=”COMPORTAMIENTO TRAS EL PAGO” filas=”%5B%7B%22titulo%22%3A%22Bot%C3%B3n%20de%20Pago%22%2C%22descripcion%22%3A%22Redirige%20a%20la%20URL%20de%20%C3%A9xito%2Frechazo%20que%20configuraste%20en%20el%20panel%22%7D%2C%7B%22titulo%22%3A%22API%22%2C%22descripcion%22%3A%22Redirige%20a%20la%20URL%20de%20%C3%A9xito%2Frechazo%20que%20configuraste%20en%20el%20panel%22%7D%2C%7B%22titulo%22%3A%22C%C3%B3digo%20QR%22%2C%22descripcion%22%3A%22No%20redirige%3A%20el%20m%C3%A9todo%20imagen%20%2F%20la%20propia%20respuesta%20devuelve%20una%20imagen%20del%20QR%20para%20mostrar%20o%20imprimir%22%7D%2C%7B%22titulo%22%3A%22Email%2C%20Facebook%2C%20Instagram%2C%20WhatsApp%2C%20X%22%2C%22descripcion%22%3A%22No%20redirigen%3A%20el%20link%20simplemente%20se%20desactiva%20despu%C3%A9s%20de%20pagado%2C%20sin%20enviar%20al%20comprador%5Cna%20ninguna%20URL%22%7D%5D”][banner_icono_paybi variante=”warning”]

Para un botón de pagos integrado en tu sitio, usa API o Botón de Pago . Son los únicos dos canales de esta lista que devuelven al comprador a tu URL de éxito/rechazo configurada — el resto (WhatsApp, redes sociales, email, etc.) están pensados para compartir el link manualmente y solo desactivan el link al pagar, sin ningún redireccionamiento que tu backend pueda procesar.

[/banner_icono_paybi]

Ejemplo

[bloques_codigo][pestana_codigo lenguaje=”javascript” codigo=”YXN5bmMlMjBmdW5jdGlvbiUyMGxpc3RhclJlZGVzU29jaWFsZXMlMjh0b2tlbiUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwJTdCJTIwZGF0YSUyMCU3RCUyMCUzRCUyMGF3YWl0JTIwYXhpb3MucG9zdCUyOCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyN2h0dHBzJTNBJTJGJTJGYWRtbGluay5lYmkuY29tLmd0JTJGYXBpJTJGbmV0d29yayUyRmFsbCUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHFzLnN0cmluZ2lmeSUyOCU3QiUyMGxsYXZlJTNBJTIwTExBVkUlMkMlMjB0b2tlbiUyMCU3RCUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3QiUyMCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGhlYWRlcnMlM0ElMjAlN0IlMjAlMjdDb250ZW50LVR5cGUlMjclM0ElMjAlMjdhcHBsaWNhdGlvbiUyRngtd3d3LWZvcm0tdXJsZW5jb2RlZCUyNyUyMCU3RCUyMCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUwQSUyMCUyMCUyMCUyMCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUwQSUyMCUyMCUyMCUyMHJldHVybiUyMGRhdGEuZGF0YSUzQiUyMCUyRiUyRiUyMCU1QiU3QiUyMGNvZGlnbyUyQyUyMG5vbWJyZSUyMCU3RCUyQyUyMC4uLiU1RCUwQSU3RA==”][pestana_codigo lenguaje=”php” codigo=”JTJGJTJGJTIwUmV1dGlsaXphJTIwZWwlMjB0b2tlbiUyMG9idGVuaWRvJTIwZW4lMjBlbCUyMGxvZ2luJTBBJTI0Y2glMjAlM0QlMjBjdXJsX2luaXQlMjglMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRm5ldHdvcmslMkZhbGwlMjclMjklM0IlMEFjdXJsX3NldG9wdCUyOCUyNGNoJTJDJTIwQ1VSTE9QVF9QT1NUJTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1JFVFVSTlRSQU5TRkVSJTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1BPU1RGSUVMRFMlMkMlMjAlNUIlMEElMjdsbGF2ZSUyNyUyMCUzRCUzRSUyMCUyNGxsYXZlJTJDJTBBJTI3dG9rZW4lMjclMjAlM0QlM0UlMjAlMjRfU0VTU0lPTiU1QiUyN3BheWJpX3Rva2VuJTI3JTVEJTJDJTBBJTVEJTI5JTNCJTBBJTI0cmVkZXMlMjAlM0QlMjBqc29uX2RlY29kZSUyOGN1cmxfZXhlYyUyOCUyNGNoJTI5JTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfY2xvc2UlMjglMjRjaCUyOSUzQiUwQSUyRiUyRiUyMCUyNHJlZGVzJTVCJTI3ZGF0YSUyNyU1RCUyMCUzRCUzRSUyMCU1QiUyMCU1QiUyN2NvZGlnbyUyNyUyMCUzRCUzRSUyMCUyNy4uLiUyNyUyQyUyMCUyN25vbWJyZSUyNyUyMCUzRCUzRSUyMCUyN0FQSSUyNyU1RCUyQyUyMC4uLiUyMCU1RA==”][/bloques_codigo]
[texto_separadores_paybi separadores=”superior” etiqueta=”04 · NÚCLEO DEL COBRO” titulo=”Método Link — crear y editar” el_id=”MetodoLink”]

Genera el link de pago. Si codigo_interno ya existe, edita ese link en vez de crear uno nuevo. Devuelve una URL distinta por cada red social enviada en redes_sociales .

[/texto_separadores_paybi]

Crear / editar link de pago

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”5″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”CREAR” encabezado_5=”EDITAR” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22token%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Token%20del%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22codigo_interno%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22Identificador%20%C3%BAnico%20del%20link%20(vac%C3%ADo%20%3D%20se%20autogenera).%20Si%20env%C3%ADas%20uno%20existente%2C%5Cnedita%20ese%20link.%20No%20lo%20uses%20como%20referencia%20interna%20de%20tu%20sistema%20%E2%80%94%20para%5Cneso%20est%C3%A1%20nombre_interno%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22nombre_interno%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22No%20p%C3%BAblico.%20Aqu%C3%AD%20va%20tu%20referencia%20interna%20real%20%E2%80%94%20ID%20de%20pedido%2C%20de%20producto%2C%20o%20cualquier%20referencia%20interna%20que%20identifique%20la%20venta%20en%20tu%20sistema%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22titulo%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22T%C3%ADtulo%20del%20link%20(visible%20al%20pagador)%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22descripcion%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Descripci%C3%B3n%20del%20link.%20Admite%20HTML%20simple%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22monto%22%2C%22tipo%22%3A%22double%22%2C%22descripcion%22%3A%22double%22%2C%22columna_3%22%3A%220%20%3D%20link%20abierto%20(el%20pagador%20define%20el%20monto).%20Cualquier%20otro%20valor%20%3D%20monto%20fijo%2C%20ej.%201230.50%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22cuotas%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22Un%20%C3%BAnico%20c%C3%B3digo%20de%20cuota%20por%20solicitud.%20Ver%20tabla%20completa%20abajo%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22redes_sociales%22%2C%22tipo%22%3A%22varchar(500)%22%2C%22descripcion%22%3A%22varchar(500)%22%2C%22columna_3%22%3A%22C%C3%B3digo%20del%20canal%20de%20venta%20(del%20m%C3%A9todo%20redes%20sociales).%20Un%20%C3%BAnico%20c%C3%B3digo%20por%20solicitud%22%2C%22columna_4%22%3A%22S%C3%AD%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22estado%22%2C%22tipo%22%3A%22tinyint(1)%22%2C%22descripcion%22%3A%22tinyint(1)%22%2C%22columna_3%22%3A%22Oculto%20o%20Activo%20(tambi%C3%A9n%20restablece%20intentos%20de%20rechazo)%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22eliminar_imagen%22%2C%22tipo%22%3A%22tinyint(1)%22%2C%22descripcion%22%3A%22tinyint(1)%22%2C%22columna_3%22%3A%221%20elimina%20la%20imagen%20actual%20del%20link%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22transferencia_bancaria%22%2C%22tipo%22%3A%22tinyint(1)%22%2C%22descripcion%22%3A%22tinyint(1)%22%2C%22columna_3%22%3A%221%20habilita%20transferencia%20bancaria%20como%20medio%20de%20pago%20alterno%20a%20tarjeta%20%E2%80%94%20requiere%20habilitaci%C3%B3n%20previa%20del%20banco%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22zigi%22%2C%22tipo%22%3A%22tinyint(1)%22%2C%22descripcion%22%3A%22tinyint(1)%22%2C%22columna_3%22%3A%221%20habilita%20Zigi%20como%20medio%20de%20pago%20alterno%20a%20tarjeta%20%E2%80%94%20requiere%20habilitaci%C3%B3n%20previa%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22titulo_zigi%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22T%C3%ADtulo%20mostrado%20al%20pagador%20cuando%20paga%20con%20Zigi%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22excluir_cartera%22%2C%22tipo%22%3A%22tinyint(1)%22%2C%22descripcion%22%3A%22tinyint(1)%22%2C%22columna_3%22%3A%221%20%3D%20la%20cartera%20indicada%20se%20excluye%20(todo%20BIN%20excepto%20esos)%20%C2%B7%200%20%3D%20la%20cartera%20se%20incluye%20(solo%20esos%20BINes%20pueden%20pagar)%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22cartera%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22C%C3%B3digo%20de%20la%20cartera%20de%20BINes%20(del%20m%C3%A9todo%20Mostrar%20Carteras)%20a%20aplicar%20sobre%20este%20link%20%E2%80%94%20requiere%20habilitaci%C3%B3n%20previa%22%2C%22columna_4%22%3A%22No%22%2C%22columna_5%22%3A%22No%22%7D%5D”]
[banner_icono_paybi]

No mezcles el ID del link con tu ID de pedido. codigo_interno es el identificador que controla si estás creando un link nuevo o editando uno existente — está atado a la lógica de generación del link, no a tu negocio. Para tu propia referencia (ID de pedido, de producto, lo que corresponda), usa nombre_interno : ese campo está desligado de esa lógica y es justo para lo que tu sistema necesite identificar internamente.

[/banner_icono_paybi][banner_icono_paybi variante=”warning”]

Zigi, transferencia bancaria y carteras de BINes requieren habilitación previa por parte del banco. Estos parámetros solo tienen efecto si tu comercio ya tiene esas opciones configuradas a nivel de administración. Para habilitarlas, contacta al banco en comercio@ebi.com.gt.

[/banner_icono_paybi]

Tabla de cuotas

[tabla_faqebi_manuales_1 encabezado_1=”CÓDIGO” encabezado_2=”DESCRIPCIÓN” filas=”%5B%7B%22titulo%22%3A%22VC00%22%2C%22descripcion%22%3A%22Contado%22%7D%2C%7B%22titulo%22%3A%22VC02%22%2C%22descripcion%22%3A%222%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC03%22%2C%22descripcion%22%3A%223%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC06%22%2C%22descripcion%22%3A%226%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC10%22%2C%22descripcion%22%3A%2210%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC12%22%2C%22descripcion%22%3A%2212%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC15%22%2C%22descripcion%22%3A%2215%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC18%22%2C%22descripcion%22%3A%2218%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC24%22%2C%22descripcion%22%3A%2224%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC36%22%2C%22descripcion%22%3A%2236%20cuotas%22%7D%2C%7B%22titulo%22%3A%22VC48%22%2C%22descripcion%22%3A%2248%20cuotas%22%7D%5D”][banner_icono_paybi]

Cómo habilitar varias opciones de cuotas en el mismo link. Cada solicitud al método link acepta un solo código en cuotas . Para ofrecer varias opciones (por ejemplo contado y 6 cuotas), envía solicitudes sucesivas al mismo codigo_interno , una por cada código que quieras sumar: primero cuotas=VC00 , luego una segunda solicitud al mismo codigo_interno con cuotas=VC06 . Como el método edita en vez de duplicar cuando el codigo_interno ya existe, esto va acumulando las opciones de cuotas disponibles para ese link sin crear uno nuevo. Aquí sí necesitas fijar codigo_interno a un valor conocido por ti (en vez de dejarlo vacío) para poder referenciar el mismo link en la segunda solicitud — sigue sin ser tu ID de pedido, es solo el identificador que permite referenciar el mismo link en ambas solicitudes.

[/banner_icono_paybi][bloque_codigo lenguaje=”php” codigo=”JTJGJTJGJTIwMXJhJTIwc29saWNpdHVkJTNBJTIwaGFiaWxpdGElMjBjb250YWRvJTBBJTI0Y2FtcG9zJTIwJTNEJTIwJTVCJTBBJTIwJTIwJTIwJTIwJTI3bGxhdmUlMjclMjAlM0QlM0UlMjAlMjRsbGF2ZSUyQyUwQSUyMCUyMCUyMCUyMCUyN3Rva2VuJTI3JTIwJTNEJTNFJTIwJTI0dG9rZW4lMkMlMEElMjAlMjAlMjAlMjAlMjdjb2RpZ29faW50ZXJubyUyNyUyMCUzRCUzRSUyMCUyN0xJTkstVkMwMC1WQzA2LTAwMSUyNyUyQyUyMCUyRiUyRiUyMHQlQzMlQkElMjBsbyUyMGRlZmluZXMlM0IlMjBtaXNtbyUyMHZhbG9yJTIwZW4lMjBhbWJhcyUyMHNvbGljaXR1ZGVzJTBBJTIwJTIwJTIwJTIwJTI3bm9tYnJlX2ludGVybm8lMjclMjAlM0QlM0UlMjAlMjdQRUQtJTI3JTIwLiUyMCUyNHBlZGlkby0lM0VpZCUyQyUyMCUyRiUyRiUyMGFxdSVDMyVBRCUyMHMlQzMlQUQlMjB2YSUyMHR1JTIwcmVmZXJlbmNpYSUyMHJlYWwlMjBkZSUyMG5lZ29jaW8lMEElMjAlMjAlMjAlMjAlMjd0aXR1bG8lMjclMjAlM0QlM0UlMjAlMjdQYWdvJTIwZGUlMjBwZWRpZG8lMjAlMjMlMjclMjAuJTIwJTI0cGVkaWRvLSUzRWlkJTJDJTBBJTIwJTIwJTIwJTIwJTI3bW9udG8lMjclMjAlM0QlM0UlMjA0NTAuMDAlMkMlMEElMjAlMjAlMjAlMjAlMjdjdW90YXMlMjclMjAlM0QlM0UlMjAlMjdWQzAwJTI3JTJDJTBBJTIwJTIwJTIwJTIwJTI3cmVkZXNfc29jaWFsZXMlMjclMjAlM0QlM0UlMjAlMjRjb2RpZ29SZWRBUEklMkMlMEElMjAlMjAlMjAlMjAlMjdlc3RhZG8lMjclMjAlM0QlM0UlMjAxJTJDJTBBJTVEJTNCJTBBY3JlYXJPRWRpdGFyTGluayUyOCUyNGNhbXBvcyUyOSUzQiUwQSUwQSUyRiUyRiUyMDJkYSUyMHNvbGljaXR1ZCUzQSUyMG1pc21vJTIwY29kaWdvX2ludGVybm8lMkMlMjBzb2xvJTIwY2FtYmlhJTIwJTIyY3VvdGFzJTIyJTIwJUUyJTgwJTk0JTIwc3VtYSUyMDYlMjBjdW90YXMlMjBhJTIwbGElMjBvZmVydGElMEElMjRjYW1wb3MlNUIlMjdjdW90YXMlMjclNUQlMjAlM0QlMjAlMjdWQzA2JTI3JTNCJTBBY3JlYXJPRWRpdGFyTGluayUyOCUyNGNhbXBvcyUyOSUzQiUwQSUwQSUyRiUyRiUyMEVsJTIwbGluayUyMHF1ZWRhJTIwY29uJTIwY29udGFkbyUyMHklMjA2JTIwY3VvdGFzJTIwZGlzcG9uaWJsZXMlMjBwYXJhJTIwZWwlMjBwYWdhZG9y”]

Facturación electrónica en este mismo link

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”CUÁNDO USARLO” filas=”%5B%7B%22titulo%22%3A%22nombre_producto%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Nombre%20del%20producto%20a%20facturar%22%2C%22columna_4%22%3A%22Producto%20%C3%BAnico%22%7D%2C%7B%22titulo%22%3A%22tipo_producto%22%2C%22tipo%22%3A%22char(1)%22%2C%22descripcion%22%3A%22char(1)%22%2C%22columna_3%22%3A%22B%20Bien%22%2C%22columna_4%22%3A%22Producto%20%C3%BAnico%22%7D%2C%7B%22titulo%22%3A%22tipo_factura%22%2C%22tipo%22%3A%22char(1)%22%2C%22descripcion%22%3A%22char(1)%22%2C%22columna_3%22%3A%22F%20Factura%22%2C%22columna_4%22%3A%22Producto%20%C3%BAnico%22%7D%2C%7B%22titulo%22%3A%22desglose_productos%22%2C%22tipo%22%3A%22JSON%20(text)%22%2C%22descripcion%22%3A%22JSON%20(text)%22%2C%22columna_3%22%3A%22Arreglo%20de%20productos%3A%20%5B%7B%5C%22name%5C%22%2C%5C%22code%5C%22%2C%5C%22quantity%5C%22%2C%5C%22price%5C%22%2C%5C%22total%5C%22%7D%2C%20…%5D%20.%20%5CnLa%20suma%20de%20total%20debe%20ser%20exactamente%20igual%20al%20monto%20del%20link%22%2C%22columna_4%22%3A%22Varios%20productos%22%7D%5D”][banner_icono_paybi]

En la práctica solo necesitas uno de los dos caminos. Si facturas un solo producto, basta con nombre_producto , tipo_producto = B y tipo_factura = F . Si facturas varios productos en el mismo link, omite esos tres campos y envía únicamente desglose_productos con el detalle — la suma de los total debe dar exactamente el monto del link. El resto de parámetros de facturación de la sección Factura Electrónica (comprador, destinatario, direcciones, etc.) solo aplican si tu comercio emite FEL con esos datos adicionales — para la mayoría de integraciones no son necesarios.

[/banner_icono_paybi]

Respuesta · data[]

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22nombre%22%2C%22contenido%22%3A%22Nombre%20de%20la%20red%20social%20asociada%20a%20esa%20URL.%22%7D%2C%7B%22etiqueta%22%3A%22url%22%2C%22contenido%22%3A%22URL%20final%20de%20pago%20para%20esa%20red.%20Esta%20es%20la%20URL%20a%20la%20que%20rediriges%20al%20comprador.%22%7D%5D”]

Ejemplo de respuesta real

[bloque_codigo codigo=”JTdCJTBBJTIwJTIwJTIwJTIwJTIycmVzdWx0JTIyJTNBJTIwJTIyc3VjY2VzcyUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMm1lc3NhZ2UlMjIlM0ElMjAlMjIlQzIlQTFDcmVhZG8lMjBjb3JyZWN0YW1lbnRlJTIxJTIyJTJDJTBBJTIwJTIwJTIwJTIwJTIyZGF0YSUyMiUzQSUyMCU1QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMm5vbWJyZSUyMiUzQSUyMCUyMkFQSSUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMnVybCUyMiUzQSUyMCUyMmh0dHBzJTNBJTJGJTJGbGluay5lYmkuY29tLmd0JTJGRUJMNzA4MTY0aWs0eDdkbjA5ZXElMkYxNzI5ODUxNTEwNzNiNjJiNSUyRjE2ODc4OTg0NjJhMjIxZWVmJTIyJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTVEJTBBJTdE”]

Ejemplo — link de monto fijo

[bloques_codigo][pestana_codigo lenguaje=”javascript” codigo=”YXN5bmMlMjBmdW5jdGlvbiUyMGNyZWFyTGlua0RlUGFnbyUyOHRva2VuJTJDJTIwcGVkaWRvJTJDJTIwY29kaWdvUmVkJTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjAlN0IlMjBkYXRhJTIwJTdEJTIwJTNEJTIwYXdhaXQlMjBheGlvcy5wb3N0JTI4JTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3aHR0cHMlM0ElMkYlMkZhZG1saW5rLmViaS5jb20uZ3QlMkZhcGklMkZsaW5rJTJGbWFpbnRlbmFuY2UlMjclMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBxcy5zdHJpbmdpZnklMjglN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBsbGF2ZSUzQSUyMExMQVZFJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdG9rZW4lMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb2RpZ29faW50ZXJubyUzQSUyMCUyNyUyNyUyQyUyMCUyRiUyRiUyMHZhYyVDMyVBRG8lMjAlM0QlMjBQYXklMjBCaSUyMGdlbmVyYSUyMGVsJTIwaWRlbnRpZmljYWRvciUyMGRlbCUyMGxpbmslMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBub21icmVfaW50ZXJubyUzQSUyMCU2MFBFRC0lMjQlN0JwZWRpZG8uaWQlN0QlNjAlMkMlMjAlMkYlMkYlMjB0dSUyMHByb3BpYSUyMHJlZmVyZW5jaWElMjBpbnRlcm5hJTIwJTI4bm8lMjBwJUMzJUJBYmxpY2ElMjklMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aXR1bG8lM0ElMjBwZWRpZG8uZGVzY3JpcGNpb24lMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBkZXNjcmlwY2lvbiUzQSUyMCU2MFBhZ28lMjBkZSUyMHBlZGlkbyUyMCUyMyUyNCU3QnBlZGlkby5pZCU3RCU2MCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMG1vbnRvJTNBJTIwcGVkaWRvLnRvdGFsJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY3VvdGFzJTNBJTIwJTI3VkMwMCUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlZGVzX3NvY2lhbGVzJTNBJTIwY29kaWdvUmVkJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZXN0YWRvJTNBJTIwMSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3QiUyMCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGhlYWRlcnMlM0ElMjAlN0IlMjAlMjdDb250ZW50LVR5cGUlMjclM0ElMjAlMjdhcHBsaWNhdGlvbiUyRngtd3d3LWZvcm0tdXJsZW5jb2RlZCUyNyUyMCU3RCUyMCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUwQSUyMCUyMCUyMCUyMCUyOSUzQiUwQSUwQSUyMCUyMCUyMCUyMGlmJTIwJTI4ZGF0YS5yZXN1bHQlMjAlM0QlM0QlM0QlMjAlMjdzdWNjZXNzJTI3JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcmV0dXJuJTIwZGF0YS5kYXRhJTVCMCU1RC51cmwlM0IlMjAlMkYlMkYlMjBVUkwlMjBkZSUyMHBhZ28lMjBhJTIwcmVkaXJpZ2lyJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTBBJTIwJTIwJTIwJTIwdGhyb3clMjBuZXclMjBFcnJvciUyOGRhdGEubWVzc2FnZSUyOSUzQiUwQSU3RA==”][pestana_codigo lenguaje=”php” codigo=”JTI0Y2glMjAlM0QlMjBjdXJsX2luaXQlMjglMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRmxpbmslMkZtYWludGVuYW5jZSUyNyUyOSUzQiUwQSUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1BPU1QlMkMlMjB0cnVlJTI5JTNCJTBBY3VybF9zZXRvcHQlMjglMjRjaCUyQyUyMENVUkxPUFRfUkVUVVJOVFJBTlNGRVIlMkMlMjB0cnVlJTI5JTNCJTBBY3VybF9zZXRvcHQlMjglMjRjaCUyQyUyMENVUkxPUFRfUE9TVEZJRUxEUyUyQyUyMCU1QiUwQSUyMCUyMCUyMCUyMCUyN2xsYXZlJTI3JTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTNEJTNFJTIwJTI0bGxhdmUlMkMlMEElMjAlMjAlMjAlMjAlMjd0b2tlbiUyNyUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUzRCUzRSUyMCUyNF9TRVNTSU9OJTVCJTI3cGF5YmlfdG9rZW4lMjclNUQlMkMlMEElMjAlMjAlMjAlMjAlMjdjb2RpZ29faW50ZXJubyUyNyUyMCUyMCUyMCUyMCUzRCUzRSUyMCUyNyUyNyUyQyUyMCUyRiUyRiUyMHZhYyVDMyVBRG8lMjAlM0QlMjBQYXklMjBCaSUyMGdlbmVyYSUyMGVsJTIwaWRlbnRpZmljYWRvciUyMGRlbCUyMGxpbmslMEElMjAlMjAlMjAlMjAlMjdub21icmVfaW50ZXJubyUyNyUyMCUyMCUyMCUyMCUzRCUzRSUyMCUyN1BFRC0lMjclMjAuJTIwJTI0cGVkaWRvLSUzRWlkJTJDJTIwJTJGJTJGJTIwdHUlMjBwcm9waWElMjByZWZlcmVuY2lhJTIwaW50ZXJuYSUyMCUyOG5vJTIwcCVDMyVCQWJsaWNhJTI5JTBBJTIwJTIwJTIwJTIwJTI3dGl0dWxvJTI3JTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTNEJTNFJTIwJTI0cGVkaWRvLSUzRWRlc2NyaXBjaW9uJTJDJTBBJTIwJTIwJTIwJTIwJTI3ZGVzY3JpcGNpb24lMjclMjAlMjAlMjAlMjAlMjAlMjAlMjAlM0QlM0UlMjAlMjdQYWdvJTIwZGUlMjBwZWRpZG8lMjAlMjMlMjclMjAuJTIwJTI0cGVkaWRvLSUzRWlkJTJDJTBBJTIwJTIwJTIwJTIwJTI3bW9udG8lMjclMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlM0QlM0UlMjAlMjRwZWRpZG8tJTNFdG90YWwlMkMlMjAlMkYlMkYlMjBlai4lMjA0NTAuMDAlMEElMjAlMjAlMjAlMjAlMjdjdW90YXMlMjclMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlM0QlM0UlMjAlMjdWQzAwJTI3JTJDJTIwJTJGJTJGJTIwdW4lMjBzb2xvJTIwYyVDMyVCM2RpZ28lMjBwb3IlMjBzb2xpY2l0dWQlM0IlMjB2ZXIlMjBub3RhJTIwYWJham8lMjBwYXJhJTIwdmFyaWFzJTIwY3VvdGFzJTBBJTIwJTIwJTIwJTIwJTI3cmVkZXNfc29jaWFsZXMlMjclMjAlMjAlMjAlMjAlM0QlM0UlMjAlMjRjb2RpZ29SZWRBUEklMkMlMjAlMkYlMkYlMjBjJUMzJUIzZGlnbyUyMGRlbCUyMGNhbmFsJTIwJTIyQVBJJTIyJTIwJUUyJTgwJTk0JTIwdmVyJTIwbSVDMyVBOXRvZG8lMjAlMjJyZWRlcyUyMHNvY2lhbGVzJTIyJTBBJTIwJTIwJTIwJTIwJTI3ZXN0YWRvJTI3JTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTNEJTNFJTIwMSUyQyUwQSU1RCUyOSUzQiUwQSUwQSUyNHJlc3AlMjAlM0QlMjBqc29uX2RlY29kZSUyOGN1cmxfZXhlYyUyOCUyNGNoJTI5JTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfY2xvc2UlMjglMjRjaCUyOSUzQiUwQSUwQWlmJTIwJTI4JTI0cmVzcCU1QiUyN3Jlc3VsdCUyNyU1RCUyMCUzRCUzRCUzRCUyMCUyN3N1Y2Nlc3MlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjR1cmxQYWdvJTIwJTNEJTIwJTI0cmVzcCU1QiUyN2RhdGElMjclNUQlNUIwJTVEJTVCJTI3dXJsJTI3JTVEJTNCJTBBJTIwJTIwJTIwJTIwJTJGJTJGJTIwUmVkaXJpZ2UlMjBhbCUyMGNvbXByYWRvciUzQSUyMGhlYWRlciUyOCUyMkxvY2F0aW9uJTNBJTIwJTI0dXJsUGFnbyUyMiUyOSUzQiUwQSU3RA==”][/bloques_codigo][banner_icono_paybi]

Usa nombre_interno = tu ID de orden, no codigo_interno . Esto te permite reconciliar pagos fácilmente: el campo link_name que regresa Pay Bi en la confirmación de pago corresponde exactamente a este valor. Si no se especifica codigo_interno , Pay Bi lo autogenera — es solo el identificador del link, no tu referencia de negocio.

[/banner_icono_paybi]

[texto_separadores_paybi separadores=”superior” etiqueta=”05 · OPCIONAL” titulo=”Link con Factura Electrónica” el_id=”linkconfacturaelectronica”]

Extiende el mismo método link con parámetros adicionales para que Pay Bi emita FEL automáticamente. Se combinan en la misma petición que la creación del link, no es un endpoint aparte.

[/texto_separadores_paybi][banner_icono_paybi variante=”warning”]

Requiere afiliación activa a Ainnova. Estos parámetros solo funcionan si tu comercio ya está afiliado a Ainnova para facturación electrónica. Si no lo está, el link se crea pero no emitirá FEL. Para habilitarlo, contacta al banco en comercio@ebi.com.gt.

[/banner_icono_paybi][banner_icono_paybi]

Hay dos caminos según cuántos productos factures — usa solo uno. Si el link factura un solo producto, usa nombre_producto + tipo_producto ( B ) + tipo_factura ( F ). Si factura varios productos, omite esos tres y envía solo desglose_productos — en ese caso, la suma de los total de cada producto debe ser exactamente igual al monto del link, o Pay Bi rechaza la factura. El resto de campos de esta sección (comprador, destinatario, direcciones) son para casos donde tu comercio necesita declarar esos datos explícitamente en la FEL — en la mayoría de integraciones no se usan.

[/banner_icono_paybi]

Caso 1 · Un solo producto

El caso más común: el link vende un único producto o servicio.

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22nombre_producto%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Nombre%20del%20producto%20para%20la%20factura%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22tipo_producto%22%2C%22tipo%22%3A%22char(1)%22%2C%22descripcion%22%3A%22char(1)%22%2C%22columna_3%22%3A%22B%20Bien%20%C2%B7%20S%20Servicio%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22tipo_factura%22%2C%22tipo%22%3A%22char(1)%22%2C%22descripcion%22%3A%22char(1)%22%2C%22columna_3%22%3A%22F%20Factura%20%C2%B7%20D%20Donaci%C3%B3n%20%C2%B7%20E%20Exportaci%C3%B3n%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]

Ejemplo — agregado a los campos del método link

[bloques_codigo][pestana_codigo lenguaje=”php” codigo=”JTJGJTJGJTIwLi4ubWlzbW9zJTIwY2FtcG9zJTIwZGVsJTIwbSVDMyVBOXRvZG8lMjBsaW5rJTJDJTIwbSVDMyVBMXMlM0ElMEElMjdub21icmVfcHJvZHVjdG8lMjclMjAlM0QlM0UlMjAlMjdDdXJzbyUyMGRlJTIwZm90b2dyYWYlQzMlQURhJTIwYiVDMyVBMXNpY2ElMjclMkMlMEElMjd0aXBvX3Byb2R1Y3RvJTI3JTIwJTIwJTIwJTNEJTNFJTIwJTI3QiUyNyUyQyUwQSUyN3RpcG9fZmFjdHVyYSUyNyUyMCUyMCUyMCUyMCUzRCUzRSUyMCUyN0YlMjclMkM=”][pestana_codigo lenguaje=”javascript” codigo=”JTJGJTJGJTIwLi4ubWlzbW9zJTIwY2FtcG9zJTIwZGVsJTIwbSVDMyVBOXRvZG8lMjBsaW5rJTJDJTIwbSVDMyVBMXMlM0ElMEFub21icmVfcHJvZHVjdG8lM0ElMjAlMjdDdXJzbyUyMGRlJTIwZm90b2dyYWYlQzMlQURhJTIwYiVDMyVBMXNpY2ElMjclMkMlMEF0aXBvX3Byb2R1Y3RvJTNBJTIwJTIwJTI3QiUyNyUyQyUwQXRpcG9fZmFjdHVyYSUzQSUyMCUyMCUyMCUyN0YlMjclMkM=”][/bloques_codigo]

Caso 2 · Varios productos en el mismo link

Para un carrito con varias líneas, envía únicamente desglose_productos — no combines con nombre_producto .

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22desglose_productos%22%2C%22tipo%22%3A%22JSON%20(text)%22%2C%22descripcion%22%3A%22JSON%20(text)%22%2C%22columna_3%22%3A%22Arreglo%20de%20objetos%3A%20name%20%2C%20code%20%2C%20quantity%20%2C%20price%20%2C%20total%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]
[banner_icono_paybi variante=”danger”]

La suma de los total de cada producto debe dar exactamente el monto del link. Si los totales del desglose no cuadran centavo a centavo con el monto cobrado, Pay Bi rechaza la factura electrónica. Calcula el desglose primero y usa esa misma suma como monto — nunca al revés.

[/banner_icono_paybi]

Ejemplo

[bloques_codigo][pestana_codigo lenguaje=”php” codigo=”JTI0cHJvZHVjdG9zJTIwJTNEJTIwJTVCJTBBJTIwJTIwJTIwJTIwJTVCJTI3bmFtZSUyNyUyMCUzRCUzRSUyMCUyN0NhbWlzYSUyMHRhbGxhJTIwTSUyNyUyQyUyMCUyN2NvZGUlMjclMjAlM0QlM0UlMjAlMjdDQU0tTSUyNyUyQyUyMCUyN3F1YW50aXR5JTI3JTIwJTNEJTNFJTIwMiUyQyUyMCUyN3ByaWNlJTI3JTIwJTNEJTNFJTIwMTUwLjAwJTJDJTIwJTI3dG90YWwlMjclMjAlM0QlM0UlMjAzMDAuMDAlNUQlMkMlMEElMjAlMjAlMjAlMjAlNUIlMjduYW1lJTI3JTIwJTNEJTNFJTIwJTI3R29ycmElMjclMkMlMjAlMjdjb2RlJTI3JTIwJTNEJTNFJTIwJTI3R09SLTAxJTI3JTJDJTIwJTI3cXVhbnRpdHklMjclMjAlM0QlM0UlMjAxJTJDJTIwJTI3cHJpY2UlMjclMjAlM0QlM0UlMjA4NS4wMCUyQyUyMCUyN3RvdGFsJTI3JTIwJTNEJTNFJTIwODUuMDAlNUQlMkMlMEElNUQlM0IlMEElMEElMkYlMkYlMjBFbCUyMG1vbnRvJTIwZGVsJTIwbGluayUyMERFQkUlMjBzZXIlMjBpZ3VhbCUyMGElMjBsYSUyMHN1bWElMjBkZSUyMGxvcyUyMCUyMnRvdGFsJTIyJTIwJUUyJTgwJTk0JTIwYXF1JUMzJUFEJTJDJTIwMzAwLjAwJTIwJTJCJTIwODUuMDAlMEElMjRtb250b0xpbmslMjAlM0QlMjBhcnJheV9zdW0lMjhhcnJheV9jb2x1bW4lMjglMjRwcm9kdWN0b3MlMkMlMjAlMjd0b3RhbCUyNyUyOSUyOSUzQiUyMCUyRiUyRiUyMDM4NS4wMCUwQSUwQSUyRiUyRiUyMC4uLm1pc21vcyUyMGNhbXBvcyUyMGRlbCUyMG0lQzMlQTl0b2RvJTIwbGluayUyQyUyMG0lQzMlQTFzJTNBJTBBJTI3bW9udG8lMjclMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlM0QlM0UlMjAlMjRtb250b0xpbmslMkMlMjAlMkYlMkYlMjAzODUuMDAlMjAlRTIlODAlOTQlMjBkZWJlJTIwY3VhZHJhciUyMGV4YWN0byUwQSUyN2Rlc2dsb3NlX3Byb2R1Y3RvcyUyNyUyMCUzRCUzRSUyMGpzb25fZW5jb2RlJTI4JTI0cHJvZHVjdG9zJTI5JTJD”][pestana_codigo lenguaje=”javascript” codigo=”Y29uc3QlMjBwcm9kdWN0b3MlMjAlM0QlMjAlNUIlMEElMjAlMjAlMjAlMjAlN0IlMjBuYW1lJTNBJTIwJTI3Q2FtaXNhJTIwdGFsbGElMjBNJTI3JTJDJTIwY29kZSUzQSUyMCUyN0NBTS1NJTI3JTJDJTIwcXVhbnRpdHklM0ElMjAyJTJDJTIwcHJpY2UlM0ElMjAxNTAuMDAlMkMlMjB0b3RhbCUzQSUyMDMwMC4wMCUyMCU3RCUyQyUwQSUyMCUyMCUyMCUyMCU3QiUyMG5hbWUlM0ElMjAlMjdHb3JyYSUyNyUyQyUyMGNvZGUlM0ElMjAlMjdHT1ItMDElMjclMkMlMjBxdWFudGl0eSUzQSUyMDElMkMlMjBwcmljZSUzQSUyMDg1LjAwJTJDJTIwdG90YWwlM0ElMjA4NS4wMCUyMCU3RCUyQyUwQSU1RCUzQiUwQSUwQSUyRiUyRiUyMEVsJTIwbW9udG8lMjBkZWwlMjBsaW5rJTIwREVCRSUyMHNlciUyMGlndWFsJTIwYSUyMGxhJTIwc3VtYSUyMGRlJTIwbG9zJTIwJTIydG90YWwlMjIlMjAlRTIlODAlOTQlMjBhcXUlQzMlQUQlMkMlMjAzMDAuMDAlMjAlMkIlMjA4NS4wMCUwQWNvbnN0JTIwbW9udG9MaW5rJTIwJTNEJTIwcHJvZHVjdG9zLnJlZHVjZSUyOCUyOHN1bWElMkMlMjBwJTI5JTIwJTNEJTNFJTIwc3VtYSUyMCUyQiUyMHAudG90YWwlMkMlMjAwJTI5JTNCJTIwJTJGJTJGJTIwMzg1LjAwJTBBJTBBJTJGJTJGJTIwLi4ubWlzbW9zJTIwY2FtcG9zJTIwZGVsJTIwbSVDMyVBOXRvZG8lMjBsaW5rJTJDJTIwbSVDMyVBMXMlM0ElMEFtb250byUzQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMG1vbnRvTGluayUyQyUyMCUyRiUyRiUyMDM4NS4wMCUyMCVFMiU4MCU5NCUyMGRlYmUlMjBjdWFkcmFyJTIwZXhhY3RvJTBBZGVzZ2xvc2VfcHJvZHVjdG9zJTNBJTIwSlNPTi5zdHJpbmdpZnklMjhwcm9kdWN0b3MlMjklMkM=”][/bloques_codigo]

Campos avanzados (opcionales, poco usados)

Solo si tu comercio necesita declarar comprador, destinatario o exportación explícitamente en la FEL. La mayoría de integraciones no envía estos campos.

[tabla_faqebi_manuales_1 cantidad_columnas=”3″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” filas=”%5B%7B%22titulo%22%3A%22comprador%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22Nombre%20del%20comprador%22%7D%2C%7B%22titulo%22%3A%22codigo_comprador%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22C%C3%B3digo%20del%20comprador%20(NIT%2FCUI)%22%7D%2C%7B%22titulo%22%3A%22direccion_comprador%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Direcci%C3%B3n%20del%20comprador%22%7D%2C%7B%22titulo%22%3A%22destinatario%22%2C%22tipo%22%3A%22varchar(100)%22%2C%22descripcion%22%3A%22varchar(100)%22%2C%22columna_3%22%3A%22Nombre%20del%20destinatario%22%7D%2C%7B%22titulo%22%3A%22codigo_destinatario%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22C%C3%B3digo%20del%20destinatario%22%7D%2C%7B%22titulo%22%3A%22direccion_destinatario%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Direcci%C3%B3n%20del%20destinatario%22%7D%2C%7B%22titulo%22%3A%22direccion_destinatario%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Direcci%C3%B3n%20del%20destinatario%22%7D%2C%7B%22titulo%22%3A%22otras_referencias%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Otras%20referencias%20de%20la%20factura%22%7D%2C%7B%22titulo%22%3A%22codigo_exportacion%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22C%C3%B3digo%20de%20exportaci%C3%B3n%20(factura%20tipo%20E%20)%22%7D%2C%7B%22titulo%22%3A%22codigo_incoterm%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Solo%20valores%20del%20m%C3%A9todo%20de%20incoterm%22%7D%2C%7B%22titulo%22%3A%22codigo_pais%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Solo%20valores%20del%20m%C3%A9todo%20de%20pa%C3%ADses%22%7D%5D”]

Respuesta · data[]

Misma respuesta que el método link: un arreglo de {nombre, url} por cada red social.

[banner_icono_paybi variante=”warning”]

No es una llamada separada. Cualquiera de los dos casos de arriba se combina con los campos normales del método link en un solo arreglo, enviado junto a /api/link/maintenance .

[/banner_icono_paybi]

[texto_separadores_paybi separadores=”superior” etiqueta=”06 · OPCIONAL” titulo=”Método Imagen” el_id=”metodoimagen”]

Sube o reemplaza la imagen de un link ya creado. La imagen viaja codificada en Base64, sin el prefijo data:image/…;base64, .

[/texto_separadores_paybi]

Actualizar imagen del link

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar(50)%22%2C%22descripcion%22%3A%22varchar(50)%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22token%22%2C%22tipo%22%3A%22varchar(50)%22%2C%22descripcion%22%3A%22varchar(50)%22%2C%22columna_3%22%3A%22Token%20del%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22codigo%22%2C%22tipo%22%3A%22varchar(50)%22%2C%22descripcion%22%3A%22varchar(50)%22%2C%22columna_3%22%3A%22codigo_interno%20del%20link%20a%20actualizar%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22imagen%22%2C%22tipo%22%3A%22text%22%2C%22descripcion%22%3A%22text%22%2C%22columna_3%22%3A%22Imagen%20en%20Base64%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22tipo%22%2C%22tipo%22%3A%22varchar(10)%22%2C%22descripcion%22%3A%22varchar(10)%22%2C%22columna_3%22%3A%22jpg%20o%20png%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]

Respuesta

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22result%22%2C%22contenido%22%3A%22Indicador%20de%20respuesta%3A%20%5C%22success%5C%22%20si%20fue%20v%C3%A1lida.%22%7D%2C%7B%22etiqueta%22%3A%22message%22%2C%22contenido%22%3A%22Detalle%20de%20la%20respuesta%20del%20m%C3%A9todo.%22%7D%2C%7B%22etiqueta%22%3A%22data%22%2C%22contenido%22%3A%22URL%20de%20la%20imagen%20ya%20subida%20al%20sistema.%22%7D%5D”]

Ejemplo

[bloques_codigo][pestana_codigo titulo=”Node.Js” lenguaje=”javascript” codigo=”aW1wb3J0JTIwZnMlMjBmcm9tJTIwJTI3ZnMlMjclM0IlMEElMEFhc3luYyUyMGZ1bmN0aW9uJTIwYWN0dWFsaXphckltYWdlbkxpbmslMjh0b2tlbiUyQyUyMGNvZGlnb0ludGVybm8lMkMlMjBydXRhSW1hZ2VuJTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjBiYXNlNjQlMjAlM0QlMjBmcy5yZWFkRmlsZVN5bmMlMjhydXRhSW1hZ2VuJTI5LnRvU3RyaW5nJTI4JTI3YmFzZTY0JTI3JTI5JTNCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjAlN0IlMjBkYXRhJTIwJTdEJTIwJTNEJTIwYXdhaXQlMjBheGlvcy5wb3N0JTI4JTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3aHR0cHMlM0ElMkYlMkZhZG1saW5rLmViaS5jb20uZ3QlMkZhcGklMkZsaW5rJTJGaW1hZ2UlMjclMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBxcy5zdHJpbmdpZnklMjglN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBsbGF2ZSUzQSUyMExMQVZFJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdG9rZW4lMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb2RpZ28lM0ElMjBjb2RpZ29JbnRlcm5vJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaW1hZ2VuJTNBJTIwYmFzZTY0JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdGlwbyUzQSUyMCUyN2pwZyUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3QiUyMGhlYWRlcnMlM0ElMjAlN0IlMjAlMjdDb250ZW50LVR5cGUlMjclM0ElMjAlMjdhcHBsaWNhdGlvbiUyRngtd3d3LWZvcm0tdXJsZW5jb2RlZCUyNyUyMCU3RCUyMCU3RCUwQSUyMCUyMCUyMCUyMCUyOSUzQiUwQSUyMCUyMCUyMCUyMHJldHVybiUyMGRhdGElM0IlMEElN0Q=”][pestana_codigo titulo=”PHP” lenguaje=”php” codigo=”JTI0cnV0YUltYWdlbiUyMCUzRCUyMCUyNyUyRnJ1dGElMkZhbCUyRnByb2R1Y3RvLmpwZyUyNyUzQiUwQSUyNGJhc2U2NCUyMCUzRCUyMGJhc2U2NF9lbmNvZGUlMjhmaWxlX2dldF9jb250ZW50cyUyOCUyNHJ1dGFJbWFnZW4lMjklMjklM0IlMEElMjRjaCUyMCUzRCUyMGN1cmxfaW5pdCUyOCUyN2h0dHBzJTNBJTJGJTJGYWRtbGluay5lYmkuY29tLmd0JTJGYXBpJTJGbGluayUyRmltYWdlJTI3JTI5JTNCJTBBY3VybF9zZXRvcHQlMjglMjRjaCUyQyUyMENVUkxPUFRfUE9TVCUyQyUyMHRydWUlMjklM0IlMEFjdXJsX3NldG9wdCUyOCUyNGNoJTJDJTIwQ1VSTE9QVF9SRVRVUk5UUkFOU0ZFUiUyQyUyMHRydWUlMjklM0IlMEFjdXJsX3NldG9wdCUyOCUyNGNoJTJDJTIwQ1VSTE9QVF9QT1NURklFTERTJTJDJTIwJTVCJTBBJTIwJTIwJTIwJTIwJTI3bGxhdmUlMjclMjAlM0QlM0UlMjAlMjRsbGF2ZSUyQyUwQSUyMCUyMCUyMCUyMCUyN3Rva2VuJTI3JTIwJTNEJTNFJTIwJTI0X1NFU1NJT04lNUIlMjdwYXliaV90b2tlbiUyNyU1RCUyQyUwQSUyMCUyMCUyMCUyMCUyN2NvZGlnbyUyNyUyMCUzRCUzRSUyMCUyNGNvZGlnb0ludGVybm9EZWxMaW5rJTJDJTIwJTJGJTJGJTIwY29kaWdvX2ludGVybm8lMjBkZWwlMjBsaW5rJTIwYWwlMjBxdWUlMjBzdWJpciUyMGxhJTIwaW1hZ2VuJTBBJTIwJTIwJTIwJTIwJTI3aW1hZ2VuJTI3JTIwJTNEJTNFJTIwJTI0YmFzZTY0JTJDJTBBJTIwJTIwJTIwJTIwJTI3dGlwbyUyNyUyMCUzRCUzRSUyMCUyN2pwZyUyNyUyQyUwQSU1RCUyOSUzQiUwQSUyNHJlc3AlMjAlM0QlMjBqc29uX2RlY29kZSUyOGN1cmxfZXhlYyUyOCUyNGNoJTI5JTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfY2xvc2UlMjglMjRjaCUyOSUzQg==”][/bloques_codigo]
[texto_separadores_paybi separadores=”superior” etiqueta=”07 · CONSULTA” titulo=”Método Mostrar Links” el_id=”metodomostrarlinks”]

Lista los links de pago generados por tu usuario (o por toda la empresa, si tu usuario es administrador). Sin parámetros de fecha, trae los más recientes con un máximo de 500 resultados.

[/texto_separadores_paybi]

Listar links de pago

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22token%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Token%20del%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22inicio%22%2C%22tipo%22%3A%22date%22%2C%22descripcion%22%3A%22date%22%2C%22columna_3%22%3A%22Formato%20YYYY-mm-dd%20o%20dd-mm-YYYY%22%2C%22columna_4%22%3A%22No%22%7D%2C%7B%22titulo%22%3A%22fin%22%2C%22tipo%22%3A%22date%22%2C%22descripcion%22%3A%22date%22%2C%22columna_3%22%3A%22Mismo%20formato%20que%20inicio%22%2C%22columna_4%22%3A%22No%22%7D%5D”]

Respuesta · data[]

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22codigo_interno%22%2C%22contenido%22%3A%22Identificador%20%C3%BAnico%20del%20link%20(no%20tu%20referencia%20interna%20%E2%80%94%20para%20eso%20usa%20nombre_interno%20).%22%7D%2C%7B%22etiqueta%22%3A%22titulo%20%2F%20descripcion%22%2C%22contenido%22%3A%22Datos%20del%20producto.%22%7D%2C%7B%22etiqueta%22%3A%22precio%22%2C%22contenido%22%3A%22Precio%20actual%20del%20link.%22%7D%2C%7B%22etiqueta%22%3A%22ventas%20%2F%20visita%22%2C%22contenido%22%3A%22Conteo%20de%20ventas%20y%20visitas%20al%20link.%22%7D%2C%7B%22etiqueta%22%3A%22estado%22%2C%22contenido%22%3A%22Activo%20o%20Bloqueado.%22%7D%2C%7B%22etiqueta%22%3A%22redes_sociales%5B%5D%22%2C%22contenido%22%3A%22Array%20de%20%7Bnombre%2C%20url%7D%20por%20cada%20canal%20publicado.%22%7D%5D”]

Ejemplo

[bloques_codigo][pestana_codigo titulo=”PHP” lenguaje=”php” codigo=”JTI0Y2glMjAlM0QlMjBjdXJsX2luaXQlMjglMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRmxpbmslMkZhbGwlMjclMjklM0IlMEFjdXJsX3NldG9wdCUyOCUyNGNoJTJDJTIwQ1VSTE9QVF9QT1NUJTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1JFVFVSTlRSQU5TRkVSJTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1BPU1RGSUVMRFMlMkMlMjAlNUIlMEElMjAlMjAlMjAlMjAlMjdsbGF2ZSUyNyUyMCUzRCUzRSUyMCUyNGxsYXZlJTJDJTBBJTIwJTIwJTIwJTIwJTI3dG9rZW4lMjclMjAlM0QlM0UlMjAlMjRfU0VTU0lPTiU1QiUyN3BheWJpX3Rva2VuJTI3JTVEJTJDJTBBJTIwJTIwJTIwJTIwJTI3aW5pY2lvJTI3JTIwJTNEJTNFJTIwJTI3MjAyNi0wNi0wMSUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyN2ZpbiUyNyUyMCUzRCUzRSUyMCUyNzIwMjYtMDYtMTklMjclMkMlMEElNUQlMjklM0IlMEElMjRsaW5rcyUyMCUzRCUyMGpzb25fZGVjb2RlJTI4Y3VybF9leGVjJTI4JTI0Y2glMjklMkMlMjB0cnVlJTI5JTNCJTBBY3VybF9jbG9zZSUyOCUyNGNoJTI5JTNC”][pestana_codigo titulo=”Node.Js” lenguaje=”javascript” codigo=”YXN5bmMlMjBmdW5jdGlvbiUyMGxpc3RhckxpbmtzJTI4dG9rZW4lMkMlMjBpbmljaW8lMkMlMjBmaW4lMjklMjAlN0IlMEElMjAlMjAlMjAlMjBjb25zdCUyMCU3QiUyMGRhdGElMjAlN0QlMjAlM0QlMjBhd2FpdCUyMGF4aW9zLnBvc3QlMjglMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRmxpbmslMkZhbGwlMjclMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBxcy5zdHJpbmdpZnklMjglN0IlMjBsbGF2ZSUzQSUyMExMQVZFJTJDJTIwdG9rZW4lMkMlMjBpbmljaW8lMkMlMjBmaW4lMjAlN0QlMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0IlMjBoZWFkZXJzJTNBJTIwJTdCJTIwJTI3Q29udGVudC1UeXBlJTI3JTNBJTIwJTI3YXBwbGljYXRpb24lMkZ4LXd3dy1mb3JtLXVybGVuY29kZWQlMjclMjAlN0QlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjklM0IlMEElMjAlMjAlMjAlMjByZXR1cm4lMjBkYXRhLmRhdGElM0IlMEElN0Q=”][/bloques_codigo]
[texto_separadores_paybi separadores=”superior” etiqueta=”08 · CONSULTA” titulo=”Método Buscar Link” el_id=”metodobuscarlink”]

Trae el detalle completo de un único link, incluyendo el desglose de pagos ( ventas ) realizados a través de él. Útil para reconciliación y soporte al cliente.

[/texto_separadores_paybi]

Buscar un link por código

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar(50)%22%2C%22descripcion%22%3A%22varchar(50)%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22token%22%2C%22tipo%22%3A%22varchar(50)%22%2C%22descripcion%22%3A%22varchar(50)%22%2C%22columna_3%22%3A%22Token%20del%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22codigo%22%2C%22tipo%22%3A%22varchar(50)%22%2C%22descripcion%22%3A%22varchar(50)%22%2C%22columna_3%22%3A%22codigo_interno%20(SKU)%20del%20link%20a%20consultar%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]

Respuesta · data.ventas[]

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22autorizacion%22%2C%22contenido%22%3A%22N%C3%BAmero%20de%20autorizaci%C3%B3n%20del%20pago.%22%7D%2C%7B%22etiqueta%22%3A%22referencia%22%2C%22contenido%22%3A%22N%C3%BAmero%20de%20referencia%20del%20pago.%22%7D%2C%7B%22etiqueta%22%3A%22monto%20%2F%20cuota%22%2C%22contenido%22%3A%22Valor%20pagado%20y%20forma%20de%20pago%20(contado%20o%20n%C3%BAmero%20de%20cuotas).%22%7D%2C%7B%22etiqueta%22%3A%22fecha_pago%22%2C%22contenido%22%3A%22Formato%20d-m-Y%20H%3Ai%20.%22%7D%2C%7B%22etiqueta%22%3A%22cliente%22%2C%22contenido%22%3A%22%7Bnombre%2C%20nit%2C%20correo%2C%20telefono%7D%20ingresados%20por%20el%20pagador.%22%7D%5D”]

Ejemplo

[bloques_codigo][pestana_codigo titulo=”PHP” lenguaje=”php” codigo=”JTI0Y2glMjAlM0QlMjBjdXJsX2luaXQlMjglMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRmxpbmslMkZzaW5nbGUlMjclMjklM0IlMEFjdXJsX3NldG9wdCUyOCUyNGNoJTJDJTIwQ1VSTE9QVF9QT1NUJTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1JFVFVSTlRSQU5TRkVSJTJDJTIwdHJ1ZSUyOSUzQiUwQWN1cmxfc2V0b3B0JTI4JTI0Y2glMkMlMjBDVVJMT1BUX1BPU1RGSUVMRFMlMkMlMjAlNUIlMEElMjdsbGF2ZSUyNyUyMCUzRCUzRSUyMCUyNGxsYXZlJTJDJTBBJTI3dG9rZW4lMjclMjAlM0QlM0UlMjAlMjRfU0VTU0lPTiU1QiUyN3BheWJpX3Rva2VuJTI3JTVEJTJDJTBBJTI3Y29kaWdvJTI3JTIwJTNEJTNFJTIwJTI0Y29kaWdvSW50ZXJub0RlbExpbmslMkMlMjAlMkYlMkYlMjBjb2RpZ29faW50ZXJubyUyMGRlbCUyMGxpbmslMjBhJTIwY29uc3VsdGFyJTBBJTVEJTI5JTNCJTBBJTI0ZGV0YWxsZSUyMCUzRCUyMGpzb25fZGVjb2RlJTI4Y3VybF9leGVjJTI4JTI0Y2glMjklMkMlMjB0cnVlJTI5JTNCJTBBY3VybF9jbG9zZSUyOCUyNGNoJTI5JTNC”][pestana_codigo titulo=”Node.Js” lenguaje=”javascript” codigo=”YXN5bmMlMjBmdW5jdGlvbiUyMGJ1c2NhckxpbmslMjh0b2tlbiUyQyUyMGNvZGlnb0ludGVybm8lMjklMjAlN0IlMEElMjAlMjAlMjAlMjBjb25zdCUyMCU3QiUyMGRhdGElMjAlN0QlMjAlM0QlMjBhd2FpdCUyMGF4aW9zLnBvc3QlMjglMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyRmxpbmslMkZzaW5nbGUlMjclMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBxcy5zdHJpbmdpZnklMjglN0IlMjBsbGF2ZSUzQSUyMExMQVZFJTJDJTIwdG9rZW4lMkMlMjBjb2RpZ28lM0ElMjBjb2RpZ29JbnRlcm5vJTIwJTdEJTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdCJTIwaGVhZGVycyUzQSUyMCU3QiUyMCUyN0NvbnRlbnQtVHlwZSUyNyUzQSUyMCUyN2FwcGxpY2F0aW9uJTJGeC13d3ctZm9ybS11cmxlbmNvZGVkJTI3JTIwJTdEJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTI5JTNCJTBBJTIwJTIwJTIwJTIwcmV0dXJuJTIwZGF0YS5kYXRhJTNCJTBBJTdE”][/bloques_codigo]
[texto_separadores_paybi separadores=”superior” etiqueta=”09 · CATÁLOGO” titulo=”Método Mostrar Carteras” el_id=”metodomostrarcarteras”]

Devuelve el listado de carteras configuradas en tu cuenta, usado en el parámetro opcional cartera / excluir_cartera del método link.

[/texto_separadores_paybi][banner_icono_paybi variante=”warning”]

Requiere habilitación previa por parte del banco. Este método solo funciona si tu comercio tiene carteras de BINes configuradas a nivel de administración. Si no las tienes habilitadas, contacta al banco en comercio@ebi.com.gt para solicitarlo.

[/banner_icono_paybi]

Parámetros de envío

[tabla_faqebi_manuales_1 cantidad_columnas=”4″ encabezado_1=”PARÁMETRO” encabezado_2=”TIPO” encabezado_3=”DESCRIPCIÓN” encabezado_4=”OBLIGATORIO” filas=”%5B%7B%22titulo%22%3A%22llave%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Llave%20p%C3%BAblica%20est%C3%A1tica%20de%20la%20plataforma%20Pay%20Bi%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%2C%7B%22titulo%22%3A%22token%22%2C%22tipo%22%3A%22varchar%22%2C%22descripcion%22%3A%22varchar%22%2C%22columna_3%22%3A%22Token%20del%20login%22%2C%22columna_4%22%3A%22S%C3%AD%22%7D%5D”]

Mismo patrón de petición que redes sociales: solo llave y token .

Respuesta · data[]

[texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22codigo%22%2C%22contenido%22%3A%22C%C3%B3digo%20de%20la%20cartera%2C%20a%20usar%20luego%20en%20cartera%20del%20m%C3%A9todo%20link.%22%7D%2C%7B%22etiqueta%22%3A%22nombre%22%2C%22contenido%22%3A%22Nombre%20legible%20de%20la%20cartera%20de%20BINes.%22%7D%5D”][banner_icono_paybi]

Cómo se usa junto con el método link. Toma el codigo de la cartera que te interesa y envíalo en cartera al crear el link. Con excluir_cartera = 0 el link solo acepta tarjetas cuyo BIN esté en esa cartera (lista blanca); con excluir_cartera = 1 el link acepta cualquier tarjeta excepto los BINes de esa cartera (lista negra).

[/banner_icono_paybi]

Errores comunes

[tabla_faqebi_manuales_1 encabezado_1=”CAUSA” encabezado_2=”MESSAGE” filas=”%5B%7B%22titulo%22%3A%22El%20m%C3%B3dulo%20de%20carteras%20no%20est%C3%A1%20habilitado%20para%20tu%20comercio%22%2C%22tipo%22%3A%22%5BEmpresa%5D%3A%20No%20cuenta%20con%20m%C3%B3dulo%20de%20cartera%20habilitado%22%2C%22descripcion%22%3A%22%5BEmpresa%5D%3A%20No%20cuenta%20con%20m%C3%B3dulo%20de%20cartera%20habilitado%22%7D%5D”][bloque_codigo codigo=”JTdCJTBBJTIwJTIwJTIwJTIwJTIycmVzdWx0JTIyJTNBJTIwJTIyZXJyb3IlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjJtZXNzYWdlJTIyJTNBJTIwJTIyJTVCRW1wcmVzYSU1RCUzQSUyME5vJTIwY3VlbnRhJTIwY29uJTIwbSVDMyVCM2R1bG8lMjBkZSUyMGNhcnRlcmElMjBoYWJpbGl0YWRvJTIyJTJDJTBBJTIwJTIwJTIwJTIwJTIyZGF0YSUyMiUzQSUyMCU1QiU1RCUwQSU3RA==”]

Si recibes este error, contacta al banco en comercio@ebi.com.gt para habilitar el módulo — no es algo que se resuelva desde el código.

[texto_separadores_paybi separadores=”superior” etiqueta=”10 · CONFIGURACIÓN UNA SOLA VEZ” titulo=”URLs de éxito o rechazo” el_id=”configuracionunasolavez”]

Esto no se configura por API: se hace una sola vez desde el panel administrativo de Link Bi. Ahí defines a qué endpoint de tu backend Pay Bi enviará el resultado de cada pago.

[/texto_separadores_paybi][guia_pasos_paybi pasos=”%5B%7B%22titulo%22%3A%22Ingresa%20al%20panel%20administrativo%22%2C%22descripcion%22%3A%22Entra%20a%20https%3A%2F%2Fadmlink.ebi.com.gt%20con%20tu%20usuario%20y%20contrase%C3%B1a%20de%20comercio%20(el%20mismo%20que%20usas%20en%20el%20m%C3%A9todo%20login).%22%7D%2C%7B%22titulo%22%3A%22Ve%20al%20men%C3%BA%20Pay%20Bi%20%E2%86%92%20Configuraci%C3%B3n%22%2C%22descripcion%22%3A%22En%20el%20men%C3%BA%20izquierdo%2C%20selecciona%20la%20opci%C3%B3n%20%5C%22Pay%20Bi%5C%22%20y%20luego%20%5C%22Configuraci%C3%B3n%5C%22.%22%7D%2C%7B%22titulo%22%3A%22Ingresa%20tus%20dos%20endpoints%22%2C%22descripcion%22%3A%22Define%20la%20URL%20de%20tu%20backend%20que%20recibir%C3%A1%20el%20pago%20exitoso%20y%20la%20que%20recibir%C3%A1%20el%20rechazado.%20Ambas%20reciben%20los%20mismos%20campos%20por%20POST%2C%20encriptados.%22%7D%2C%7B%22titulo%22%3A%22Guarda%20y%20valida%22%2C%22descripcion%22%3A%22Da%20clic%20en%20%5C%22Siguiente%5C%22%2C%20confirma%20las%20URLs%20ingresadas%20y%20luego%20%5C%22Guardar%5C%22.%20Pay%20Bi%20empezar%C3%A1%20a%20enviar%20las%20confirmaciones%20a%20esos%20endpoints%20de%20inmediato.%22%7D%5D”][banner_icono_paybi variante=”warning”]

Estos endpoints deben estar accesibles públicamente (no localhost ) y aceptar POST sin requerir sesión de usuario — Pay Bi los llama servidor a servidor. Verifica también que no estén detrás de un firewall/WAF que bloquee tráfico saliente de Banco Industrial.

[/banner_icono_paybi][banner_icono_paybi]

Solo aplica a links creados con el canal API o Botón de Pago . Como se explica en Redes sociales, esos son los únicos dos canales que redirigen al comprador tras el pago — el resto (WhatsApp, Email, Facebook, etc.) solo desactivan el link sin disparar esta redirección.

[/banner_icono_paybi]

[texto_separadores_paybi separadores=”superior” etiqueta=”11 · EL PASO QUE MÁS SE PASA POR ALTO” titulo=”Desencriptar la confirmación de pago” el_id=”desencriptarlaconfirmaciondepago”]

El POST que Pay Bi envía a tu URL de éxito/rechazo llega con los campos sensibles encriptados en AES-256-CBC. Necesitas dos llaves adicionales (distintas a la llave fija de la API) para leerlos.

[/texto_separadores_paybi]

[banner_imagen_pill_paybi pill=”IVC — IV de Comercio” descripcion=”Entra al panel de Link Bi → menú Pay Bi → Configuración. Ahí está en el campo “Token Único“.”]
[banner_imagen_pill_paybi pill=”CST — Clave de Seguridad de Transacción” descripcion=”No está en el panel. Se solicita por correo a comercio@ebi.com.gt indicando el nombre de tu comercio afiliado.”]

Payload que recibe tu endpoint (campos encriptados)

[bloque_codigo codigo=”dG9rZW4lMjAlM0QlM0UlMjAxNjIyNzY0MTQ2ZmZlZTc5NzclMjAlMkYlMkYlMjBubyUyMGVuY3JpcHRhZG8lM0ElMjBJRCUyMCVDMyVCQW5pY28lMjBkZSUyMHRyYW5zYWNjaSVDMyVCM24lMEFyZWZlcmVuY2UlMjAlM0QlM0UlMjBPNW9JV3JCYVFGbHZtOSUyQlNpaTBraEF2Y2Q3b3lrR2FsN0RzV3Bmc2tqR2slM0QlMEFhdWRpdCUyMCUzRCUzRSUyMEd0Y1M4ZTNJa2FOY1pSYzNVVjhUU3clM0QlM0QlMEFjb2RlJTIwJTNEJTNFJTIwMDAlMjAlMkYlMkYlMjBubyUyMGVuY3JpcHRhZG8lM0ElMjAlQzMlQTl4aXRvJTJGZmFsbG8lMjBpbnRlcm5vJTBBYW1vdW50JTIwJTNEJTNFJTIwVlg3N2lma2NUWHAlMkJCNEw3RTJIYVZ3JTNEJTNEJTBBYXV0aG9yaXphdGlvbiUyMCUzRCUzRSUyMHBzJTJCZFJYMHRmTEJXejdGamUxdkpGdyUzRCUzRCUwQWxpbmtfY29kZSUyMCUzRCUzRSUyME16RVhBQnQ5bUVUM3ZEajFLTDNmc3clM0QlM0QlMjAlMkYlMkYlMjAlM0QlMjBjb2RpZ29faW50ZXJubyUyMGRlbCUyMGxpbmslMjAlMjhubyUyMHR1JTIwSUQlMjBkZSUyMG9yZGVuJTI5JTBBbGlua19uYW1lJTIwJTNEJTNFJTIwNHRHOVF4TW1ScHJ5TmNEMnkzYlZYQVFsSjJsUVd2YVolMkZtNlZ5Q1YlMkJqTEQwUzZIY2lJU2s1aERwT25mS1lNNHIlMEFsaW5rX3Rva2VuJTIwJTNEJTNFJTIwWEk0eWt2YUxNOUtCcmRZOVppc1ZnMzBFQ28zY2VJWUlCUWpJNjBNbEsyayUzRA==”][texto_separadores_filas_paybi_v2 filas=”%5B%7B%22etiqueta%22%3A%22token%22%2C%22contenido%22%3A%22N%C3%BAmero%20%C3%BAnico%20por%20transacci%C3%B3n.%22%7D%2C%7B%22etiqueta%22%3A%22reference%22%2C%22contenido%22%3A%22N%C3%BAmero%20de%20referencia%20del%20pago.%22%7D%2C%7B%22etiqueta%22%3A%22audit%22%2C%22contenido%22%3A%22N%C3%BAmero%20de%20auditor%C3%ADa%22%7D%2C%7B%22etiqueta%22%3A%22code%22%2C%22contenido%22%3A%22C%C3%B3digo%20interno%3A%20identifica%20si%20la%20transacci%C3%B3n%20fue%20exitosa%20o%20no.%22%7D%2C%7B%22etiqueta%22%3A%22amount%22%2C%22contenido%22%3A%22Monto%20de%20la%20transacci%C3%B3n.%22%7D%2C%7B%22etiqueta%22%3A%22authorization%22%2C%22contenido%22%3A%22N%C3%BAmero%20de%20autorizaci%C3%B3n%20bancaria.%22%7D%2C%7B%22etiqueta%22%3A%22link_code%22%2C%22contenido%22%3A%22El%20codigo_interno%20del%20link%20%E2%80%94%20identificador%20del%20link%2C%20no%20tu%20referencia%20interna.%22%7D%2C%7B%22etiqueta%22%3A%22link_name%22%2C%22contenido%22%3A%22El%20nombre_interno%20que%20t%C3%BA%20asignaste%20%E2%80%94%20esta%20es%20tu%20llave%20de%20reconciliaci%C3%B3n%2C%20aqu%C3%AD%20est%C3%A1%20tu%20ID%20de%20pedido.%22%7D%2C%7B%22etiqueta%22%3A%22link_token%22%2C%22contenido%22%3A%22Identificador%20%C3%BAnico%20del%20link%20generado%20por%20la%20plataforma.%22%7D%5D”]

Desencriptar en tu backend

[bloques_codigo][pestana_codigo titulo=”PHP” lenguaje=”php” codigo=”JTNDJTNGcGhwJTBBJTJGJTJGJTIwRW5kcG9pbnQlMjBjb25maWd1cmFkbyUyMGNvbW8lMjBVUkwlMjBkZSUyMCVDMyVBOXhpdG8lMjAlMjhvJTIwcmVjaGF6byUyOSUyMGVuJTIwZWwlMjBwYW5lbCUyMGRlJTIwTGluayUyMEJpJTBBJTI0a2V5JTIwJTNEJTIwZ2V0ZW52JTI4JTI3UEFZQklfQ1NUJTI3JTI5JTNCJTIwJTJGJTJGJTIwQ2xhdmUlMjBkZSUyMFNlZ3VyaWRhZCUyMGRlJTIwVHJhbnNhY2NpJUMzJUIzbiUwQSUyNGl2JTIwJTNEJTIwYmFzZTY0X2RlY29kZSUyOGdldGVudiUyOCUyN1BBWUJJX0lWQyUyNyUyOSUyOSUzQiUyMCUyRiUyRiUyMElWJTIwZGUlMjBDb21lcmNpbyUwQSUyNG1ldGhvZCUyMCUzRCUyMCUyN2Flcy0yNTYtY2JjJTI3JTNCJTBBZnVuY3Rpb24lMjBkZXNjaWZyYXIlMjglMjR2YWxvciUyQyUyMCUyNG1ldGhvZCUyQyUyMCUyNGtleSUyQyUyMCUyNGl2JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwcmV0dXJuJTIwb3BlbnNzbF9kZWNyeXB0JTI4JTI0dmFsb3IlMkMlMjAlMjRtZXRob2QlMkMlMjAlMjRrZXklMkMlMjAwJTJDJTIwJTI0aXYlMjklM0IlMEElN0QlMEFpZiUyMCUyOCUyNF9TRVJWRVIlNUIlMjdSRVFVRVNUX01FVEhPRCUyNyU1RCUyMCUyMSUzRCUzRCUyMCUyN1BPU1QlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjBodHRwX3Jlc3BvbnNlX2NvZGUlMjg0MDUlMjklM0IlMEElMjAlMjAlMjAlMjBleGl0JTNCJTBBJTdEJTBBJTI0cGFnbyUyMCUzRCUyMCU1QiUwQSUyMCUyMCUyMCUyMCUyN3Rva2VuJTI3JTIwJTNEJTNFJTIwJTI0X1BPU1QlNUIlMjd0b2tlbiUyNyU1RCUyMCUzRiUzRiUyMG51bGwlMkMlMEElMjAlMjAlMjAlMjAlMjdjb2RpZ28lMjclMjAlM0QlM0UlMjBkZXNjaWZyYXIlMjglMjRfUE9TVCU1QiUyN2NvZGUlMjclNUQlMjAlM0YlM0YlMjAlMjclMjclMkMlMjAlMjRtZXRob2QlMkMlMjAlMjRrZXklMkMlMjAlMjRpdiUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyN21vbnRvJTI3JTIwJTNEJTNFJTIwZGVzY2lmcmFyJTI4JTI0X1BPU1QlNUIlMjdhbW91bnQlMjclNUQlMjAlM0YlM0YlMjAlMjclMjclMkMlMjAlMjRtZXRob2QlMkMlMjAlMjRrZXklMkMlMjAlMjRpdiUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyN2F1dG9yaXphY2lvbiUyNyUyMCUzRCUzRSUyMGRlc2NpZnJhciUyOCUyNF9QT1NUJTVCJTI3YXV0aG9yaXphdGlvbiUyNyU1RCUyMCUzRiUzRiUyMCUyNyUyNyUyQyUyMCUyNG1ldGhvZCUyQyUyMCUyNGtleSUyQyUyMCUyNGl2JTI5JTJDJTBBJTIwJTIwJTIwJTIwJTI3cmVmZXJlbmNpYSUyNyUyMCUzRCUzRSUyMGRlc2NpZnJhciUyOCUyNF9QT1NUJTVCJTI3cmVmZXJlbmNlJTI3JTVEJTIwJTNGJTNGJTIwJTI3JTI3JTJDJTIwJTI0bWV0aG9kJTJDJTIwJTI0a2V5JTJDJTIwJTI0aXYlMjklMkMlMEElMjAlMjAlMjAlMjAlMjdhdWRpdG9yaWElMjclMjAlM0QlM0UlMjBkZXNjaWZyYXIlMjglMjRfUE9TVCU1QiUyN2F1ZGl0JTI3JTVEJTIwJTNGJTNGJTIwJTI3JTI3JTJDJTIwJTI0bWV0aG9kJTJDJTIwJTI0a2V5JTJDJTIwJTI0aXYlMjklMkMlMEElMjAlMjAlMjAlMjAlMjdjb2RpZ29faW50ZXJubyUyNyUyMCUzRCUzRSUyMGRlc2NpZnJhciUyOCUyNF9QT1NUJTVCJTI3bGlua19jb2RlJTI3JTVEJTIwJTNGJTNGJTIwJTI3JTI3JTJDJTIwJTI0bWV0aG9kJTJDJTIwJTI0a2V5JTJDJTIwJTI0aXYlMjklMkMlMEElMjAlMjAlMjAlMjAlMjdub21icmVfaW50ZXJubyUyNyUyMCUzRCUzRSUyMGRlc2NpZnJhciUyOCUyNF9QT1NUJTVCJTI3bGlua19uYW1lJTI3JTVEJTIwJTNGJTNGJTIwJTI3JTI3JTJDJTIwJTI0bWV0aG9kJTJDJTIwJTI0a2V5JTJDJTIwJTI0aXYlMjklMkMlMEElNUQlM0IlMEElMkYlMkYlMjAlMjdub21icmVfaW50ZXJubyUyNyUyMGVzJTIwZWwlMjBJRCUyMGRlJTIwb3JkZW4lMjBxdWUlMjB0JUMzJUJBJTIwYXNpZ25hc3RlJTIwJUUyJTgwJTk0JTIwJUMzJUJBc2FsbyUyMHBhcmElMEElMkYlMkYlMjBsb2NhbGl6YXIlMjBlbCUyMHBlZGlkbyUyMHklMjBhY3R1YWxpemFyJTIwc3UlMjBlc3RhZG8lMjBlbiUyMHR1JTIwYmFzZSUyMGRlJTIwZGF0b3MuJTBBaWYlMjAlMjglMjRwYWdvJTVCJTI3Y29kaWdvJTI3JTVEJTIwJTNEJTNEJTNEJTIwJTI3MDAlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMkYlMkYlMjBtYXJjYXJQZWRpZG9Db21vUGFnYWRvJTI4JTI0cGFnbyU1QiUyN25vbWJyZV9pbnRlcm5vJTI3JTVEJTJDJTIwJTI0cGFnbyU1QiUyN2F1dG9yaXphY2lvbiUyNyU1RCUyOSUzQiUwQSU3RCUwQWh0dHBfcmVzcG9uc2VfY29kZSUyODIwMCUyOSUzQiUwQWVjaG8lMjAlMjdPSyUyNyUzQg==”][pestana_codigo titulo=”NODE.JS” lenguaje=”javascript” codigo=”aW1wb3J0JTIwY3J5cHRvJTIwZnJvbSUyMCUyN2NyeXB0byUyNyUzQiUwQWltcG9ydCUyMGV4cHJlc3MlMjBmcm9tJTIwJTI3ZXhwcmVzcyUyNyUzQiUwQSUwQWNvbnN0JTIwQ1NUJTIwJTNEJTIwcHJvY2Vzcy5lbnYuUEFZQklfQ1NUJTNCJTIwJTJGJTJGJTIwQ2xhdmUlMjBkZSUyMFNlZ3VyaWRhZCUyMGRlJTIwVHJhbnNhY2NpJUMzJUIzbiUwQWNvbnN0JTIwSVZDJTIwJTNEJTIwQnVmZmVyLmZyb20lMjhwcm9jZXNzLmVudi5QQVlCSV9JVkMlMkMlMjAlMjdiYXNlNjQlMjclMjklM0IlMjAlMkYlMkYlMjBJViUyMGRlJTIwQ29tZXJjaW8lMEElMEFmdW5jdGlvbiUyMGRlc2NpZnJhciUyOHZhbG9yQmFzZTY0JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjBkZWNpcGhlciUyMCUzRCUyMGNyeXB0by5jcmVhdGVEZWNpcGhlcml2JTI4JTI3YWVzLTI1Ni1jYmMlMjclMkMlMjBDU1QlMkMlMjBJVkMlMjklM0IlMEElMjAlMjAlMjAlMjByZXR1cm4lMjBCdWZmZXIuY29uY2F0JTI4JTVCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGVjaXBoZXIudXBkYXRlJTI4QnVmZmVyLmZyb20lMjh2YWxvckJhc2U2NCUyQyUyMCUyN2Jhc2U2NCUyNyUyOSUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGRlY2lwaGVyLmZpbmFsJTI4JTI5JTJDJTBBJTIwJTIwJTIwJTIwJTVEJTI5LnRvU3RyaW5nJTI4JTI3dXRmOCUyNyUyOSUzQiUwQSU3RCUwQSUwQWNvbnN0JTIwYXBwJTIwJTNEJTIwZXhwcmVzcyUyOCUyOSUzQiUwQWFwcC51c2UlMjhleHByZXNzLnVybGVuY29kZWQlMjglN0IlMjBleHRlbmRlZCUzQSUyMHRydWUlMjAlN0QlMjklMjklM0IlMEElMEFhcHAucG9zdCUyOCUyNyUyRndlYmhvb2tzJTJGcGF5YmklMkZleGl0byUyNyUyQyUyMCUyOHJlcSUyQyUyMHJlcyUyOSUyMCUzRCUzRSUyMCU3QiUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwYiUyMCUzRCUyMHJlcS5ib2R5JTNCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjBwYWdvJTIwJTNEJTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdG9rZW4lM0ElMjBiLnRva2VuJTJDJTIwJTJGJTJGJTIwbm8lMjBlbmNyaXB0YWRvJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29kaWdvJTNBJTIwZGVzY2lmcmFyJTI4Yi5jb2RlJTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwbW9udG8lM0ElMjBkZXNjaWZyYXIlMjhiLmFtb3VudCUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGF1dG9yaXphY2lvbiUzQSUyMGRlc2NpZnJhciUyOGIuYXV0aG9yaXphdGlvbiUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlZmVyZW5jaWElM0ElMjBkZXNjaWZyYXIlMjhiLnJlZmVyZW5jZSUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGF1ZGl0b3JpYSUzQSUyMGRlc2NpZnJhciUyOGIuYXVkaXQlMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb2RpZ29JbnRlcm5vJTNBJTIwZGVzY2lmcmFyJTI4Yi5saW5rX2NvZGUlMjklMkMlMjAlMkYlMkYlMjBpZGVudGlmaWNhZG9yJTIwZGVsJTIwbGluayUyQyUyMG5vJTIwdHUlMjBvcmRlbiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMG5vbWJyZUludGVybm8lM0ElMjBkZXNjaWZyYXIlMjhiLmxpbmtfbmFtZSUyOSUyQyUyMCUyRiUyRiUyMHR1JTIwSUQlMjBkZSUyMG9yZGVuJTBBJTIwJTIwJTIwJTIwJTdEJTNCJTBBJTBBJTIwJTIwJTIwJTIwaWYlMjAlMjhwYWdvLmNvZGlnbyUyMCUzRCUzRCUzRCUyMCUyNzAwJTI3JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTJGJTJGJTIwYXdhaXQlMjBtYXJjYXJQZWRpZG9Db21vUGFnYWRvJTI4cGFnby5ub21icmVJbnRlcm5vJTJDJTIwcGFnby5hdXRvcml6YWNpb24lMjklM0IlMEElMjAlMjAlMjAlMjAlN0QlMEElMEElMjAlMjAlMjAlMjByZXMuc2VuZFN0YXR1cyUyODIwMCUyOSUzQiUwQSU3RCUyOSUzQg==”][/bloques_codigo][banner_icono_paybi variante=”danger”]

Nunca confirmes un pedido como pagado solo por la redirección del navegador. El usuario puede cerrar la pestaña antes de volver, o manipular una URL de éxito si no validas server-side. La fuente de verdad es siempre este POST servidor-a-servidor desencriptado, idealmente cruzado contra Buscar Link para confirmar el monto.

[/banner_icono_paybi]

[texto_separadores_paybi separadores=”superior” etiqueta=”12 · IMPLEMENTACIÓN DE REFERENCIA” titulo=”Backend completo en PHP” el_id=”implementaciondereferencia”]

Un ejemplo mínimo pero realista: un cliente de Pay Bi con caché de token, un endpoint para iniciar el cobro de un pedido, y el webhook de confirmación. Pensado para colocarse en cualquier proyecto PHP existente (WordPress, Laravel, vanilla).

[/texto_separadores_paybi][bloque_codigo titulo=”PHP” lenguaje=”php” codigo=”JTNDJTNGcGhwJTBBY2xhc3MlMjBQYXlCaUNsaWVudCUyMCU3QiUwQSUyMCUyMCUyMCUyMHByaXZhdGUlMjAlMjRsbGF2ZSUzQiUwQSUyMCUyMCUyMCUyMHByaXZhdGUlMjAlMjR1c3VhcmlvJTNCJTBBJTIwJTIwJTIwJTIwcHJpdmF0ZSUyMCUyNGNsYXZlJTNCJTBBJTIwJTIwJTIwJTIwcHJpdmF0ZSUyMCUyNGJhc2VVcmwlMjAlM0QlMjAlMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyNyUzQiUwQSUwQSUyMCUyMCUyMCUyMHB1YmxpYyUyMGZ1bmN0aW9uJTIwX19jb25zdHJ1Y3QlMjglMjRsbGF2ZSUyQyUyMCUyNHVzdWFyaW8lMkMlMjAlMjRjbGF2ZSUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyNHRoaXMtJTNFbGxhdmUlMjAlM0QlMjAlMjRsbGF2ZSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyNHRoaXMtJTNFdXN1YXJpbyUyMCUzRCUyMCUyNHVzdWFyaW8lM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjR0aGlzLSUzRWNsYXZlJTIwJTNEJTIwJTI0Y2xhdmUlM0IlMEElMjAlMjAlMjAlMjAlN0QlMEElMEElMjAlMjAlMjAlMjBwcml2YXRlJTIwZnVuY3Rpb24lMjBwb3N0JTI4JTI0ZW5kcG9pbnQlMkMlMjAlMjRjYW1wb3MlMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjRjaCUyMCUzRCUyMGN1cmxfaW5pdCUyOCUyNHRoaXMtJTNFYmFzZVVybCUyMC4lMjAlMjRlbmRwb2ludCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGN1cmxfc2V0b3B0X2FycmF5JTI4JTI0Y2glMkMlMjAlNUIlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBDVVJMT1BUX1BPU1QlMjAlM0QlM0UlMjB0cnVlJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwQ1VSTE9QVF9SRVRVUk5UUkFOU0ZFUiUyMCUzRCUzRSUyMHRydWUlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBDVVJMT1BUX1BPU1RGSUVMRFMlMjAlM0QlM0UlMjAlMjRjYW1wb3MlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBDVVJMT1BUX1RJTUVPVVQlMjAlM0QlM0UlMjAxNSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU1RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyNHJhdyUyMCUzRCUyMGN1cmxfZXhlYyUyOCUyNGNoJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaWYlMjAlMjglMjRyYXclMjAlM0QlM0QlM0QlMjBmYWxzZSUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHRocm93JTIwbmV3JTIwRXhjZXB0aW9uJTI4JTI3UGF5JTIwQmklM0ElMjBlcnJvciUyMGRlJTIwcmVkJTIwJUUyJTgwJTk0JTIwJTI3JTIwLiUyMGN1cmxfZXJyb3IlMjglMjRjaCUyOSUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGN1cmxfY2xvc2UlMjglMjRjaCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMGpzb25fZGVjb2RlJTI4JTI0cmF3JTJDJTIwdHJ1ZSUyOSUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSUwQSUyMCUyMCUyMCUyMCUyRiUyRiUyMExvZ2luJTIwY29uJTIwY2FjaCVDMyVBOSUyMHNpbXBsZSUyMGVuJTIwYXJjaGl2by4lMjBFbiUyMHByb2R1Y2NpJUMzJUIzbiUyMHVzYSUyMFJlZGlzJTJGTWVtY2FjaGVkLiUwQSUyMCUyMCUyMCUyMHB1YmxpYyUyMGZ1bmN0aW9uJTIwZ2V0VG9rZW4lMjglMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjRjYWNoZUZpbGUlMjAlM0QlMjBzeXNfZ2V0X3RlbXBfZGlyJTI4JTI5JTIwLiUyMCUyNyUyRnBheWJpX3Rva2VuLmpzb24lMjclM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBpZiUyMCUyOGZpbGVfZXhpc3RzJTI4JTI0Y2FjaGVGaWxlJTI5JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI0Y2FjaGUlMjAlM0QlMjBqc29uX2RlY29kZSUyOGZpbGVfZ2V0X2NvbnRlbnRzJTI4JTI0Y2FjaGVGaWxlJTI5JTJDJTIwdHJ1ZSUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGlmJTIwJTI4JTI0Y2FjaGUlMjAlMjYlMjYlMjAlMjRjYWNoZSU1QiUyN2V4cGlyYSUyNyU1RCUyMCUzRSUyMHRpbWUlMjglMjklMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjAlMjRjYWNoZSU1QiUyN3Rva2VuJTI3JTVEJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI0cmVzcCUyMCUzRCUyMCUyNHRoaXMtJTNFcG9zdCUyOCUyNyUyRmxvZ2luJTI3JTJDJTIwJTVCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3bGxhdmUlMjclMjAlM0QlM0UlMjAlMjR0aGlzLSUzRWxsYXZlJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3dXN1YXJpbyUyNyUyMCUzRCUzRSUyMCUyNHRoaXMtJTNFdXN1YXJpbyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyN2NsYXZlJTI3JTIwJTNEJTNFJTIwJTI0dGhpcy0lM0VjbGF2ZSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU1RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGlmJTIwJTI4JTI0cmVzcCU1QiUyN3Jlc3VsdCUyNyU1RCUyMCUyMSUzRCUzRCUyMCUyN3N1Y2Nlc3MlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aHJvdyUyMG5ldyUyMEV4Y2VwdGlvbiUyOCUyN1BheSUyMEJpJTIwbG9naW4lMjBmYWxsJUMzJUIzJTNBJTIwJTI3JTIwLiUyMCUyNHJlc3AlNUIlMjdtZXNzYWdlJTI3JTVEJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI0dG9rZW4lMjAlM0QlMjAlMjRyZXNwJTVCJTI3ZGF0YSUyNyU1RCU1QiUyN3Rva2VuJTI3JTVEJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZmlsZV9wdXRfY29udGVudHMlMjglMjRjYWNoZUZpbGUlMkMlMjBqc29uX2VuY29kZSUyOCU1QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyN3Rva2VuJTI3JTIwJTNEJTNFJTIwJTI0dG9rZW4lMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdleHBpcmElMjclMjAlM0QlM0UlMjB0aW1lJTI4JTI5JTIwJTJCJTIwMTUwMCUyQyUyMCUyRiUyRiUyMG1hcmdlbiUyMGRlJTIwc2VndXJpZGFkJTIwYW50ZSUyMGV4cGlyYWNpJUMzJUIzbiUyMHJlYWwlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlNUQlMjklMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjAlMjR0b2tlbiUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSUwQSUyMCUyMCUyMCUyMHB1YmxpYyUyMGZ1bmN0aW9uJTIwbGlzdGFyUmVkZXNTb2NpYWxlcyUyOCUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyNHJlc3AlMjAlM0QlMjAlMjR0aGlzLSUzRXBvc3QlMjglMjclMkZuZXR3b3JrJTJGYWxsJTI3JTJDJTIwJTVCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3bGxhdmUlMjclMjAlM0QlM0UlMjAlMjR0aGlzLSUzRWxsYXZlJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3dG9rZW4lMjclMjAlM0QlM0UlMjAlMjR0aGlzLSUzRWdldFRva2VuJTI4JTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTVEJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcmV0dXJuJTIwJTI0cmVzcCU1QiUyN2RhdGElMjclNUQlMjAlM0YlM0YlMjAlNUIlNUQlM0IlMEElMjAlMjAlMjAlMjAlN0QlMEElMEElMjAlMjAlMjAlMjBwdWJsaWMlMjBmdW5jdGlvbiUyMGNyZWFyTGlua0RlUGFnbyUyOCUyNG9yZGVuSWQlMkMlMjAlMjR0aXR1bG8lMkMlMjAlMjRtb250byUyQyUyMCUyNGNvZGlnb1JlZCUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyNHJlc3AlMjAlM0QlMjAlMjR0aGlzLSUzRXBvc3QlMjglMjclMkZsaW5rJTJGbWFpbnRlbmFuY2UlMjclMkMlMjAlNUIlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdsbGF2ZSUyNyUyMCUzRCUzRSUyMCUyNHRoaXMtJTNFbGxhdmUlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjd0b2tlbiUyNyUyMCUzRCUzRSUyMCUyNHRoaXMtJTNFZ2V0VG9rZW4lMjglMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdjb2RpZ29faW50ZXJubyUyNyUyMCUzRCUzRSUyMCUyNyUyNyUyQyUyMCUyRiUyRiUyMHZhYyVDMyVBRG8lMjAlM0QlMjBQYXklMjBCaSUyMGdlbmVyYSUyMGVsJTIwaWRlbnRpZmljYWRvciUyMGRlbCUyMGxpbmslMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdub21icmVfaW50ZXJubyUyNyUyMCUzRCUzRSUyMCUyNG9yZGVuSWQlMkMlMjAlMkYlMkYlMjB0dSUyMHJlZmVyZW5jaWElMjByZWFsJTIwZGUlMjBuZWdvY2lvJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3dGl0dWxvJTI3JTIwJTNEJTNFJTIwJTI0dGl0dWxvJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI3bW9udG8lMjclMjAlM0QlM0UlMjAlMjRtb250byUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyN2N1b3RhcyUyNyUyMCUzRCUzRSUyMCUyN1ZDMDAlMjclMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjdyZWRlc19zb2NpYWxlcyUyNyUyMCUzRCUzRSUyMCUyNGNvZGlnb1JlZCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyN2VzdGFkbyUyNyUyMCUzRCUzRSUyMDElMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlNUQlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBpZiUyMCUyOCUyNHJlc3AlNUIlMjdyZXN1bHQlMjclNUQlMjAlMjElM0QlM0QlMjAlMjdzdWNjZXNzJTI3JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdGhyb3clMjBuZXclMjBFeGNlcHRpb24lMjglMjdQYXklMjBCaSUzQSUyMG5vJTIwc2UlMjBwdWRvJTIwY3JlYXIlMjBlbCUyMGxpbmslMjAlRTIlODAlOTQlMjAlMjclMjAuJTIwJTI0cmVzcCU1QiUyN21lc3NhZ2UlMjclNUQlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjAlMjRyZXNwJTVCJTI3ZGF0YSUyNyU1RCU1QjAlNUQlNUIlMjd1cmwlMjclNUQlM0IlMEElMjAlMjAlMjAlMjAlN0QlMEElN0Q=”]

Uso: iniciar el cobro de un pedido

[bloque_codigo titulo=”PHP” lenguaje=”php” codigo=”JTNDJTNGcGhwJTBBcmVxdWlyZSUyMCUyN1BheUJpQ2xpZW50LnBocCUyNyUzQiUwQSUyNHBheWJpJTIwJTNEJTIwbmV3JTIwUGF5QmlDbGllbnQlMjglMEElMjAlMjAlMjAlMjBnZXRlbnYlMjglMjdQQVlCSV9MTEFWRSUyNyUyOSUyQyUwQSUyMCUyMCUyMCUyMGdldGVudiUyOCUyN1BBWUJJX1VTRVIlMjclMjklMkMlMEElMjAlMjAlMjAlMjBnZXRlbnYlMjglMjdQQVlCSV9QQVNTJTI3JTI5JTBBJTI5JTNCJTBBJTI0cGVkaWRvJTIwJTNEJTIwb2J0ZW5lclBlZGlkbyUyOCUyNF9HRVQlNUIlMjdwZWRpZG9faWQlMjclNUQlMjklM0IlMjAlMkYlMkYlMjB0dSUyMHByb3BpYSUyMGwlQzMlQjNnaWNhJTIwZGUlMjBuZWdvY2lvJTBBJTJGJTJGJTIwQ2FjaGVhJTIwZWwlMjBjJUMzJUIzZGlnbyUyMGRlbCUyMGNhbmFsJTIwJTIyQVBJJTIyJTIwJUUyJTgwJTk0JTIwZXMlMjBlbCUyMHF1ZSUyMHJlZGlyaWdlJTIwYSUyMHR1JTIwVVJMJTIwZGUlMjAlQzMlQTl4aXRvJTJGcmVjaGF6byUwQSUyNHJlZGVzJTIwJTNEJTIwJTI0cGF5YmktJTNFbGlzdGFyUmVkZXNTb2NpYWxlcyUyOCUyOSUzQiUwQSUyNGNvZGlnb1JlZCUyMCUzRCUyMGFycmF5X2NvbHVtbiUyOCUyNHJlZGVzJTJDJTIwJTI3Y29kaWdvJTI3JTJDJTIwJTI3bm9tYnJlJTI3JTI5JTVCJTI3QVBJJTI3JTVEJTIwJTNGJTNGJTIwJTI0cmVkZXMlNUIwJTVEJTVCJTI3Y29kaWdvJTI3JTVEJTNCJTBBdHJ5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTI0dXJsUGFnbyUyMCUzRCUyMCUyNHBheWJpLSUzRWNyZWFyTGlua0RlUGFnbyUyOCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyN1BFRC0lMjclMjAuJTIwJTI0cGVkaWRvJTVCJTI3aWQlMjclNUQlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjRwZWRpZG8lNUIlMjdkZXNjcmlwY2lvbiUyNyU1RCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyNHBlZGlkbyU1QiUyN3RvdGFsJTI3JTVEJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI0Y29kaWdvUmVkJTBBJTIwJTIwJTIwJTIwJTI5JTNCJTBBJTIwJTIwJTIwJTIwaGVhZGVyJTI4JTIyTG9jYXRpb24lM0ElMjAlMjR1cmxQYWdvJTIyJTI5JTNCJTBBJTIwJTIwJTIwJTIwZXhpdCUzQiUwQSU3RCUyMGNhdGNoJTIwJTI4RXhjZXB0aW9uJTIwJTI0ZSUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMGh0dHBfcmVzcG9uc2VfY29kZSUyODUwMiUyOSUzQiUwQSUyMCUyMCUyMCUyMGVjaG8lMjAlMjdObyUyMHNlJTIwcHVkbyUyMGluaWNpYXIlMjBlbCUyMHBhZ28uJTIwSW50ZW50YSUyMG51ZXZhbWVudGUuJTI3JTNCJTBBJTIwJTIwJTIwJTIwZXJyb3JfbG9nJTI4JTI0ZS0lM0VnZXRNZXNzYWdlJTI4JTI5JTI5JTNCJTBBJTdE”]
[texto_separadores_paybi separadores=”superior” etiqueta=”13 · IMPLEMENTACIÓN DE REFERENCIA” titulo=”Backend completo en Node.js” el_id=”BackendcompletoenNodejs”]

El mismo cliente, en Express. Ideal si tu plataforma de e-commerce ya corre en Node o si prefieres aislar la integración de pagos como microservicio.

[/texto_separadores_paybi][bloque_codigo codigo=”aW1wb3J0JTIwYXhpb3MlMjBmcm9tJTIwJTI3YXhpb3MlMjclM0IlMEFpbXBvcnQlMjBxcyUyMGZyb20lMjAlMjdxcyUyNyUzQiUwQSUwQWNvbnN0JTIwQkFTRV9VUkwlMjAlM0QlMjAlMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyNyUzQiUwQWNvbnN0JTIwRk9STV9IRUFERVJTJTIwJTNEJTIwJTdCJTIwaGVhZGVycyUzQSUyMCU3QiUyMCUyN0NvbnRlbnQtVHlwZSUyNyUzQSUyMCUyN2FwcGxpY2F0aW9uJTJGeC13d3ctZm9ybS11cmxlbmNvZGVkJTI3JTIwJTdEJTIwJTdEJTNCJTBBJTBBY2xhc3MlMjBQYXlCaUNsaWVudCUyMCU3QiUwQSUyMCUyMCUyMCUyMGNvbnN0cnVjdG9yJTI4JTdCJTIwbGxhdmUlMkMlMjB1c3VhcmlvJTJDJTIwY2xhdmUlMjAlN0QlMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aGlzLmxsYXZlJTIwJTNEJTIwbGxhdmUlM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aGlzLnVzdWFyaW8lMjAlM0QlMjB1c3VhcmlvJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdGhpcy5jbGF2ZSUyMCUzRCUyMGNsYXZlJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdGhpcy5fdG9rZW4lMjAlM0QlMjBudWxsJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdGhpcy5fZXhwaXJhJTIwJTNEJTIwMCUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSUwQSUyMCUyMCUyMCUyMGFzeW5jJTIwZ2V0VG9rZW4lMjglMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBpZiUyMCUyOHRoaXMuX3Rva2VuJTIwJTI2JTI2JTIwdGhpcy5fZXhwaXJhJTIwJTNFJTIwRGF0ZS5ub3clMjglMjklMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjB0aGlzLl90b2tlbiUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwJTdCJTIwZGF0YSUyMCU3RCUyMCUzRCUyMGF3YWl0JTIwYXhpb3MucG9zdCUyOCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU2MCUyNCU3QkJBU0VfVVJMJTdEJTJGbG9naW4lNjAlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBxcy5zdHJpbmdpZnklMjglN0IlMjBsbGF2ZSUzQSUyMHRoaXMubGxhdmUlMkMlMjB1c3VhcmlvJTNBJTIwdGhpcy51c3VhcmlvJTJDJTIwY2xhdmUlM0ElMjB0aGlzLmNsYXZlJTIwJTdEJTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwRk9STV9IRUFERVJTJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaWYlMjAlMjhkYXRhLnJlc3VsdCUyMCUyMSUzRCUzRCUyMCUyN3N1Y2Nlc3MlMjclMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aHJvdyUyMG5ldyUyMEVycm9yJTI4JTYwUGF5JTIwQmklMjBsb2dpbiUyMGZhbGwlQzMlQjMlM0ElMjAlMjQlN0JkYXRhLm1lc3NhZ2UlN0QlNjAlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aGlzLl90b2tlbiUyMCUzRCUyMGRhdGEuZGF0YS50b2tlbiUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHRoaXMuX2V4cGlyYSUyMCUzRCUyMERhdGUubm93JTI4JTI5JTIwJTJCJTIwMjUlMjAlMkElMjA2MCUyMCUyQSUyMDEwMDAlM0IlMjAlMkYlMkYlMjBtYXJnZW4lMjBkZSUyMHNlZ3VyaWRhZCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMHRoaXMuX3Rva2VuJTNCJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTBBJTIwJTIwJTIwJTIwYXN5bmMlMjBsaXN0YXJSZWRlc1NvY2lhbGVzJTI4JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjB0b2tlbiUyMCUzRCUyMGF3YWl0JTIwdGhpcy5nZXRUb2tlbiUyOCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwJTdCJTIwZGF0YSUyMCU3RCUyMCUzRCUyMGF3YWl0JTIwYXhpb3MucG9zdCUyOCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU2MCUyNCU3QkJBU0VfVVJMJTdEJTJGbmV0d29yayUyRmFsbCU2MCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHFzLnN0cmluZ2lmeSUyOCU3QiUyMGxsYXZlJTNBJTIwdGhpcy5sbGF2ZSUyQyUyMHRva2VuJTIwJTdEJTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwRk9STV9IRUFERVJTJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcmV0dXJuJTIwZGF0YS5kYXRhJTIwJTNGJTNGJTIwJTVCJTVEJTNCJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTBBJTIwJTIwJTIwJTIwYXN5bmMlMjBjcmVhckxpbmtEZVBhZ28lMjglN0IlMjBvcmRlbklkJTJDJTIwdGl0dWxvJTJDJTIwbW9udG8lMkMlMjBjb2RpZ29SZWQlMjAlN0QlMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMHRva2VuJTIwJTNEJTIwYXdhaXQlMjB0aGlzLmdldFRva2VuJTI4JTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjAlN0IlMjBkYXRhJTIwJTdEJTIwJTNEJTIwYXdhaXQlMjBheGlvcy5wb3N0JTI4JTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTYwJTI0JTdCQkFTRV9VUkwlN0QlMkZsaW5rJTJGbWFpbnRlbmFuY2UlNjAlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBxcy5zdHJpbmdpZnklMjglN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBsbGF2ZSUzQSUyMHRoaXMubGxhdmUlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0b2tlbiUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvZGlnb19pbnRlcm5vJTNBJTIwJTI3JTI3JTJDJTIwJTJGJTJGJTIwdmFjJUMzJUFEbyUyMCUzRCUyMFBheSUyMEJpJTIwZ2VuZXJhJTIwZWwlMjBpZGVudGlmaWNhZG9yJTIwZGVsJTIwbGluayUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMG5vbWJyZV9pbnRlcm5vJTNBJTIwb3JkZW5JZCUyQyUyMCUyRiUyRiUyMHR1JTIwcmVmZXJlbmNpYSUyMHJlYWwlMjBkZSUyMG5lZ29jaW8lMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0aXR1bG8lMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBtb250byUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGN1b3RhcyUzQSUyMCUyN1ZDMDAlMjclMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZWRlc19zb2NpYWxlcyUzQSUyMGNvZGlnb1JlZCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGVzdGFkbyUzQSUyMDElMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBGT1JNX0hFQURFUlMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBpZiUyMCUyOGRhdGEucmVzdWx0JTIwJTIxJTNEJTNEJTIwJTI3c3VjY2VzcyUyNyUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHRocm93JTIwbmV3JTIwRXJyb3IlMjglNjBQYXklMjBCaSUzQSUyMG5vJTIwc2UlMjBwdWRvJTIwY3JlYXIlMjBlbCUyMGxpbmslMjAlRTIlODAlOTQlMjAlMjQlN0JkYXRhLm1lc3NhZ2UlN0QlNjAlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjBkYXRhLmRhdGElNUIwJTVELnVybCUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSU3RCUwQSUwQWV4cG9ydCUyMGRlZmF1bHQlMjBQYXlCaUNsaWVudCUzQg==”]

Uso en una ruta Express

[bloque_codigo codigo=”aW1wb3J0JTIwJTdCJTIwUm91dGVyJTIwJTdEJTIwZnJvbSUyMCUyN2V4cHJlc3MlMjclM0IlMEFpbXBvcnQlMjBQYXlCaUNsaWVudCUyMGZyb20lMjAlMjcuLiUyRnBheWJpQ2xpZW50LmpzJTI3JTNCJTBBaW1wb3J0JTIwJTdCJTIwb2J0ZW5lclBlZGlkbyUyMCU3RCUyMGZyb20lMjAlMjcuLiUyRnNlcnZpY2VzJTJGcGVkaWRvcy5qcyUyNyUzQiUwQSUwQWNvbnN0JTIwcm91dGVyJTIwJTNEJTIwUm91dGVyJTI4JTI5JTNCJTBBY29uc3QlMjBwYXliaSUyMCUzRCUyMG5ldyUyMFBheUJpQ2xpZW50JTI4JTdCJTBBJTIwJTIwJTIwJTIwbGxhdmUlM0ElMjBwcm9jZXNzLmVudi5QQVlCSV9MTEFWRSUyQyUwQSUyMCUyMCUyMCUyMHVzdWFyaW8lM0ElMjBwcm9jZXNzLmVudi5QQVlCSV9VU0VSJTJDJTBBJTIwJTIwJTIwJTIwY2xhdmUlM0ElMjBwcm9jZXNzLmVudi5QQVlCSV9QQVNTJTJDJTBBJTdEJTI5JTNCJTBBJTBBcm91dGVyLmdldCUyOCUyNyUyRmNoZWNrb3V0JTJGJTNBcGVkaWRvSWQlMjclMkMlMjBhc3luYyUyMCUyOHJlcSUyQyUyMHJlcyUyOSUyMCUzRCUzRSUyMCU3QiUwQSUyMCUyMCUyMCUyMHRyeSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwcGVkaWRvJTIwJTNEJTIwYXdhaXQlMjBvYnRlbmVyUGVkaWRvJTI4cmVxLnBhcmFtcy5wZWRpZG9JZCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwcmVkZXMlMjAlM0QlMjBhd2FpdCUyMHBheWJpLmxpc3RhclJlZGVzU29jaWFsZXMlMjglMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMkYlMkYlMjAlMjJBUEklMjIlMjBlcyUyMGVsJTIwY2FuYWwlMjBxdWUlMjByZWRpcmlnZSUyMGElMjB0dSUyMFVSTCUyMGRlJTIwJUMzJUE5eGl0byUyRnJlY2hhem8lMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMGNvZGlnb1JlZCUyMCUzRCUyMCUyOHJlZGVzLmZpbmQlMjhyJTIwJTNEJTNFJTIwci5ub21icmUlMjAlM0QlM0QlM0QlMjAlMjdBUEklMjclMjklMjAlM0YlM0YlMjByZWRlcyU1QjAlNUQlMjkuY29kaWdvJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjB1cmxQYWdvJTIwJTNEJTIwYXdhaXQlMjBwYXliaS5jcmVhckxpbmtEZVBhZ28lMjglN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBvcmRlbklkJTNBJTIwJTYwUEVELSUyNCU3QnBlZGlkby5pZCU3RCU2MCUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHRpdHVsbyUzQSUyMHBlZGlkby5kZXNjcmlwY2lvbiUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMG1vbnRvJTNBJTIwcGVkaWRvLnRvdGFsJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29kaWdvUmVkJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcmVzLnJlZGlyZWN0JTI4dXJsUGFnbyUyOSUzQiUwQSUyMCUyMCUyMCUyMCU3RCUyMGNhdGNoJTIwJTI4ZXJyJTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc29sZS5lcnJvciUyOGVyciUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlcy5zdGF0dXMlMjg1MDIlMjkuc2VuZCUyOCUyN05vJTIwc2UlMjBwdWRvJTIwaW5pY2lhciUyMGVsJTIwcGFnby4lMjBJbnRlbnRhJTIwbnVldmFtZW50ZS4lMjclMjklM0IlMEElMjAlMjAlMjAlMjAlN0QlMEElN0QlMjklM0IlMEElMEFleHBvcnQlMjBkZWZhdWx0JTIwcm91dGVyJTNC”]
[texto_separadores_paybi separadores=”superior” etiqueta=”15 · IMPLEMENTACIÓN DE REFERENCIA” titulo=”Caso de estudio: integración completa” el_id=”Casodeestudiointegracioncompleta”]

Una integración real, en producción: un sitio de donaciones con frontend en React + Vite y backend en Express. Cubre el flujo completo de extremo a extremo — botón de pago, creación de link, recepción y desencriptación de la confirmación, y un recibo en PDF descargable. El código está adaptado para quitar credenciales y nombres específicos del proyecto original, pero la lógica es exactamente la que corre en producción.

[/texto_separadores_paybi][cards_pasos_paybi pasos=”%5B%7B%22pill%22%3A%22FRONTEND%22%2C%22titulo%22%3A%22Modal%20de%20monto%22%2C%22descripcion%22%3A%22El%20usuario%20elige%20o%20escribe%20un%20monto.%20El%20frontend%20llama%20a%20%2Fapi%2Fcreate-payment%20en%20tu%20propio%20backend.%22%7D%2C%7B%22pill%22%3A%22BACKEND%22%2C%22titulo%22%3A%22Login%20%2B%20link%22%2C%22descripcion%22%3A%22El%20servidor%20autentica%20con%20Pay%20Bi%2C%20obtiene%20el%20canal%20API%20y%20crea%20el%20link.%20Devuelve%20solo%20la%20URL%20al%20frontend.%22%7D%2C%7B%22pill%22%3A%22NAVEGADOR%22%2C%22titulo%22%3A%22Redirecci%C3%B3n%22%2C%22descripcion%22%3A%22window.location.href%20%3D%20url%20%E2%80%94%20el%20navegador%20del%20usuario%20va%20directo%20a%20Pay%20Bi.%22%7D%2C%7B%22pill%22%3A%22BACKEND%22%2C%22titulo%22%3A%22Webhook%20%2B%20desencriptar%22%2C%22descripcion%22%3A%22Pay%20Bi%20llama%20a%20%2Fpayment-result%20.%20El%20backend%20desencripta%20y%20redirige%20al%20frontend%20con%20los%20datos%20en%20la%20URL.%22%7D%2C%7B%22pill%22%3A%22FRONTEND%22%2C%22titulo%22%3A%22P%C3%A1gina%20de%20gracias%22%2C%22descripcion%22%3A%22Lee%20los%20par%C3%A1metros%20de%20la%20URL%2C%20los%20muestra%2C%20y%20ofrece%20descargar%20un%20recibo%20en%20PDF%20generado%20por%20el%20backend.%22%7D%5D”]

Estructura del proyecto

[bloque_codigo codigo=”cHJveWVjdG8lMkYlMEElRTIlOTQlOUMlRTIlOTQlODAlRTIlOTQlODAlMjBiYWNrZW5kJTJGJTBBJUUyJTk0JTgyJTIwJTIwJTIwJUUyJTk0JTlDJUUyJTk0JTgwJUUyJTk0JTgwJTIwLmVudiUyMCUyMyUyMFBBWUJJX0xMQVZFJTJDJTIwUEFZQklfVVNFUiUyQyUyMFBBWUJJX1BBU1NXT1JEJTJDJTIwUEFZQklfSVYlMkMlMjBQQVlCSV9DU1QlMEElRTIlOTQlODIlMjAlMjAlMjAlRTIlOTQlOUMlRTIlOTQlODAlRTIlOTQlODAlMjBwYWNrYWdlLmpzb24lMEElRTIlOTQlODIlMjAlMjAlMjAlRTIlOTQlOTQlRTIlOTQlODAlRTIlOTQlODAlMjBzZXJ2ZXIuanMlMjAlMjMlMjB0b2RhJTIwbGElMjBsJUMzJUIzZ2ljYSUyMGRlJTIwUGF5JTIwQmklMjB2aXZlJTIwYXF1JUMzJUFEJTBBJUUyJTk0JTk0JUUyJTk0JTgwJUUyJTk0JTgwJTIwZnJvbnRlbmQlMkYlMEElMjAlMjAlMjAlMjAlRTIlOTQlOUMlRTIlOTQlODAlRTIlOTQlODAlMjBwYWNrYWdlLmpzb24lMEElMjAlMjAlMjAlMjAlRTIlOTQlOTQlRTIlOTQlODAlRTIlOTQlODAlMjBzcmMlMkYlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlRTIlOTQlOUMlRTIlOTQlODAlRTIlOTQlODAlMjBBcHAuanN4JTIwJTIzJTIwcnV0YXMlM0ElMjAlMjIlMkYlMjIlMjB5JTIwJTIyJTJGdGhhbmsteW91JTIyJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJUUyJTk0JTlDJUUyJTk0JTgwJUUyJTk0JTgwJTIwcGFnZXMlMkYlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlRTIlOTQlODIlMjAlMjAlMjAlRTIlOTQlOUMlRTIlOTQlODAlRTIlOTQlODAlMjBIb21lUGFnZS5qc3glMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlRTIlOTQlODIlMjAlMjAlMjAlRTIlOTQlOTQlRTIlOTQlODAlRTIlOTQlODAlMjBUaGFua1lvdVBhZ2UuanN4JTIwJTIzJTIwbGVlJTIwbGElMjBjb25maXJtYWNpJUMzJUIzbiUyMGRlc2RlJTIwbGElMjBVUkwlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlRTIlOTQlOUMlRTIlOTQlODAlRTIlOTQlODAlMjBjb21wb25lbnRzJTJGJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJUUyJTk0JTgyJTIwJTIwJTIwJUUyJTk0JTlDJUUyJTk0JTgwJUUyJTk0JTgwJTIwRG9uYXRpb25Nb2RhbC5qc3glMjAlMjMlMjBzZWxlY3RvciUyMGRlJTIwbW9udG8lMjAlMkIlMjBsbGFtYWRhJTIwYWwlMjBiYWNrZW5kJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJUUyJTk0JTgyJTIwJTIwJTIwJUUyJTk0JTk0JUUyJTk0JTgwJUUyJTk0JTgwJTIwRXJyb3JNb2RhbC5qc3glMjAlMjMlMjBwYWdvJTIwcmVjaGF6YWRvJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJUUyJTk0JTk0JUUyJTk0JTgwJUUyJTk0JTgwJTIwc2VydmljZXMlMkYlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlRTIlOTQlOTQlRTIlOTQlODAlRTIlOTQlODAlMjBhcGkuanMlMjAlMjMlMjBjbGllbnRlJTIwYXhpb3MlMjBoYWNpYSUyMFRVJTIwYmFja2VuZCUyQyUyMG51bmNhJTIwaGFjaWElMjBQYXklMjBCaQ==”]

Backend · dependencias usadas en producción

Más allá de axios , este proyecto usa helmet (cabeceras de seguridad), express-rate-limit (límite de peticiones por IP) y express-validator (validación del monto recibido) — una base razonable para un endpoint que mueve dinero.

[bloque_codigo codigo=”JTdCJTBBJTIwJTIwJTIwJTIwJTIyZGVwZW5kZW5jaWVzJTIyJTNBJTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIyYXhpb3MlMjIlM0ElMjAlMjIlNUUxLjEzLjIlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjJjb3JzJTIyJTNBJTIwJTIyJTVFMi44LjUlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjJkb3RlbnYlMjIlM0ElMjAlMjIlNUUxNy4yLjMlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjJleHByZXNzJTIyJTNBJTIwJTIyJTVFNS4xLjAlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjJleHByZXNzLXJhdGUtbGltaXQlMjIlM0ElMjAlMjIlNUU4LjIuMSUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMmV4cHJlc3MtdmFsaWRhdG9yJTIyJTNBJTIwJTIyJTVFNy4zLjElMjIlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjJmb3JtLWRhdGElMjIlM0ElMjAlMjIlNUU0LjAuNSUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMmhlbG1ldCUyMiUzQSUyMCUyMiU1RTguMS4wJTIyJTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIycGRma2l0JTIyJTNBJTIwJTIyJTVFMC4xNy4yJTIyJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTdE”]

Backend · servidor completo

Login, catálogo de redes, creación de link con FormData real (en vez de form-urlencoded), validación del monto, desencriptación de la confirmación y generación de un recibo en PDF — todo en un único archivo, tal como corre en producción.

[bloque_codigo codigo=”Y29uc3QlMjBleHByZXNzJTIwJTNEJTIwcmVxdWlyZSUyOCUyN2V4cHJlc3MlMjclMjklM0IlMEFjb25zdCUyMGF4aW9zJTIwJTNEJTIwcmVxdWlyZSUyOCUyN2F4aW9zJTI3JTI5JTNCJTBBY29uc3QlMjBjb3JzJTIwJTNEJTIwcmVxdWlyZSUyOCUyN2NvcnMlMjclMjklM0IlMEFjb25zdCUyMEZvcm1EYXRhJTIwJTNEJTIwcmVxdWlyZSUyOCUyN2Zvcm0tZGF0YSUyNyUyOSUzQiUwQWNvbnN0JTIwY3J5cHRvJTIwJTNEJTIwcmVxdWlyZSUyOCUyN2NyeXB0byUyNyUyOSUzQiUwQWNvbnN0JTIwaGVsbWV0JTIwJTNEJTIwcmVxdWlyZSUyOCUyN2hlbG1ldCUyNyUyOSUzQiUwQWNvbnN0JTIwcmF0ZUxpbWl0JTIwJTNEJTIwcmVxdWlyZSUyOCUyN2V4cHJlc3MtcmF0ZS1saW1pdCUyNyUyOSUzQiUwQWNvbnN0JTIwJTdCJTIwYm9keSUyQyUyMHZhbGlkYXRpb25SZXN1bHQlMjAlN0QlMjAlM0QlMjByZXF1aXJlJTI4JTI3ZXhwcmVzcy12YWxpZGF0b3IlMjclMjklM0IlMEFyZXF1aXJlJTI4JTI3ZG90ZW52JTI3JTI5LmNvbmZpZyUyOCUyOSUzQiUwQSUwQWNvbnN0JTIwYXBwJTIwJTNEJTIwZXhwcmVzcyUyOCUyOSUzQiUwQSUwQSUyRiUyRiUyMENhYmVjZXJhcyUyMGRlJTIwc2VndXJpZGFkJTIwJTJCJTIwbCVDMyVBRG1pdGUlMjBkZSUyMHBldGljaW9uZXMlMjBwb3IlMjBJUCUwQWFwcC51c2UlMjhoZWxtZXQlMjglMjklMjklM0IlMEFhcHAudXNlJTI4cmF0ZUxpbWl0JTI4JTdCJTIwd2luZG93TXMlM0ElMjAxNSUyMCUyQSUyMDYwJTIwJTJBJTIwMTAwMCUyQyUyMG1heCUzQSUyMDEwMCUyMCU3RCUyOSUyOSUzQiUwQSUwQWNvbnN0JTIwRlJPTlRFTkRfVVJMJTIwJTNEJTIwcHJvY2Vzcy5lbnYuRlJPTlRFTkRfVVJMJTIwJTdDJTdDJTIwJTI3aHR0cCUzQSUyRiUyRmxvY2FsaG9zdCUzQTUxNzMlMjclM0IlMEFhcHAudXNlJTI4Y29ycyUyOCU3QiUyMG9yaWdpbiUzQSUyMEZST05URU5EX1VSTCUyQyUyMGNyZWRlbnRpYWxzJTNBJTIwdHJ1ZSUyMCU3RCUyOSUyOSUzQiUwQWFwcC51c2UlMjhleHByZXNzLmpzb24lMjglMjklMjklM0IlMEFhcHAudXNlJTI4ZXhwcmVzcy51cmxlbmNvZGVkJTI4JTdCJTIwZXh0ZW5kZWQlM0ElMjB0cnVlJTIwJTdEJTI5JTI5JTNCJTIwJTJGJTJGJTIwcGFyYSUyMGxlZXIlMjBlbCUyMFBPU1QlMjBxdWUlMjBlbnYlQzMlQURhJTIwUGF5JTIwQmklMEElMEFjb25zdCUyMFBBWUJJX0FQSV9VUkwlMjAlM0QlMjAlMjdodHRwcyUzQSUyRiUyRmFkbWxpbmsuZWJpLmNvbS5ndCUyRmFwaSUyNyUzQiUwQWNvbnN0JTIwJTdCJTIwUEFZQklfTExBVkUlMkMlMjBQQVlCSV9VU0VSJTJDJTIwUEFZQklfUEFTU1dPUkQlMkMlMjBQQVlCSV9JViUyQyUyMFBBWUJJX0NTVCUyMCU3RCUyMCUzRCUyMHByb2Nlc3MuZW52JTNCJTBBJTBBJTJGJTJGJTIwR2VuZXJhZG9yJTIwc2ltcGxlJTIwZGUlMjB1biUyMElEJTIwc2VjdWVuY2lhbCUyMHBhcmElMjBub21icmVfaW50ZXJubyUwQWxldCUyMGxpbmtDb3VudGVyJTIwJTNEJTIwMSUzQiUwQWZ1bmN0aW9uJTIwZ2V0TmV4dExpbmtJZCUyOCUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMHJldHVybiUyMCU2MFBFRCUyNCU3QlN0cmluZyUyOGxpbmtDb3VudGVyJTJCJTJCJTI5LnBhZFN0YXJ0JTI4NiUyQyUyMCUyNzAlMjclMjklN0QlNjAlM0IlMEElN0QlMEElMEFmdW5jdGlvbiUyMGdldEZvcm1EYXRhQ29uZmlnJTI4Zm9ybURhdGElMjklMjAlN0IlMEElMjAlMjAlMjAlMjByZXR1cm4lMjAlN0IlMjBoZWFkZXJzJTNBJTIwJTdCJTIwLi4uZm9ybURhdGEuZ2V0SGVhZGVycyUyOCUyOSUyMCU3RCUyMCU3RCUzQiUwQSU3RCUwQSUwQSUyRiUyRiUyMERlc2VuY3JpcHRhJTIwdW4lMjBjYW1wbyUyMGRlJTIwbGElMjBjb25maXJtYWNpJUMzJUIzbiUyMGRlJTIwcGFnbyUyMCUyOEFFUy0yNTYtQ0JDJTI5JTBBZnVuY3Rpb24lMjBkZWNyeXB0UGF5QmlEYXRhJTI4ZW5jcnlwdGVkRGF0YSUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMHRyeSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGlmJTIwJTI4JTIxZW5jcnlwdGVkRGF0YSUyOSUyMHJldHVybiUyMG51bGwlM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMGl2JTIwJTNEJTIwQnVmZmVyLmZyb20lMjhQQVlCSV9JViUyQyUyMCUyN2Jhc2U2NCUyNyUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyRiUyRiUyMExhJTIwQ1NUJTIwc2UlMjB1c2ElMjBjb21vJTIwYnVmZmVyJTIwVVRGLTglMkMlMjBhanVzdGFkYSUyMGElMjBleGFjdGFtZW50ZSUyMDMyJTIwYnl0ZXMlMjAlMjhBRVMtMjU2JTI5JTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwbGV0JTIwa2V5QnVmZmVyJTIwJTNEJTIwQnVmZmVyLmZyb20lMjhQQVlCSV9DU1QlMkMlMjAlMjd1dGY4JTI3JTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaWYlMjAlMjhrZXlCdWZmZXIubGVuZ3RoJTIwJTNDJTIwMzIlMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMHBhZGRlZCUyMCUzRCUyMEJ1ZmZlci5hbGxvYyUyODMyJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwa2V5QnVmZmVyLmNvcHklMjhwYWRkZWQlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBrZXlCdWZmZXIlMjAlM0QlMjBwYWRkZWQlM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMjBlbHNlJTIwaWYlMjAlMjhrZXlCdWZmZXIubGVuZ3RoJTIwJTNFJTIwMzIlMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBrZXlCdWZmZXIlMjAlM0QlMjBrZXlCdWZmZXIuc2xpY2UlMjgwJTJDJTIwMzIlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMGRlY2lwaGVyJTIwJTNEJTIwY3J5cHRvLmNyZWF0ZURlY2lwaGVyaXYlMjglMjdhZXMtMjU2LWNiYyUyNyUyQyUyMGtleUJ1ZmZlciUyQyUyMGl2JTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGVjaXBoZXIuc2V0QXV0b1BhZGRpbmclMjh0cnVlJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwbGV0JTIwZGVjcnlwdGVkJTIwJTNEJTIwZGVjaXBoZXIudXBkYXRlJTI4ZW5jcnlwdGVkRGF0YSUyQyUyMCUyN2Jhc2U2NCUyNyUyQyUyMCUyN3V0ZjglMjclMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBkZWNyeXB0ZWQlMjAlMkIlM0QlMjBkZWNpcGhlci5maW5hbCUyOCUyN3V0ZjglMjclMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjBkZWNyeXB0ZWQlM0IlMEElMjAlMjAlMjAlMjAlN0QlMjBjYXRjaCUyMCUyOGVycm9yJTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc29sZS5lcnJvciUyOCUyN0RlY3J5cHRpb24lMjBlcnJvciUzQSUyNyUyQyUyMGVycm9yLm1lc3NhZ2UlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXR1cm4lMjBudWxsJTNCJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTdEJTBBJTBBJTJGJTJGJTIwMS4lMjBMb2dpbiUwQWFzeW5jJTIwZnVuY3Rpb24lMjBnZXRQYXlCaVRva2VuJTI4JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjBkYXRhJTIwJTNEJTIwbmV3JTIwRm9ybURhdGElMjglMjklM0IlMEElMjAlMjAlMjAlMjBkYXRhLmFwcGVuZCUyOCUyN2xsYXZlJTI3JTJDJTIwUEFZQklfTExBVkUlMjklM0IlMEElMjAlMjAlMjAlMjBkYXRhLmFwcGVuZCUyOCUyN3VzdWFyaW8lMjclMkMlMjBQQVlCSV9VU0VSJTI5JTNCJTBBJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjdjbGF2ZSUyNyUyQyUyMFBBWUJJX1BBU1NXT1JEJTI5JTNCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjByZXNwb25zZSUyMCUzRCUyMGF3YWl0JTIwYXhpb3MucG9zdCUyOCU2MCUyNCU3QlBBWUJJX0FQSV9VUkwlN0QlMkZsb2dpbiU2MCUyQyUyMGRhdGElMkMlMjBnZXRGb3JtRGF0YUNvbmZpZyUyOGRhdGElMjklMjklM0IlMEElMjAlMjAlMjAlMjBpZiUyMCUyOHJlc3BvbnNlLmRhdGEucmVzdWx0JTIwJTNEJTNEJTNEJTIwJTI3c3VjY2VzcyUyNyUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMHJlc3BvbnNlLmRhdGEuZGF0YS50b2tlbiUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSUyMCUyMCUyMCUyMHRocm93JTIwbmV3JTIwRXJyb3IlMjhyZXNwb25zZS5kYXRhLm1lc3NhZ2UlMjAlN0MlN0MlMjAlMjdMb2dpbiUyMGZhaWxlZCUyNyUyOSUzQiUwQSU3RCUwQSUwQSUyRiUyRiUyMDIuJTIwQ2FuYWwlMjBkZSUyMHJlZGVzJTIwc29jaWFsZXMlMjAlRTIlODAlOTQlMjB1c2ElMjAlMjJBUEklMjIlMjBwYXJhJTIwaW50ZWdyYWNpJUMzJUIzbiUyMHBvciUyMGJhY2tlbmQlMEFhc3luYyUyMGZ1bmN0aW9uJTIwZ2V0TmV0d29ya3MlMjh0b2tlbiUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwZGF0YSUyMCUzRCUyMG5ldyUyMEZvcm1EYXRhJTI4JTI5JTNCJTBBJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjdsbGF2ZSUyNyUyQyUyMFBBWUJJX0xMQVZFJTI5JTNCJTBBJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjd0b2tlbiUyNyUyQyUyMHRva2VuJTI5JTNCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjByZXNwb25zZSUyMCUzRCUyMGF3YWl0JTIwYXhpb3MucG9zdCUyOCU2MCUyNCU3QlBBWUJJX0FQSV9VUkwlN0QlMkZuZXR3b3JrJTJGYWxsJTYwJTJDJTIwZGF0YSUyQyUyMGdldEZvcm1EYXRhQ29uZmlnJTI4ZGF0YSUyOSUyOSUzQiUwQSUyMCUyMCUyMCUyMGlmJTIwJTI4cmVzcG9uc2UuZGF0YS5yZXN1bHQlMjAlM0QlM0QlM0QlMjAlMjdzdWNjZXNzJTI3JTIwJTI2JTI2JTIwcmVzcG9uc2UuZGF0YS5kYXRhLmxlbmd0aCUyMCUzRSUyMDAlMjklMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMGFwaU5ldHdvcmslMjAlM0QlMjByZXNwb25zZS5kYXRhLmRhdGEuZmluZCUyOG4lMjAlM0QlM0UlMjBuLm5vbWJyZSUyMCUzRCUzRCUzRCUyMCUyN0FQSSUyNyUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMGFwaU5ldHdvcmslMjAlM0YlMjBhcGlOZXR3b3JrLmNvZGlnbyUyMCUzQSUyMHJlc3BvbnNlLmRhdGEuZGF0YSU1QjAlNUQuY29kaWdvJTNCJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwcmV0dXJuJTIwbnVsbCUzQiUwQSU3RCUwQSUwQSUyRiUyRiUyMDMuJTIwQ3JlYXIlMjBlbCUyMGxpbmslMjBkZSUyMHBhZ28lMjAlRTIlODAlOTQlMjBlbmRwb2ludCUyMHF1ZSUyMGxsYW1hJTIwdHUlMjBmcm9udGVuZCUwQWFwcC5wb3N0JTI4JTI3JTJGYXBpJTJGY3JlYXRlLXBheW1lbnQlMjclMkMlMjAlNUIlMEElMjAlMjAlMjAlMjBib2R5JTI4JTI3YW1vdW50JTI3JTI5LmlzRmxvYXQlMjglN0IlMjBtaW4lM0ElMjAxJTJDJTIwbWF4JTNBJTIwMTAwMDAlMjAlN0QlMjkud2l0aE1lc3NhZ2UlMjglMjdNb250byUyMGludiVDMyVBMWxpZG8lMjclMjklMEElNUQlMkMlMjBhc3luYyUyMCUyOHJlcSUyQyUyMHJlcyUyOSUyMCUzRCUzRSUyMCU3QiUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwZXJyb3JzJTIwJTNEJTIwdmFsaWRhdGlvblJlc3VsdCUyOHJlcSUyOSUzQiUwQSUyMCUyMCUyMCUyMGlmJTIwJTI4JTIxZXJyb3JzLmlzRW1wdHklMjglMjklMjklMjByZXR1cm4lMjByZXMuc3RhdHVzJTI4NDAwJTI5Lmpzb24lMjglN0IlMjBlcnJvcnMlM0ElMjBlcnJvcnMuYXJyYXklMjglMjklMjAlN0QlMjklM0IlMEElMjAlMjAlMjAlMjBjb25zdCUyMCU3QiUyMGFtb3VudCUyMCU3RCUyMCUzRCUyMHJlcS5ib2R5JTNCJTBBJTIwJTIwJTIwJTIwdHJ5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjB0b2tlbiUyMCUzRCUyMGF3YWl0JTIwZ2V0UGF5QmlUb2tlbiUyOCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwbmV0d29ya0lkJTIwJTNEJTIwYXdhaXQlMjBnZXROZXR3b3JrcyUyOHRva2VuJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaWYlMjAlMjglMjFuZXR3b3JrSWQlMjklMjByZXR1cm4lMjByZXMuc3RhdHVzJTI4NTAwJTI5Lmpzb24lMjglN0IlMjBlcnJvciUzQSUyMCUyN05vJTIwcGF5bWVudCUyMG5ldHdvcmslMjBhdmFpbGFibGUlMjclMjAlN0QlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMHVuaXF1ZUlkJTIwJTNEJTIwZ2V0TmV4dExpbmtJZCUyOCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwZGF0YSUyMCUzRCUyMG5ldyUyMEZvcm1EYXRhJTI4JTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjdsbGF2ZSUyNyUyQyUyMFBBWUJJX0xMQVZFJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjd0b2tlbiUyNyUyQyUyMHRva2VuJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjdub21icmVfaW50ZXJubyUyNyUyQyUyMCU2MFBlZGlkbyUyMCUyNCU3QnVuaXF1ZUlkJTdEJTYwJTI5JTNCJTIwJTJGJTJGJTIwdHUlMjByZWZlcmVuY2lhJTIwcmVhbCUyMGRlJTIwbmVnb2NpbyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGRhdGEuYXBwZW5kJTI4JTI3Y29kaWdvX2ludGVybm8lMjclMkMlMjAlMjclMjclMjklM0IlMjAlMkYlMkYlMjB2YWMlQzMlQURvJTIwJTNEJTIwUGF5JTIwQmklMjBnZW5lcmElMjBlbCUyMGlkZW50aWZpY2Fkb3IlMjBkZWwlMjBsaW5rJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjd0aXR1bG8lMjclMkMlMjAlNjBQZWRpZG8lMjAtJTIwUSUyNCU3QmFtb3VudCU3RCU2MCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGRhdGEuYXBwZW5kJTI4JTI3ZGVzY3JpcGNpb24lMjclMkMlMjAlNjBQYWdvJTIwZGUlMjBRJTI0JTdCYW1vdW50JTdEJTYwJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwZGF0YS5hcHBlbmQlMjglMjdtb250byUyNyUyQyUyMGFtb3VudC50b1N0cmluZyUyOCUyOSUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGRhdGEuYXBwZW5kJTI4JTI3ZXN0YWRvJTI3JTJDJTIwJTI3MSUyNyUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGRhdGEuYXBwZW5kJTI4JTI3Y3VvdGFzJTI3JTJDJTIwJTI3VkMwMCUyNyUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGRhdGEuYXBwZW5kJTI4JTI3cmVkZXNfc29jaWFsZXMlMjclMkMlMjBuZXR3b3JrSWQlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBkYXRhLmFwcGVuZCUyOCUyN3ppZ2klMjclMkMlMjAlMjcwJTI3JTI5JTNCJTIwJTJGJTJGJTIwZGVzaGFiaWxpdGFkbyUyMHNhbHZvJTIwcXVlJTIwdHUlMjBjdWVudGElMjBsbyUyMHRlbmdhJTIwaGFiaWxpdGFkbyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnN0JTIwcmVzcG9uc2UlMjAlM0QlMjBhd2FpdCUyMGF4aW9zLnBvc3QlMjglNjAlMjQlN0JQQVlCSV9BUElfVVJMJTdEJTJGbGluayUyRm1haW50ZW5hbmNlJTYwJTJDJTIwZGF0YSUyQyUyMGdldEZvcm1EYXRhQ29uZmlnJTI4ZGF0YSUyOSUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGlmJTIwJTI4cmVzcG9uc2UuZGF0YS5yZXN1bHQlMjAlM0QlM0QlM0QlMjAlMjdzdWNjZXNzJTI3JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjBwYXltZW50VXJsJTIwJTNEJTIwcmVzcG9uc2UuZGF0YS5kYXRhJTNGLiU1QjAlNUQlM0YudXJsJTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaWYlMjAlMjhwYXltZW50VXJsJTI5JTIwcmV0dXJuJTIwcmVzLmpzb24lMjglN0IlMjBsaW5rJTNBJTIwcGF5bWVudFVybCUyMCU3RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMHJlcy5zdGF0dXMlMjg1MDAlMjkuanNvbiUyOCU3QiUyMGVycm9yJTNBJTIwJTI3TGluayUyMGdlbmVyYWRvJTIwcGVybyUyMHNpbiUyMFVSTCUyNyUyQyUyMHJhdyUzQSUyMHJlc3BvbnNlLmRhdGElMjAlN0QlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjByZXMuc3RhdHVzJTI4NTAwJTI5Lmpzb24lMjglN0IlMjBlcnJvciUzQSUyMCUyN05vJTIwc2UlMjBwdWRvJTIwY3JlYXIlMjBlbCUyMGxpbmslMjclMkMlMjBtZXNzYWdlJTNBJTIwcmVzcG9uc2UuZGF0YS5tZXNzYWdlJTIwJTdEJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTdEJTIwY2F0Y2glMjAlMjhlcnJvciUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvbnNvbGUuZXJyb3IlMjglMjdFcnJvciUyMGNyZWF0aW5nJTIwcGF5bWVudCUyMGxpbmslM0ElMjclMkMlMjBlcnJvci5tZXNzYWdlJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcmVzLnN0YXR1cyUyODUwMCUyOS5qc29uJTI4JTdCJTIwZXJyb3IlM0ElMjAlMjdGYWlsZWQlMjB0byUyMGNyZWF0ZSUyMHBheW1lbnQlMjBsaW5rJTI3JTIwJTdEJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTdEJTBBJTdEJTI5JTNCJTBBJTBBJTJGJTJGJTIwNC4lMjBXZWJob29rJTNBJTIwUGF5JTIwQmklMjBsbGFtYSUyMGFxdSVDMyVBRCUyMGNvbiUyMGxhJTIwY29uZmlybWFjaSVDMyVCM24lMjBlbmNyaXB0YWRhJTBBYXBwLnBvc3QlMjglMjclMkZwYXltZW50LXJlc3VsdCUyNyUyQyUyMCUyOHJlcSUyQyUyMHJlcyUyOSUyMCUzRCUzRSUyMCU3QiUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwJTdCJTIwdG9rZW4lMkMlMjByZWZlcmVuY2UlMkMlMjBhdWRpdCUyQyUyMGNvZGUlMkMlMjBhbW91bnQlMkMlMjBhdXRob3JpemF0aW9uJTJDJTIwbGlua19jb2RlJTJDJTIwbGlua19uYW1lJTJDJTIwbGlua190b2tlbiUyMCU3RCUyMCUzRCUyMHJlcS5ib2R5JTNCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjBkZWNyeXB0ZWQlMjAlM0QlMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB0b2tlbiUyQyUyMCUyRiUyRiUyMG5vJTIwZW5jcmlwdGFkbyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGNvZGUlMkMlMjAlMkYlMkYlMjBubyUyMGVuY3JpcHRhZG8lMjAlRTIlODAlOTQlMjAlMjIwMCUyMiUyMGVzJTIwJUMzJUE5eGl0byUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlZmVyZW5jZSUzQSUyMGRlY3J5cHRQYXlCaURhdGElMjhyZWZlcmVuY2UlMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBhdWRpdCUzQSUyMGRlY3J5cHRQYXlCaURhdGElMjhhdWRpdCUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGFtb3VudCUzQSUyMGRlY3J5cHRQYXlCaURhdGElMjhhbW91bnQlMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBhdXRob3JpemF0aW9uJTNBJTIwZGVjcnlwdFBheUJpRGF0YSUyOGF1dGhvcml6YXRpb24lMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBsaW5rX2NvZGUlM0ElMjBkZWNyeXB0UGF5QmlEYXRhJTI4bGlua19jb2RlJTI5JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwbGlua19uYW1lJTNBJTIwZGVjcnlwdFBheUJpRGF0YSUyOGxpbmtfbmFtZSUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGxpbmtfdG9rZW4lM0ElMjBkZWNyeXB0UGF5QmlEYXRhJTI4bGlua190b2tlbiUyOSUyQyUwQSUyMCUyMCUyMCUyMCU3RCUzQiUwQSUyMCUyMCUyMCUyMGlmJTIwJTI4Y29kZSUyMCUzRCUzRCUzRCUyMCUyNzAwJTI3JTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjBwYXJhbXMlMjAlM0QlMjBuZXclMjBVUkxTZWFyY2hQYXJhbXMlMjglN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBhbW91bnQlM0ElMjBkZWNyeXB0ZWQuYW1vdW50JTIwJTdDJTdDJTIwJTI3JTI3JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwcmVmZXJlbmNlJTNBJTIwZGVjcnlwdGVkLnJlZmVyZW5jZSUyMCU3QyU3QyUyMCUyNyUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGF1dGhvcml6YXRpb24lM0ElMjBkZWNyeXB0ZWQuYXV0aG9yaXphdGlvbiUyMCU3QyU3QyUyMCUyNyUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGF1ZGl0JTNBJTIwZGVjcnlwdGVkLmF1ZGl0JTIwJTdDJTdDJTIwJTI3JTI3JTJDJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwbGlua19jb2RlJTNBJTIwZGVjcnlwdGVkLmxpbmtfY29kZSUyMCU3QyU3QyUyMCUyNyUyNyUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlcy5yZWRpcmVjdCUyOCU2MCUyNCU3QkZST05URU5EX1VSTCU3RCUyRnRoYW5rLXlvdSUzRiUyNCU3QnBhcmFtcy50b1N0cmluZyUyOCUyOSU3RCU2MCUyOSUzQiUwQSUyMCUyMCUyMCUyMCU3RCUyMGVsc2UlMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMHBhcmFtcyUyMCUzRCUyMG5ldyUyMFVSTFNlYXJjaFBhcmFtcyUyOCU3QiUyMGVycm9yJTNBJTIwJTI3cGF5bWVudF9mYWlsZWQlMjclMkMlMjBjb2RlJTNBJTIwY29kZSUyMCU3QyU3QyUyMCUyNyUyNyUyMCU3RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlcy5yZWRpcmVjdCUyOCU2MCUyNCU3QkZST05URU5EX1VSTCU3RCUyRiUzRiUyNCU3QnBhcmFtcy50b1N0cmluZyUyOCUyOSU3RCU2MCUyOSUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSU3RCUyOSUzQiUwQSUwQWFwcC5saXN0ZW4lMjhwcm9jZXNzLmVudi5QT1JUJTIwJTdDJTdDJTIwMzAwMCUyOSUzQg==”][banner_icono_paybi]

Usa FormData real, no solo x-www-form-urlencoded . Esta integración en producción arma el cuerpo de cada petición con la librería form-data de Node y sus headers ( getHeaders() ), que es el equivalente exacto del multipart/form-data que arma curl en PHP. qs.stringify() con x-www-form-urlencoded (como en los ejemplos anteriores de esta guía) también funciona, pero si tienes problemas con un campo específico, form-data es la opción más cercana a lo que prueba Postman.

[/banner_icono_paybi]

Frontend · cliente hacia tu propio backend

El frontend nunca habla con admlink.ebi.com.gt directamente — solo con tu backend. Esto es lo que hace posible mantener la llave y credenciales fuera del navegador.

[bloque_codigo codigo=”aW1wb3J0JTIwYXhpb3MlMjBmcm9tJTIwJTI3YXhpb3MlMjclM0IlMEElMEFjb25zdCUyMEFQSV9VUkwlMjAlM0QlMjBpbXBvcnQubWV0YS5lbnYuVklURV9BUElfVVJMJTIwJTdDJTdDJTIwJTI3aHR0cCUzQSUyRiUyRmxvY2FsaG9zdCUzQTMwMDAlMjclM0IlMEFjb25zdCUyMGFwaSUyMCUzRCUyMGF4aW9zLmNyZWF0ZSUyOCU3QiUwQSUyMCUyMCUyMCUyMGJhc2VVUkwlM0ElMjBBUElfVVJMJTJDJTBBJTIwJTIwJTIwJTIwaGVhZGVycyUzQSUyMCU3QiUyMCUyN0NvbnRlbnQtVHlwZSUyNyUzQSUyMCUyN2FwcGxpY2F0aW9uJTJGanNvbiUyNyUyMCU3RCUyQyUwQSU3RCUyOSUzQiUwQSUwQWV4cG9ydCUyMGNvbnN0JTIwY3JlYXRlUGF5bWVudCUyMCUzRCUyMGFzeW5jJTIwJTI4YW1vdW50JTI5JTIwJTNEJTNFJTIwJTdCJTBBJTIwJTIwJTIwJTIwdHJ5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjByZXNwb25zZSUyMCUzRCUyMGF3YWl0JTIwYXBpLnBvc3QlMjglMjclMkZhcGklMkZjcmVhdGUtcGF5bWVudCUyNyUyQyUyMCU3QiUyMGFtb3VudCUyMCU3RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJldHVybiUyMHJlc3BvbnNlLmRhdGElM0IlMEElMjAlMjAlMjAlMjAlN0QlMjBjYXRjaCUyMCUyOGVycm9yJTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdGhyb3clMjBuZXclMjBFcnJvciUyOGVycm9yLnJlc3BvbnNlJTNGLmRhdGElM0YuZXJyb3IlMjAlN0MlN0MlMjAlMjdFcnJvciUyMGNyZWF0aW5nJTIwcGF5bWVudCUyNyUyOSUzQiUwQSUyMCUyMCUyMCUyMCU3RCUwQSU3RCUzQg==”]

Frontend · iniciar el pago desde un componente

[bloque_codigo codigo=”aW1wb3J0JTIwJTdCJTIwdXNlU3RhdGUlMjAlN0QlMjBmcm9tJTIwJTI3cmVhY3QlMjclM0IlMEFpbXBvcnQlMjAlN0IlMjBjcmVhdGVQYXltZW50JTIwJTdEJTIwZnJvbSUyMCUyNy4uJTJGc2VydmljZXMlMkZhcGklMjclM0IlMEElMEFleHBvcnQlMjBkZWZhdWx0JTIwZnVuY3Rpb24lMjBQYXltZW50TW9kYWwlMjglN0IlMjBpc09wZW4lMkMlMjBvbkNsb3NlJTIwJTdEJTI5JTIwJTdCJTBBJTIwJTIwJTIwJTIwY29uc3QlMjAlNUJhbW91bnQlMkMlMjBzZXRBbW91bnQlNUQlMjAlM0QlMjB1c2VTdGF0ZSUyOG51bGwlMjklM0IlMEElMjAlMjAlMjAlMjBjb25zdCUyMCU1QmxvYWRpbmclMkMlMjBzZXRMb2FkaW5nJTVEJTIwJTNEJTIwdXNlU3RhdGUlMjhmYWxzZSUyOSUzQiUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwJTVCZXJyb3IlMkMlMjBzZXRFcnJvciU1RCUyMCUzRCUyMHVzZVN0YXRlJTI4bnVsbCUyOSUzQiUwQSUwQSUyMCUyMCUyMCUyMGNvbnN0JTIwaGFuZGxlQ29uZmlybSUyMCUzRCUyMGFzeW5jJTIwJTI4JTI5JTIwJTNEJTNFJTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwaWYlMjAlMjglMjFhbW91bnQlMjklMjByZXR1cm4lMjBzZXRFcnJvciUyOCUyN1NlbGVjY2lvbmElMjBvJTIwaW5ncmVzYSUyMHVuJTIwbW9udG8lMjB2JUMzJUExbGlkbyUyNyUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHNldExvYWRpbmclMjh0cnVlJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwdHJ5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwY29uc3QlMjByZXNwb25zZSUyMCUzRCUyMGF3YWl0JTIwY3JlYXRlUGF5bWVudCUyOGFtb3VudCUyOSUzQiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGlmJTIwJTI4cmVzcG9uc2UubGluayUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyRiUyRiUyMFJlZGlyZWNjaSVDMyVCM24lMjBkZSUyMHAlQzMlQTFnaW5hJTIwY29tcGxldGElMjAlRTIlODAlOTQlMjBubyUyMGVzJTIwdW4lMjBmZXRjaCUyMG5pJTIwdW4lMjBpZnJhbWUlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjB3aW5kb3cubG9jYXRpb24uaHJlZiUyMCUzRCUyMHJlc3BvbnNlLmxpbmslM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMjBlbHNlJTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwc2V0RXJyb3IlMjglMjdObyUyMHNlJTIwcHVkbyUyMGdlbmVyYXIlMjBlbCUyMGxpbmslMjBkZSUyMHBhZ28lMjclMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMjBjYXRjaCUyMCUyOGVyciUyOSUyMCU3QiUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHNldEVycm9yJTI4ZXJyLm1lc3NhZ2UlMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlN0QlMjBmaW5hbGx5JTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwc2V0TG9hZGluZyUyOGZhbHNlJTI5JTNCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTdEJTBBJTIwJTIwJTIwJTIwJTdEJTNCJTBBJTBBJTIwJTIwJTIwJTIwaWYlMjAlMjglMjFpc09wZW4lMjklMjByZXR1cm4lMjBudWxsJTNCJTBBJTBBJTIwJTIwJTIwJTIwcmV0dXJuJTIwJTI4JTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTJGJTJBJTIwLi4uc2VsZWN0b3IlMjBkZSUyMG1vbnRvJTJDJTIwYm90JUMzJUIzbiUyMCUyMkNvbnRpbnVhciUyMiUyMHF1ZSUyMGxsYW1hJTIwaGFuZGxlQ29uZmlybS4uLiUyMCUyQSUyRiUwQSUyMCUyMCUyMCUyMCUyOSUzQiUwQSU3RA==”]

Frontend · leer la confirmación en la página de gracias

La ruta /thank-you no recibe datos encriptados — el backend ya los desencriptó y los pasó como query params en la redirección. El frontend solo los lee con URLSearchParams .

[bloque_codigo codigo=”aW1wb3J0JTIwJTdCJTIwdXNlRWZmZWN0JTJDJTIwdXNlU3RhdGUlMjAlN0QlMjBmcm9tJTIwJTI3cmVhY3QlMjclM0IlMEElMEFleHBvcnQlMjBkZWZhdWx0JTIwZnVuY3Rpb24lMjBUaGFua1lvdVBhZ2UlMjglMjklMjAlN0IlMEElMjAlMjAlMjAlMjBjb25zdCUyMCU1QmRhdGElMkMlMjBzZXREYXRhJTVEJTIwJTNEJTIwdXNlU3RhdGUlMjglN0IlN0QlMjklM0IlMEElMEElMjAlMjAlMjAlMjB1c2VFZmZlY3QlMjglMjglMjklMjAlM0QlM0UlMjAlN0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBjb25zdCUyMHBhcmFtcyUyMCUzRCUyMG5ldyUyMFVSTFNlYXJjaFBhcmFtcyUyOHdpbmRvdy5sb2NhdGlvbi5zZWFyY2glMjklM0IlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBzZXREYXRhJTI4JTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwYW1vdW50JTNBJTIwcGFyYW1zLmdldCUyOCUyN2Ftb3VudCUyNyUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGF1dGhvcml6YXRpb24lM0ElMjBwYXJhbXMuZ2V0JTI4JTI3YXV0aG9yaXphdGlvbiUyNyUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMHJlZmVyZW5jZSUzQSUyMHBhcmFtcy5nZXQlMjglMjdyZWZlcmVuY2UlMjclMjklMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjBhdWRpdCUzQSUyMHBhcmFtcy5nZXQlMjglMjdhdWRpdCUyNyUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMGxpbmtDb2RlJTNBJTIwcGFyYW1zLmdldCUyOCUyN2xpbmtfY29kZSUyNyUyOSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU3RCUyOSUzQiUwQSUyMCUyMCUyMCUyMCU3RCUyQyUyMCU1QiU1RCUyOSUzQiUwQSUwQSUyMCUyMCUyMCUyMCUyRiUyRiUyMGRhdGEuYW1vdW50JTJDJTIwZGF0YS5hdXRob3JpemF0aW9uJTJDJTIwZXRjLiUyMHlhJTIwZXN0JUMzJUExbiUyMGxpc3RvcyUyMHBhcmElMjBtb3N0cmFyJTIwJUUyJTgwJTk0JTBBJTIwJTIwJTIwJTIwJTJGJTJGJTIwbnVuY2ElMjBsbGVnYXJvbiUyMGVuY3JpcHRhZG9zJTIwaGFzdGElMjBhcXUlQzMlQUQlMkMlMjBuaSUyMGVzdGUlMjBjb21wb25lbnRlJTIwY29ub2NlJTIwbGElMjBDU1QlMkZJVkMlMEElMjAlMjAlMjAlMjByZXR1cm4lMjAlMkYlMkElMjAuLi50YXJqZXRhJTIwZGUlMjBjb25maXJtYWNpJUMzJUIzbiUyMGNvbiUyMGVzdG9zJTIwZGF0b3MuLi4lMjAlMkElMkYlM0IlMEElN0Q=”][banner_icono_paybi variante=”warning”]

El monto de la URL es solo para mostrar al usuario, no para confirmar el pago. En este ejemplo, la página de gracias confía en que el backend ya validó code === ’00’ antes de redirigir aquí. Si necesitas una verificación adicional, cruza link_code contra tu base de datos o contra el método Buscar Link antes de marcar un pedido como pagado.

[/banner_icono_paybi]

[texto_separadores_paybi separadores=”superior” etiqueta=”16 · ANTES DE SALIR A PRODUCCIÓN” titulo=”Checklist de salida a producción” el_id=”checklistdesalidaaproduccion”][/texto_separadores_paybi]
[banner_imagen_pill_paybi descripcion=”Llave, usuario, clave, IVC y CST viven en variables de entorno o un secret manager — nunca en el repositorio ni en el frontend.” titulo=”Credenciales”]
[banner_imagen_pill_paybi descripcion=”El login se hace una vez y el token se reutiliza hasta vencer. Hacer login en cada request invalida tokens de otros procesos concurrentes.” titulo=”Token en caché”]
[banner_imagen_pill_paybi descripcion=”Endpoints de éxito y rechazo dados de alta en el panel de Link Bi, públicos, por HTTPS, y probados con el botón de pruebas de Postman.” titulo=”URLs de retorno configuradas”]
[banner_imagen_pill_paybi descripcion=”IVC y CST correctos, validado contra el payload de ejemplo antes de procesar pagos reales.” titulo=”Desencriptación probada”]
[banner_imagen_pill_paybi descripcion=”Usado consistentemente para poder reconciliar cada webhook contra tu base de datos de pedidos. codigo_interno es solo el identificador del link, déjalo vacío salvo que necesites editar ese link después.” titulo=”nombre_interno = tu ID de orden”]
[banner_imagen_pill_paybi descripcion=”El estado “pagado“ se confirma solo con el webhook desencriptado (idealmente cruzado con Buscar Link), nunca solo por la redirección del navegador.” titulo=”Verificación server-side del pago”]
[banner_imagen_pill_paybi descripcion=”El frontend comunica claramente que el pago abre en una pestaña distinta — evita que el usuario piense que la página se quedó “colgada“.” titulo=”UX de pestaña nueva”]
[banner_imagen_pill_paybi descripcion=”Registra result, message y el nombre_interno de cada llamada a Pay Bi para depurar disputas o pagos no reconciliados.” titulo=”Logs de cada llamada”]