Artículos sobre: Enlaces de pago
Este artículo también está disponible en:

Fygaro Links: Integración (API)

Cómo enviar información a un enlace Fygaro


Si desea integrar las capacidades de pago de Fygaro en su plataforma, ofrecemos 2 opciones sobre cómo pasar información al proceso de pago de Fygaro Links.


Opción 1: Utilice parámetros URL para pre-rellenar el botón de pago y permitir que sea modificado por el cliente.


Para incluir información via URL, agregue parámetros a su link de pago con el siguiente formato:


Estructura: **[url del botón] + ?amount=“10.00”


Después de amount=  ingrese en formato codificado para URL el monto con hasta 2 decimales.


Después de client_note= ingrese un texto codificado URL para registrar con el pago.


Después de client_reference= ingrese un texto codificado URL para registrar con el pago.


Opción 2: Utiliza los Json Web Tokens (JWT) para construir un botón de pago que no puede ser modificado por tu cliente.
Los campos en bold del JWT pueden ser modificados por tu persona o el sistema que utilices.


La función de los JWT solo está disponible en planes Pro (Botón de Pago / Shops) o superior


Estructura: [url del botón] + ?jwt=[jwt_code]


La sección "Header" debe contener:


{"alg": "HS256","typ": "JWT","kid": "Su-Key"}


La sección "Payload" puede contener cualquiera de los siguientes (opcionales):


{"amount": "100.01","currency": "USD","custom_reference": "001","exp": "UnixTimestamp","nbf" : "UnixTimestamp"}



Variable

Descripción

amount

Número o cadena decimal, mayor que cero, máximo 2 decimales.

currency

Cadena de texto, código ISO de moneda habilitada para el comercio (ej.: "USD").

tax_amount

Número o cadena decimal, mayor que cero y sin superar el monto total, máximo 2 decimales. El impuesto está incluido en el monto total.

custom_reference

Cadena de texto, máximo 40 caracteres. Se eliminan los espacios al inicio y al final.

firstname

Cadena de texto, nombre del cliente. (Requiere lastname)

lastname

Cadena de texto, apellido del cliente. (Require firstname)

email

Cadena de texto, dirección de correo electrónico válida, máximo 254 caracteres.

phone

Cadena de texto, formato internacional: + seguido de 2 a 15 dígitos, sin espacios ni cero inicial. (Configurado en Fygaro Links, de lo contrario es ignorado)

exp

Número entero, fecha y hora de vencimiento en segundos Unix. Recomendado.

nbf

Número entero, fecha y hora de inicio de vigencia en segundos Unix.

iat

Número entero, fecha y hora de emisión en segundos Unix.


Para utilizar Fygaro Wallet, los datos de firstname, lastname e email deben coincidir con los de la cuenta del Wallet.


amount , currency , y tax_amount solo aplican para Links de tipo Variable.


Comercios de Panamá (Banco General): pueden reportar el impuesto cobrado mediante 2 opciones:Ingresar el monto del impuesto (hasta 2 decimales) en el campo tax_amount, por ejemplo: "7.00".Indicar el porcentaje (%) del impuesto a calcular utilizando el campo disponible en Ajustes Avanzados del Botón de Pago o del Plugin.En ambos casos, se asume que el impuesto ya está incluido en el valor ingresado en el campo Amount.


La firma debe contener su llave secrete:


HMACSHA256( base64UrlEncode(header) + "." + base64UrlEncode(payload), Su-Fygaro-Secreto)



Si requiere información sobre JWT, por favor visite https://jwt.io/ 


Si su integración require capacidades de Captura Manual, Devolución u otras, por favor contactar a nuestro equipo de soporte


Opciones de Confirmación del Pago


Una vez que se complete un pago exitosamente, puedes habilitar las siguientes funciones:

  • URL de Retorno: Redirige a tus clientes de vuelta a tu sitio web después del pago. También puedes incluir parámetros en la URL, como:
    • reference – el ID de Pago de Fygaro
    • custom_reference – el valor personalizado opcional que proporcionaste mediante la integración con JWT
Ejemplo: domain.com`?reference=123&customReference=abc`
  • Webhook (Hook): Actualiza tu sistema automáticamente al recibir un pago exitoso configurando una integración con webhook. 👉 Ver el tutorial


Credenciales API:

Para obtener su API Key y Secrete, debes ingresar en "Ajustes" > "Credenciales API" > "Generar Nueva".


Las claves de acceso secretas son, como su nombre lo indica, secretos, igual que tu contraseña. Por tu propia seguridad, Fygaro no le revela tu contraseña si la olvidaste (tendrías que establecer una nueva contraseña). Del mismo modo, Fygaro no permite la recuperación de una clave de acceso secreta después de su creación inicial.


Por lo anterior, es importante que descargues el archivo generado con tu Clave Pública y Secreta para futura referencia y uso.


Para revocar una llave extraviada, basta con ingresar en "Ajustes" > "Credenciales API" y dar click sobre la "X" roja al lado de tu clave pública.

Actualizado el: 18/11/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!