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.
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]
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]
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”]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.
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]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”]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]
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.
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 .
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.
Respuesta · data[]
Misma respuesta que el método link: un arreglo de {nombre, url} por cada red social.
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]
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]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]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]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]
Listar carteras
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.
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]
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]
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]
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
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
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
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.
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.
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.
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 .
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]





