# Crear Enlace de Pago

{% hint style="info" %}
POST [/EnlacePago](https://api.wompi.sv)
{% endhint %}

## Ejemplo Pantalla de Pago Generada por Wompi

<figure><img src="https://2460927214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8xOsnnMOdstbCA5hok%2Fuploads%2FecM2PhOyzBcsM6Q3MwsH%2FScreenshot%202026-03-24%20094450.png?alt=media&#x26;token=b6a686f2-f389-4a90-b4b0-865d28f068a4" alt=""><figcaption><p>Ejemplo de interfaz de pago</p></figcaption></figure>

## Creación Enlace de Pago

### Ejemplo Petición Básica

Ejemplo de petición solo con campos requeridos

```
{
  "identificadorEnlaceComercio": "string",
  "monto": 0,
  "nombreProducto": "string"
}
```

### Ejemplo Respuesta

```
{
   "idEnlace":15,
   "urlQrCodeEnlace":"https://wompistorage.blob.core.windows.net/imagenes/6c8fa0db-fb0f-4e65-bad7-2f2aced974f2.jpg",
   "urlEnlace":"https://lk.wompi.sv/yhDt",
   "estaProductivo":false
}
```

## Objeto Completo de Petición

En la sección anterior se definió una petición básica para crear un enlace de pago. En esta sección se detallan todas las propiedades opcionales que se pueden incluir para personalizar el contenido y comportamiento del botón.

### **JSON Completo**

```
{
  "identificadorEnlaceComercio": "string",
  "monto": 0,
  "nombreProducto": "string",
  "formaPago": {
    "permitirTarjetaCreditoDebido": true,
    "permitirPagoConPuntoAgricola": true,
    "permitirPagoEnCuotasAgricola": true,
    "permitirPagoEnBitcoin": true,
    "permitePagoQuickPay": true,
  },
  "cantidadMaximaCuotas": "Tres",
  "infoProducto": {
    "descripcionProducto": "string",
    "urlImagenProducto": "string"
  },
  "configuracion": {
    "urlRedirect": "string",
    "esMontoEditable": true,
    "esCantidadEditable": true,
    "cantidadPorDefecto": 0,
    "duracionInterfazIntentoMinutos": 0,
    "urlRetorno": "string",
    "emailsNotificacion": "string",
    "urlWebhook": "string",
    "telefonosNotificacion": "string",
    "notificarTransaccionCliente": true
  },
  "vigencia": {
    "fechaInicio": "2025-06-25T15:45:19.206Z",
    "fechaFin": "2025-06-25T15:45:19.206Z"
  },
  "limitesDeUso": {
    "cantidadMaximaPagosExitosos": 0,
    "cantidadMaximaPagosFallidos": 0
  },
  "idGrupoTarjetas": "string"
}
```

#### Definición Campos Objeto Root

| Campo                       | Requerido | Tipo Dato           | Descripción                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------- | --------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| identificadorEnlaceComercio | Si        | string(500)         | Identificador del comercio para este enlace de pago. La idea que sea un identificador único que permita al comercio identificar el pago en los reportes, en el correo de notificación o en el webhook.                                                                                                                                                                      |
| monto                       | Si        | double              | Monto a cobrar al cliente en el botón de pago, tiene que ser al menos un monto de $0.01                                                                                                                                                                                                                                                                                     |
| nombreProducto              | Si        | string(500)         | Nombre del producto que se muestra al usuario en la interfaz de pago.                                                                                                                                                                                                                                                                                                       |
| formaPago                   | No        | EnlaceFormaPago     | Datos de las formas de pago aceptadas en la interfaz de pago. Si se omite se acepta solo pago con tarjeta de crédito/debido y pago con puntos . \*Ver detalles del objeto más adelante\*                                                                                                                                                                                    |
| cantidadMaximaCuotas        | No        | Enum                | Si su cuenta es tiene la configuración por defecto los valores pueden ser uno de los siguientes valores: Tres, Seis, Nueve, Doce. Si su cuenta es un "Payment Gateway" negociado de manera externa con Banco Agrícola es necesario invocar el End Point de "[Datos Negocio](https://docs.wompi.sv/metodos-api/datos-aplicativo)" para ver las cuotas que tiene disponibles. |
| idGrupoTarjetas             | No        | String              | Este id corresponde al grupo de tarjeta que delimitará con cuales tarjetas podrá ser utilizado el enlace. Este Id se encuentra en la sección de "Grupos de tarjetas" del panel de Wompi                                                                                                                                                                                     |
| infoProducto                | No        | EnlaceInfoProducto  | Datos adicionales del producto que se pueden mostrar en la interfaz de pago.  Ver detalles del objeto más adelante.                                                                                                                                                                                                                                                         |
| Configuracion               | No        | EnlaceConfiguracion | Parámetros de configuración del comportamiento del enlace de pago y de la forma de notificar las transacciones exitosas. Ver detalles del objeto más adelante.                                                                                                                                                                                                              |
| Vigencia                    | No        | EnlaceVigencia      | Parámetros adicionales para definir la vigencia del enlace. Ver detalles del objeto mas adelante                                                                                                                                                                                                                                                                            |
| LimitesDeUso                | No        | EnlaceLimitesDeUso  | Parámetros adicionales para definir los límites de uso de un enlace de pago. Ver detalles del objeto mas adelante                                                                                                                                                                                                                                                           |

#### Definición Campos Objeto "EnlaceFormaPago"

| Campo                         | Requerido | Tipo Dato | Descripción                                                                                                                                                                                                                                                                  |
| ----------------------------- | --------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| permitirTarjetaCreditoDebido  | Si        | bool      | Si es "verdadero" el cliente puede realizar el pago con tarjeta de crédito o débito, sino no.                                                                                                                                                                                |
| permitirPagoConPuntoAgricola  | Si        | bool      | Si es "verdadero" el cliente puede realizar el pago con puntos de Banco Agrícola. Para estar seguro que su negocio soporta pago con puntos puede confirmarlo con el end point de "[Datos Negocio](https://docs.wompi.sv/metodos-api/datos-aplicativo)"                       |
| permitirPagoEnCuotasAgricola  | Si        | bool      | Si es "verdadero" el cliente puede realizar el pago en cuotas con tarjetas de crédito de Banco Agrícola. Para estar seguro que su negocio soporta pago en cuotas puede confirmarlo con el end point de "[Datos Negocio](https://docs.wompi.sv/metodos-api/datos-aplicativo)" |
| permitirPagoEnBitcoin         | Si        | bool      | Si es "verdadero" el cliente puede realizar un pago con bitcoin. Para estar seguro que su negocio soporta pago en cuotas puede confirmarlo con el end point de "[Datos Negocio](https://docs.wompi.sv/metodos-api/datos-aplicativo)"                                         |
| &#xD;&#xD;permitePagoQuickPay | Si        | bool      | Si es "verdadero" el clientw puede realizar un pago con Quick Pay. Para estar seguro que su negocio soporta pago en cuotas puede confirmarlo con el end point de "[Datos Negocio](https://docs.wompi.sv/metodos-api/datos-aplicativo)"                                       |

{% hint style="info" %}
**Validación Adicional a Considerar:** Al menos uno de los valores de este objeto tiene que ser "verdadero"
{% endhint %}

#### Definición Campos Objeto "EnlaceInfoProducto"

| Campo               | Requerido | Tipo Dato   | Descripción                                                                                                                                                                 |
| ------------------- | --------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DescripcionProducto | No        | string(max) | Descripción complementaria sobre el producto, puede ser un texto bastante extenso con información técnica del producto. Esta información se muestra en la interfaz de pago. |
| UrlImagenProducto   | No        | url         | URL de la imagen de la imagen del producto que se desea mostrar en la interfaz de pago.                                                                                     |

#### Definición Objeto "EnlaceConfiguracion"

<table data-header-hidden><thead><tr><th>Campo</th><th width="103">Requerido</th><th width="91">Tipo Dato</th><th>Descripción</th></tr></thead><tbody><tr><td>urlRedirect</td><td>No</td><td>Url</td><td>Url donde se redireccionará al cliente después del pago, si no se especifica se usa la del negocio.<br><br>En los parámetros se incluye si la transacción fue exitosa o no. Es importante validar el hash para detectar si los parámetros no han sido modificados en tránsito. Para esto se puede ver el ejemplo de cómo se genera el hash aquí: <a href="../webhook/validar-webhook">Ejemplo Hash</a>.<br><br>El texto al que se le genera el hash es la concatenación de estos parámetros agregados a la URL: <em>idTransaccion + monto + esReal + formaPago + esAprobada + codigoAutorizacion + mensaje</em></td></tr><tr><td>EsMontoEditable</td><td>No</td><td>bool</td><td>Indica que el cliente puede editar el monto de la compra en la interfaz de pago. Normalmente el dato debe ser "falso"</td></tr><tr><td>EsCantidadEditable</td><td>No</td><td>bool</td><td>Indica que el cliente puede editar la cantidad de productos e comprar en la interfaz de pago. </td></tr><tr><td>CantidadPorDefecto</td><td>No</td><td>bool</td><td>Indica la cantidad de producto a adquirir que se muestra al cliente. Si no se especifica el valor por defecto es 1. El monto a cobrar al cliente es cantidad x monto. </td></tr><tr><td>duracionInterfazIntentoMinutos</td><td>No</td><td>entero</td><td>Define cuanto tiempo es válida la interfaz de pago en minutos depues que se le presneto en pantalla al cliente. Si se hace un pago despues de pasado ese tiempo este no se procesará.</td></tr><tr><td>urlRetorno</td><td>No</td><td>Url</td><td>En la interfaz de pago antes que el usuairo ingrese su tarjeta se mustra un boton de regresar. Este parametro especifica a que URL debe apuntar ese botón. Si no se espcificá el botón lleva a la página  anterior.</td></tr><tr><td>emailsNotificacion</td><td>No</td><td>string</td><td>Lista de correos electrónicos divididos por coma a los que se enviará una notificación si la transacción es exitosa.</td></tr><tr><td>urlWebhook</td><td>No</td><td>url</td><td>Url proporcionada por el comercio que se invocará con los datos de la transacción cuando esta sea exitosa. Los webhook son la manera principal que los sistemas del comercio se enteren de una transacción exitosa. Para más información ver la sección<a href="../webhook/definicion-webhook"> Webhook</a>.</td></tr><tr><td>telefonosNotificacion</td><td>No</td><td>string</td><td>Lista de numeros celulares del comercio, dividido por comas donde se notificará por SMS la ejecución exitosa de la transacción</td></tr><tr><td>notificarTransaccionCliente</td><td>Si</td><td>bool</td><td>Indica si Wompi debe enviar una notificación por correo electrónico al cliente después de efectuar una transacción exitosa. El correo del cliente ex capturado en la interfaz de pago.</td></tr></tbody></table>

{% hint style="danger" %}
Aún cuando la urlWebhook y emailsNotificación son opcionales es obligatorio que al menos uno de ellos no sea nulo.
{% endhint %}

#### Descripción objeto "EnlaceVigencia"

Estos campos opcionales son utilizados para definir un período de vigencia del enlace

<table data-header-hidden><thead><tr><th>Campo</th><th width="98">Requerido</th><th width="99">Tipo Dato</th><th>Descripción</th></tr></thead><tbody><tr><td>fechaInicio</td><td>No</td><td>Datetime</td><td>Fecha de inicio de vigencia del enlace</td></tr><tr><td>fechaFin</td><td>No</td><td>Datetime</td><td>Fecha de fin de vigencia del enlace</td></tr></tbody></table>

#### Descripción objeto "EnlaceLimitesDeUso"

Estos campos opcionales permiten definir los límites de uso del enlace en términos de cantidad de usos o consumo de crédito.

| Campo                       | Requerido | Tipo Dato | Descripción                                                              |
| --------------------------- | --------- | --------- | ------------------------------------------------------------------------ |
| cantidadMaximaPagosExitosos | No        | Entero    | Número máximo de veces que el enlace puede ser utilizado.                |
| cantidadMaximaPagosFallidos | No        | Entero    | Número máximo de pagos fallidos que el enlace soporta hasta inactivarse. |

## Objeto de Respuesta

```
{
  "idEnlace": 0,
  "urlQrCodeEnlace": "string",
  "urlEnlace": "string",
  "estaProductivo": true
}
```

### Definición Objeto de Respuesta

| Campo           | Tipo Dato | Descripción                                                                                                                                                                                            |
| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| idEnlace        | Entero    | Identificador único del enlace que se puede utilizar posteriormente para consultar el enlace y la transacción de compra realizada con ese enlace.                                                      |
| urlQrCodeEnlace | Url       | Url para descargar la imagen del QR que redirecciona a la interfaz de pago.                                                                                                                            |
| urlEnlace       | Url       | Url del enlace de pago acortado que redirecciona a la interfaz de pago.                                                                                                                                |
| estaProductivo  | Url       | Indica si el enlace esta actualmente productivo, el enlace esta productivo si el negocio bajo el que se creo esta productivo, esta en desarrollo si el negocio bajo el que se creo esta en desarrollo. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wompi.sv/metodos-api/enlace-de-pago.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.