# Crear Transación Compra Bitcoin

{% hint style="info" %}
POST /TransaccionCompra/Bitcoin
{% 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">monto</td><td valign="top">Sí</td><td valign="top">decimal</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 (max 100)</td><td valign="top">Correo electrónico del cliente. Debe tener un formato válido.</td></tr><tr><td valign="top">nombreCliente</td><td valign="top">Sí</td><td valign="top">string (max 100)</td><td valign="top">Nombre del cliente que realizará la compra con bitcoin.</td></tr><tr><td valign="top">apellidoCliente</td><td valign="top">Sí</td><td valign="top">string (max 100)</td><td valign="top">Apellido del cliente que realizará la compra con bitcoin.</td></tr><tr><td valign="top">fechaNacimientoCliente</td><td valign="top">Sí</td><td valign="top">DateTime</td><td valign="top">Fecha de nacimiento del cliente.</td></tr><tr><td valign="top">documentoIdentidadCliente</td><td valign="top">Sí</td><td valign="top">string (max 100)</td><td valign="top">Número de documento de identidad del cliente.</td></tr><tr><td valign="top">direccionCliente</td><td valign="top">Sí</td><td valign="top">string (max 150)</td><td valign="top">Dirección del cliente.</td></tr><tr><td valign="top">idRegion</td><td valign="top">Sí</td><td valign="top">string (max 2)</td><td valign="top">Código de país según ISO 3166-1 alpha-2 (ej. SV).</td></tr><tr><td valign="top">idTerritorio</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Código de territorio según ISO 3166-2 (ej. SV-SS).</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">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></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.</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.</td></tr><tr><td valign="top">configuracion:notificarTransaccionCliente</td><td valign="top">No</td><td valign="top">bool?</td><td valign="top">Indica si se enviará un correo al cliente tras un pago exitoso.</td></tr></tbody></table>

### Ejemplo petición:

```
{
  "monto": 0,
  "emailCliente": "user@example.com",
  "nombreCliente": "string",
  "apellidoCliente": "string",
  "fechaNacimientoCliente": "2026-03-10T16:18:35.786Z",
  "documentoIdentidadCliente": "string",
  "direccionCliente": "string",
  "idRegion": "string",
  "idTerritorio": "string",
  "configuracion": {
    "emailsNotificacion": "string",
    "urlWebhook": "string",
    "telefonosNotificacion": "string",
    "notificarTransaccionCliente": true
  },
  "datosAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "idExterno": "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">datosBitcoin</td><td valign="top">Objeto</td><td valign="top"> </td></tr><tr><td valign="top">Transacción</td><td valign="top"> Objeti</td><td valign="top"> </td></tr></tbody></table>

### Objeto datosBitcoin

<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">datosBitcoin:urlQR</td><td valign="top">string</td><td valign="top">URL del código QR para realizar el pago.</td></tr><tr><td valign="top">datosBitcoin:qrData</td><td valign="top">string</td><td valign="top">Dirección del pago para copiar y pegar en lugar de usar el QR.</td></tr><tr><td valign="top">datosBitcoin:ammountInBitcoins</td><td valign="top">decimal</td><td valign="top">Monto por pagar en bitcoins.</td></tr><tr><td valign="top">datosBitcoin:ammountInDollars</td><td valign="top">decimal</td><td valign="top">Monto por pagar en dólares.</td></tr><tr><td valign="top">datosBitcoin:fechaVencimiento</td><td valign="top">DateTimeOffset</td><td valign="top">Fecha y hora en la que expira el código QR.</td></tr></tbody></table>

### Objeto Transacción

<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">Campo</td><td valign="top">Tipo Dato</td><td valign="top">Descripción</td></tr><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 fue real según el 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.</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.</td></tr></tbody></table>

### Ejemplo Respuesta:

```
{
  "datosBitcoin": {
    "urlQR": "string",
    "qrData": "string",
    "ammountInBitcoins": 0,
    "ammountInDollars": 0,
    "fechaVencimiento": "2026-03-10T16:18:35.787Z"
  },
  "idTransaccion": "string",
  "esReal": true,
  "esAprobada": true,
  "codigoAutorizacion": "string",
  "mensaje": "string",
  "formaPago": 0,
  "monto": 0,
  "idExterno": "string"
}
```