> For the complete documentation index, see [llms.txt](https://docs.wompi.sv/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wompi.sv/metodos-api/crear-transaccion-compra.md).

# Crear Transaccion Compra

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

Autenticación: Cuenta Wompi o negocio

Autorización: Requiere permisos adicionales

### Objeto de petición:

<table><thead><tr><th valign="top">Campo</th><th valign="top">Es Requerido</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">tarjetaCreditoDebido</td><td valign="top">No</td><td valign="top">Objeto</td><td valign="top">Datos de la tarjeta de crédito o débito con la que se realiza la transacción.</td></tr><tr><td valign="top">monto</td><td valign="top">Sí</td><td valign="top">decimal (anulable)</td><td valign="top">Monto de la transacción en dólares. Debe ser mayor a 0.</td></tr><tr><td valign="top">emailCliente</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Correo electrónico del cliente para el envío de notificaciones.</td></tr><tr><td valign="top">nombreCliente</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Nombre del cliente.</td></tr><tr><td valign="top">formaPago</td><td valign="top">No</td><td valign="top">int (anulable)</td><td valign="top"><p>Forma de pago utilizada para realizar la transacción. Las formas pueden ser:</p><p>·       PagoNormal = 0</p><p>·       Puntos = 1</p><p>·       Cuotas = 2</p><p>·       Bitcoin = 3</p><p>·       QuickPay = 4</p></td></tr><tr><td valign="top">configuracion</td><td valign="top">No</td><td valign="top">Objeto</td><td valign="top">Configuración de la transacción. Si se omite, se usa la configuración del negocio.</td></tr><tr><td valign="top">datosAdicionales</td><td valign="top">No</td><td valign="top">Objeto (Diccionario)</td><td valign="top">Pares clave/valor incluidos en reportes y webhooks.</td></tr><tr><td valign="top">cantidadCuotas</td><td valign="top">No</td><td valign="top">int</td><td valign="top">Cantidad de cuotas cuando la forma de pago es en cuotas.</td></tr><tr><td valign="top">idExterno</td><td valign="top">No</td><td valign="top">string (max 50)</td><td valign="top">Identificador definido por el comercio para la transacción.</td></tr><tr><td valign="top">idGrupoTarjetas</td><td valign="top">No</td><td valign="top">string (max 50)</td><td valign="top">Identificador del grupo de tarjetas permitido para la transacción.</td></tr></tbody></table>

### Objeto Configuracion

<table><thead><tr><th valign="top">Campo</th><th valign="top">Es Requerido</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">configuracion:emailsNotificacion</td><td valign="top">No</td><td valign="top">string</td><td valign="top">Lista de correos electrónicos separados por comas para notificaciones de la transacción.</td></tr><tr><td valign="top">configuracion:urlWebhook</td><td valign="top">No</td><td valign="top">string</td><td valign="top">URL del webhook a invocar después de una transacción exitosa.</td></tr><tr><td valign="top">configuracion:telefonosNotificacion</td><td valign="top">No</td><td valign="top">string</td><td valign="top">Lista de teléfonos separados por comas para notificaciones de la transacción.</td></tr><tr><td valign="top">configuracion:notificarTransaccionCliente</td><td valign="top">No</td><td valign="top">bool (anulable)</td><td valign="top">Indica si se enviará un correo al cliente tras un pago exitoso.</td></tr></tbody></table>

### Objeto tarjetaCreditoDebido

<table><thead><tr><th valign="top">Campo</th><th valign="top">Es Requerido</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">tarjetaCreditoDebido:numeroTarjeta</td><td valign="top">Sí</td><td valign="top">string (max 20)</td><td valign="top">Número completo de la tarjeta. Debe ser válido, sin guiones y no iniciar con 3.</td></tr><tr><td valign="top">tarjetaCreditoDebido:cvv</td><td valign="top">Sí</td><td valign="top">string (max 3)</td><td valign="top">Código CVV de la tarjeta. Debe contener exactamente 3 dígitos numéricos.</td></tr><tr><td valign="top">tarjetaCreditoDebido:mesVencimiento</td><td valign="top">Sí</td><td valign="top">int</td><td valign="top">Mes de vencimiento de la tarjeta. Rango válido de 1 a 12.</td></tr><tr><td valign="top">tarjetaCreditoDebido:anioVencimiento</td><td valign="top">Sí</td><td valign="top">int</td><td valign="top">Año de vencimiento de la tarjeta de crédito.</td></tr></tbody></table>

### Ejemplo objeto petición

```
{
  "tarjetaCreditoDebido": {
    "numeroTarjeta": "string",
    "cvv": "string",
    "mesVencimiento": 0,
    "anioVencimiento": 0
  },
  "monto": 0,
  "emailCliente": "user@example.com",
  "nombreCliente": "string",
  "formaPago": 0,
  "configuracion": {
    "emailsNotificacion": "string",
    "urlWebhook": "string",
    "telefonosNotificacion": "string",
    "notificarTransaccionCliente": true
  },
  "datosAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "cantidadCuotas": 1,
  "idExterno": "string",
  "idGrupoTarjetas": "string"
}
```

### Objeto de respuesta:

<table><thead><tr><th valign="top">Campo</th><th valign="top">TIpo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">idTransaccion</td><td valign="top">string</td><td valign="top">Identificador único de la transacción.</td></tr><tr><td valign="top">esReal</td><td valign="top">bool</td><td valign="top">Indica si la transacción de compra fue real; depende del ambiente del negocio.</td></tr><tr><td valign="top">esAprobada</td><td valign="top">bool</td><td valign="top">Indica si la transacción fue autorizada correctamente y el cobro se realizó con éxito.</td></tr><tr><td valign="top">codigoAutorizacion</td><td valign="top">string</td><td valign="top">Código de autorización retornado cuando la transacción es exitosa.</td></tr><tr><td valign="top">mensaje</td><td valign="top">string</td><td valign="top">Mensaje de error retornado cuando la transacción no fue exitosa.</td></tr><tr><td valign="top">formaPago</td><td valign="top">int (anulable)</td><td valign="top"><p>Forma de pago utilizada para realizar la transacción. Las formas pueden ser:</p><p>·       PagoNormal = 0</p><p>·       Puntos = 1</p><p>·       Cuotas = 2</p><p>·       Bitcoin = 3</p><p>·       QuickPay = 4</p></td></tr><tr><td valign="top">monto</td><td valign="top">decimal</td><td valign="top">Monto de la transacción en dólares.</td></tr><tr><td valign="top">idExterno</td><td valign="top">string</td><td valign="top">Identificador definido por el comercio para la transacción (por ejemplo, ID de la orden).</td></tr></tbody></table>

### Objeto Respuesta

```
{
  "idTransaccion": "string",
  "esReal": true,
  "esAprobada": true,
  "codigoAutorizacion": "string",
  "mensaje": "string",
  "formaPago": 0,
  "monto": 0,
  "idExterno": "string"
}
```