# Crear Transacción Compra con Nequi

{% hint style="info" %}
POST /TransaccionCompra/Nequi
{% endhint %}

## Crear una transacción de compra con Nequi

### Ejemplo de petición básica 

En este ejemplo se incluyen solamente los parámetros obligatorios

```
{
	“monto”: 0,
	“dui”: “string”,
	“description”: “string”
}
```

### Ejemplo de respuesta

```
{
  "idTransaccion": "string",
  "esReal": true,
  "mensaje": "string",
  "formaPago": 0,
  "monto": 0,
  "idExterno": "string",
  "datosAdicionales":  {
	"additionalProp1": "string",
   	"additionalProp2": "string",
  	"additionalProp3": "string"
  },
  "resultadoTransaccion": "string",
  "fechaTransaccion": "2026-03-06T17:13:54.577Z"
}

```

### Objeto Completo de Petición 

En la sección anterior se definió una petición básica para crear transacción de compra con Nequi. En esta sección se detallan todas las propiedades opcionales que se pueden incluir.

### JSON Completo

```
{
	"monto": 0,
  "dui": "string",
  "descricion": "string",
  "configuracion": {
	    "emailsNotificacion": "string",
      "urlWebhook": "string",
      "telefonosNotificacion": "string",
      "notificarTransaccionCliente": true
  },
  "datosAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "idExterno": "string"
}

```

### Definición Campos Objeto Root

| Campo            | Es Requerido | Tipo Dato   | Descripción                                                                                                                                                                                                                               |
| ---------------- | ------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| monto            | Si           | double      | El monto que se desea cargar a la tarjeta de crédito en la transacción                                                                                                                                                                    |
| dui              | Si           | string      | El dui de la cuenta Nequi desde la cual se desea realizar el pago                                                                                                                                                                         |
| descripcion      | Si           | string      | La descripción del pago para Nequi                                                                                                                                                                                                        |
| configuracion    | No           | Objeto      | Ver definición de objeto abajo. Solo se necesita si se desea utilizar una configuración diferente a la que esta definida a nivel de negocio.                                                                                              |
| datosAdicionales | No           | Diccionario | Permiten al cliente enviar una lista de Llave/Valor para identificar características adicionales de la transacción. Esta lista de Llave/Valor se entregan al comercio vía el [webhook](https://docs.wompi.sv/webhook/definicion-webhook). |
| idExterno        | No           | string      | Id externo usado como referencia para el sistema que consume el api                                                                                                                                                                       |

### Objeto Configuración

| Campo                       | Es Requerido | Tipo Dato | Descripción                                                                                                                                                                                                                                                                                                          |
| --------------------------- | ------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| emailsNotificacion          | No           | string    | Lista de correos electrónicos divididos por coma a los que se enviará una notificación si la transacción es exitosa.                                                                                                                                                                                                 |
| urlWebhook                  | No           | string    | 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[ Webhook](https://docs.wompi.sv/webhook/definicion-webhook). |
| telefonosNotificacion       | No           | string    | Lista de telefonos dividida por comas a los que se enviará una notificación de esta transacción                                                                                                                                                                                                                      |
| notificarTransaccionCliente | No           | string    | 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.                                                                                                                               |

### Datos Adicionales

Permiten al cliente enviar una lista de Llave/Valor para identificar características adicionales de la transacción. Esta lista de Llave/Valor se entregan al comercio vía el [webhook](https://docs.wompi.sv/webhook/definicion-webhook).

### Objeto de respuesta

| Campo                | Tipo Dato   | Es Requerido                                                                                                                                            |
| -------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| idTransaccion        | string      | Identificador único de la transacción                                                                                                                   |
| esReal               | string      | Verdadero si es un transacción ejecutada en producción, falso si es una transacción en desarrollo. La transacción en desarrollo no se cobra al cliente. |
| mensaje              | string      | Mensaje introducido por el usuario.                                                                                                                     |
| formaPago            | nti         | Indica la forma de pago utilizada                                                                                                                       |
| monto                | decimal     | El monto cobrado en la transacción                                                                                                                      |
| idExterno            | string      | Identificador único dado por el usuario                                                                                                                 |
| datosAdicionales     | Diccionario | Dato adicionales dado por el usuario                                                                                                                    |
| resultadoTransaccion | string      | Indica el resultado de la transacción                                                                                                                   |
| fechaTransaccion     | DateTime    | Fecha en que la transacción fue realizada                                                                                                               |