Skip to main content
DEUNA (deuna.com) es un orquestador de pagos. Fire spark cobra todos los métodos de DEUNA con su Payment Widget: el widget de DEUNA cobra, Fire spark crea la orden en DEUNA con tu llave privada, y el estado que Fire spark lee de DEUNA es el que cuenta.

Requisitos

  • Una cuenta de comercio en DEUNA con los procesadores que necesites activos, y sus llaves de API pública y privada por entorno (sandbox y producción están separados).
  • El SDK de DEUNA en tu canal: @deuna/react-native-sdk (React Native 0.73+, Expo SDK 50+ con development build) o el Web SDK de DEUNA. Fire spark no lo incluye; tu canal abre el widget.
  • Procesadores configurados para capturar al autorizar. El flujo por widget no tiene un paso de captura aparte.

Activarlo

  1. En el dashboard, abre tu comercio, ve a Payments y crea un pago con el proveedor DEUNA y el método que necesites (CARD, WALLET o BANK_TRANSFER).
  2. En Connection Settings, completa:
  1. En el DEUNA Admin, configura la URL del webhook https://<host-de-tu-api>/api/webhooks/payments/deuna en cada entorno.

Usarlo en el SDK

Tu canal implementa un bridge pequeño que abre el widget de DEUNA y resuelve con el primer callback final. El adaptador hace el resto: pide a Fire spark el token de la orden DEUNA, abre el widget con el bridge y confirma el estado.
Inicializa el SDK de DEUNA con publicApiKey: payment.config.public_key y el entorno del pago. Para Mercado Pago en React Native, pasa un InAppBrowserAdapter (@deuna/react-native-in-app-browser) al inicializar el SDK de DEUNA. En web, carga el Web SDK de DEUNA desde su CDN e implementa el mismo bridge con DeunaSDK.initPaymentWidget. payIntent({ payment }) crea un tender real. Para dividir DEUNA con otro método, llama a order.setTenders con una asignación y luego a payIntent(). Ver Usar pagos en el SDK.

Qué pasa con cada callback del widget

Endpoints del storefront

El adaptador los llama con createDeunaWidgetApi. Usan la sesión del storefront.

Qué ve el cliente

El widget de DEUNA, en español por defecto (language: "es"). La metadata del resultado incluye attempt_reference y provider (order_token, processor, status, transaction_id). Los details de billetera registran el procesador y la referencia de DEUNA; los de tarjeta no traen datos de la tarjeta. No hay voucher.

Webhooks

POST /api/webhooks/payments/deuna actualiza el tender cuando DEUNA avisa un cambio de estado. Con Webhook signature configurado, X-Signature debe ser el HMAC-SHA256 en Base64 del body crudo con ese secreto; si no, el aviso se rechaza (401). Fire spark siempre relee la orden en DEUNA con tu llave privada antes de cambiar el tender, así que un aviso sin firma solo cuenta cuando DEUNA lo confirma.

Reembolsos

Fire spark no reembolsa pagos DEUNA. El reverso de un tender DEUNA pagado queda para revisión manual: reembólsalo desde el DEUNA Admin. DaviPlata no admite reembolsos por DEUNA: el reintegro se pide a DaviPlata de forma manual.

Errores comunes

Compatibilidad