Respuestas y callbacks del SDK

Cada SDK de DEUNA devuelve resultados de la interfaz de usuario inmediatos a través de callbacks. El objeto de éxito exacto depende de la experiencia abierta, mientras que los errores, las acciones de cierre, la detección de BIN y la selección de instalación utilizan contratos más pequeños.

Anatomía de la respuestaPreguntar a Athia sobre esto#

Matriz de callbacksPreguntar a Athia sobre esto#

Tipos web y React NativePreguntar a Athia sobre esto#

type ClosedAction = 'userAction' | 'systemAction';

type SdkError = {
  type: string;
  metadata: {
    code: string;
    message: string;
  };
};

type CardBinDetected = {
  cardBin: string;
  cardBrand: string;
};

type InstallmentSelected = {
  cardBin: string;
  installmentPlanOptionId: string;
};

type Dimensions = {
  height: number;
  width: number;
};

Manejar los errores por categoría, manteniendo el código del proveedor o de la experiencia para el diagnóstico de soporte:

const callbacks = {
  onSuccess: async (data) => {
    setCheckoutState('verifying');
    const verifiedOrder = await fetch(`/api/orders/${merchantOrderId}`).then(r => r.json());
    renderFromAuthoritativeState(verifiedOrder);
  },
  onError: ({type, metadata}) => {
    logSafeDiagnostic({type, code: metadata.code});
    showRecoveryMessage(type, metadata.code);
  },
  onClosed: (action, metadata) => {
    restorePaymentMethods();
    if (metadata) logSafeDiagnostic({action, code: metadata.code});
  },
};

Tipos de error nativosPreguntar a Athia sobre esto#

Los SDKs de iOS y Android normalizan los errores de pago en PaymentsError con type, opcional metadata, y un opcional order snapshot.

callbacks.onError = { error ->
    val code = error.metadata?.code ?: "UNKNOWN_ERROR"
    logger.warn("DEUNA SDK error", mapOf("type" to error.type.name, "code" to code))
    renderRecovery(error.type)
}

callbacks.onError = { error in
    let code = error.metadata?.code ?? "UNKNOWN_ERROR"
    logger.warning("DEUNA SDK error: \(error.type) / \(code)")
    renderRecovery(error.type)
}

El éxito es específico de la experienciaPreguntar a Athia sobre esto#

El modelo de pedido evoluciona independientemente del flujo de llamadas de retorno del SDK. Utilice la referencia del punto final de la API para el esquema de backend actual en lugar de copiar campos arbitrarios de un payload del cliente.

Manejo de redimensionamiento incorporadoPreguntar a Athia sobre esto#

const host = document.querySelector('#deuna-widget');

await DeunaSDK.initPaymentWidget({
  orderToken,
  mode: 'target',
  target: '#deuna-widget',
  callbacks: {
    onResize: ({height}) => {
      host.style.height = `${Math.ceil(height)}px`;
    },
    onSuccess: verifyOrder,
    onError: showRecovery,
  },
});

Asegurar una altura mínima estable para el host mientras se carga el iframe, y luego permitir onResize actualizarlo. En pantallas pequeñas, evitar un ancho fijo en píxeles y permitir que el host ocupe todo el espacio de la pantalla.

Lista de verificación para un manejo seguroPreguntar a Athia sobre esto#

• Mantener las funciones de devolución (callback) idempotentes; las señales de ciclo de vida pueden ocurrir cerca de la navegación o los reintentos.
• Deshabilitar la doble presentación durante onPaymentProcessing y mientras submit() esté pendiente.
• Mostrar texto legible por el usuario proveniente de una lista de aprobación. No exponer mensajes brutos del proveedor de forma predeterminada.
• Registrar type, código de error seguro, versión del SDK, entorno y un ID de correlación del comerciante, pero no credenciales ni datos de tarjetas.
• Restaurar el foco al cerrar un modal y anunciar errores a través de una región de notificación accesible.
• Verificar el estado actual del pedido después de un cierre ambiguo, un tiempo de espera o una interrupción de la red.

Contratos de código abiertoPreguntar a Athia sobre esto#

Las formas de devolución se verifican en comparación con las actuales Interfaces de devolución web, Interfaces de devolución React Native, Base de devolución para iOSy Devoluciones compartidas para Android. Utilice la versión instalada por su aplicación cuando se trata de un repositorio. main La rama es más reciente que la versión que has marcado como principal.

Referencias relacionadasPreguntar a Athia sobre esto#