Crear Transación Compra Bitcoin

POST /TransaccionCompra/Bitcoin

Autenticación: Cuenta Wompi o negocio

Autorización: Requiere permisos adicionales

Objeto de petición:

Campo	Es Requerido	Tipo Dato	Descripción
monto	Sí	decimal	Monto de la transacción en dólares. Debe ser mayor a 0.
emailCliente	Sí	string (max 100)	Correo electrónico del cliente. Debe tener un formato válido.
nombreCliente	Sí	string (max 100)	Nombre del cliente que realizará la compra con bitcoin.
apellidoCliente	Sí	string (max 100)	Apellido del cliente que realizará la compra con bitcoin.
fechaNacimientoCliente	Sí	DateTime	Fecha de nacimiento del cliente.
documentoIdentidadCliente	Sí	string (max 100)	Número de documento de identidad del cliente.
direccionCliente	Sí	string (max 150)	Dirección del cliente.
idRegion	Sí	string (max 2)	Código de país según ISO 3166-1 alpha-2 (ej. SV).
idTerritorio	Sí	string	Código de territorio según ISO 3166-2 (ej. SV-SS).
configuracion	No	Objeto	Configuración de la transacción. Si se omite, se usa la configuración del negocio.
datosAdicionales	No	Objeto (Diccionario)	Pares clave/valor incluidos en reportes y webhooks.
idExterno	No	string (max 50)	Identificador definido por el comercio para la transacción.

Objeto Configuracion

Campo	Es Requerido	Tipo Dato	Descripción
configuracion:emailsNotificacion	No	string	Lista de correos electrónicos separados por comas para notificaciones.
configuracion:urlWebhook	No	string	URL del webhook a invocar después de una transacción exitosa.
configuracion:telefonosNotificacion	No	string	Lista de teléfonos separados por comas para notificaciones.
configuracion:notificarTransaccionCliente	No	bool?	Indica si se enviará un correo al cliente tras un pago exitoso.

Ejemplo petición:

{
  "monto": 0,
  "emailCliente": "[email protected]",
  "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:

Campo	Tipo Dato	Descripción
datosBitcoin	Objeto
Transacción	Objeti

Objeto datosBitcoin

Campo	Tipo Dato	Descripción
datosBitcoin:urlQR	string	URL del código QR para realizar el pago.
datosBitcoin:qrData	string	Dirección del pago para copiar y pegar en lugar de usar el QR.
datosBitcoin:ammountInBitcoins	decimal	Monto por pagar en bitcoins.
datosBitcoin:ammountInDollars	decimal	Monto por pagar en dólares.
datosBitcoin:fechaVencimiento	DateTimeOffset	Fecha y hora en la que expira el código QR.

Objeto Transacción

Campo	Tipo Dato	Descripción
Campo	Tipo Dato	Descripción
idTransaccion	string	Identificador único de la transacción.
esReal	bool	Indica si la transacción fue real según el ambiente del negocio.
esAprobada	bool	Indica si la transacción fue autorizada correctamente.
codigoAutorizacion	string	Código de autorización retornado cuando la transacción es exitosa.
mensaje	string	Mensaje de error retornado cuando la transacción no fue exitosa.
formaPago	int (anulable)	Forma de pago utilizada para realizar la transacción. Las formas pueden ser: · PagoNormal = 0 · Puntos = 1 · Cuotas = 2 · Bitcoin = 3 · QuickPay = 4
monto	decimal	Monto de la transacción en dólares.
idExterno	string	Identificador definido por el comercio para la transacción.

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"
}