Crear Transaccion Compra Quick-Pay

Permite generar los datos para hacer un cobro con quick pay

POST /TransaccionCompra/Quick-pay

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.
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 (anulable)	Indica si se enviará un correo al cliente tras un pago exitoso.

Ejemplo Petición:

{
  "monto": 0,
  "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
datosQuickPay	Objeto
Transacción	Objeto

Objeto DatosQuickPay

Campo	Tipo Dato	Descripción
datosQuickPay:urlQR	string	URL del código QR para realizar el pago QuickPay.
datosQuickPay: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:

{
  "datosQuickPay": {
    "urlQR": "string",
    "fechaVencimiento": "2026-03-10T16:26:15.928Z"
  },
  "idTransaccion": "string",
  "esReal": true,
  "esAprobada": true,
  "codigoAutorizacion": "string",
  "mensaje": "string",
  "formaPago": 0,
  "monto": 0,
  "idExterno": "string"
}