馃毀 La documentacion de Bloque est谩 en desarrollo
close
Bloque Docs
  • Espa帽ol

      • Manejo de Errores

      Aprende c贸mo manejar errores con gracia en Bloque Payments.

      Tipos de Errores

      Bloque Payments puede devolver diferentes tipos de errores:

      • Errores de validaci贸n: Datos de entrada inv谩lidos
      • Errores de autenticaci贸n: Clave API inv谩lida o revocada
      • Errores de pago: Fallos en el procesamiento de pagos
      • Errores de red: Problemas de conexi贸n

      Manejo de Errores en Frontend

      Usa el callback onError para manejar errores en el componente React:

      import { init, BloqueCheckout } from '@bloque/payments-react';

init({
  publishableKey: 'pk_live_...',
  mode: 'production',
});

function CheckoutPage({ checkoutId }) {
  return (
    <BloqueCheckout
      checkoutId={checkoutId}
      onSuccess={(data) => {
        console.log('隆Pago exitoso!', data.payment_id);
        window.location.href = '/success';
      }}
      onError={(error) => {
        console.error('Pago fallido:', error);

        // Mostrar mensaje amigable para el usuario
        alert(`Pago fallido: ${error}`);
      }}
      onPending={(data) => {
        console.log('Pago pendiente:', data.payment_id);
        window.location.href = '/pending';
      }}
    />
  );
}

      Manejo de Errores en Backend

      Maneja errores al crear checkouts:

      import { Bloque } from '@bloque/payments';
import express from 'express';

const app = express();
app.use(express.json());

const bloque = new Bloque({
  secretKey: process.env.BLOQUE_SECRET_KEY!,
  mode: 'production',
});

app.post('/api/create-checkout', async (req, res) => {
  try {
    const checkout = await bloque.checkout.create({
      name: req.body.name,
      items: req.body.items,
      success_url: req.body.success_url,
    });

    res.json({
      id: checkout.id,
      url: checkout.url,
      clientSecret: checkout.client_secret,
    });
  } catch (error) {
    console.error('Error de checkout:', error);

    if (error.status === 400) {
      return res.status(400).json({
        success: false,
        error: 'Datos de checkout inv谩lidos',
        message: error.message,
      });
    }

    if (error.status === 401) {
      return res.status(401).json({
        success: false,
        error: 'No autorizado',
        message: 'Clave API inv谩lida o revocada',
      });
    }

    res.status(500).json({
      success: false,
      error: 'Error interno del servidor',
    });
  }
});

app.listen(3000);

      C贸digos de Error Comunes

      Errores de Tarjeta

      • card_declined: Tarjeta rechazada
      • insufficient_funds: Fondos insuficientes
      • invalid_card_number: N煤mero de tarjeta inv谩lido
      • invalid_expiry: Fecha de vencimiento inv谩lida
      • invalid_cvv: C贸digo de seguridad inv谩lido

      Errores de 3D Secure

      • 3ds_challenge_cancelled: El usuario cancel贸 la verificaci贸n 3D Secure
      • 3ds_challenge_failed: La autenticaci贸n 3D Secure fall贸

      Errores de Claves API

      • E_KEY_REVOKED: La secret key ha sido revocada
      • E_INVALID_KEY: La secret key es inv谩lida

      Errores Generales

      • invalid_amount: Monto de pago inv谩lido
      • invalid_currency: Moneda no soportada
      • expired_checkout: Sesi贸n de checkout expirada

      Mensajes Amigables para el Usuario

      Proporciona mensajes de error claros y accionables:

      function getErrorMessage(errorCode: string): string {
  switch (errorCode) {
    case 'card_declined':
      return 'Tu tarjeta fue rechazada. Por favor intenta otro m茅todo de pago o contacta a tu banco.';

    case 'insufficient_funds':
      return 'Tu tarjeta tiene fondos insuficientes. Por favor intenta otra tarjeta.';

    case 'invalid_card_number':
      return 'El n煤mero de tarjeta que ingresaste es inv谩lido. Por favor verifica e intenta de nuevo.';

    case 'expired_card':
      return 'Tu tarjeta ha expirado. Por favor usa una tarjeta diferente.';

    case 'invalid_cvv':
      return 'El c贸digo de seguridad (CVV) que ingresaste es inv谩lido.';

    case 'bank_unavailable':
      return 'El banco seleccionado no est谩 disponible temporalmente. Por favor intenta m谩s tarde.';

    case 'expired_checkout':
      return 'La sesi贸n de pago ha expirado. Por favor inicia una nueva.';

    case '3ds_challenge_cancelled':
      return 'La verificaci贸n 3D Secure fue cancelada. Por favor intenta de nuevo.';

    case '3ds_challenge_failed':
      return 'La autenticaci贸n 3D Secure fall贸. Por favor intenta con otra tarjeta o contacta a tu banco.';

    default:
      return 'El pago fall贸. Por favor intenta de nuevo o contacta a soporte.';
  }
}

      Pr贸ximos Pasos