SDK error handling

class TokeflowError extends Error {
  code: TokeflowErrorCode; // stable machine-readable code — switch on this
  message: string;         // human-readable explanation (display-safe, may reword)
  httpStatus?: number;     // HTTP status, when the error came from an API call
  requestId?: string;      // request id (req_…) for support, when available
  details?: unknown;       // optional structured context about the failure
}

import { TokeflowError, TokeflowErrorCode } from '@tokeflow_com/bridge-js';

try {
  const token = await tokeflow.cards.tokenize({ card: cardElement });
  // Send token.tokenId to your backend to create the transaction.
} catch (error) {
  if (error instanceof TokeflowError) {
    switch (error.code) {
      case TokeflowErrorCode.ELEMENT_INCOMPLETE:
        showError('Please complete all card fields.');
        break;
      case TokeflowErrorCode.INVALID_CARD:
        showError('Please check your card number.');
        break;
      case TokeflowErrorCode.INVALID_CPF:
        showError('Please check the CPF you entered.');
        break;
      case TokeflowErrorCode.EXPIRED_CARD:
        showError('This card has expired.');
        break;
      case TokeflowErrorCode.UNSUPPORTED_CARD_BRAND:
        showError('This card brand is not supported.');
        break;
      case TokeflowErrorCode.PAYMENT_METHOD_DISABLED:
        showError('That payment method is not available right now.');
        break;
      case TokeflowErrorCode.SESSION_EXPIRED:
        showError('Your session expired. Please refresh and try again.');
        break;
      case TokeflowErrorCode.RATE_LIMITED:
        showError('Too many attempts. Please wait a moment and try again.');
        break;
      case TokeflowErrorCode.NETWORK_ERROR:
      case TokeflowErrorCode.TIMEOUT:
        showError('Network problem. Please try again.');
        break;
      default:
        showError(error.message);
    }

    // Log the transport context for support and monitoring.
    console.error('Tokeflow error', {
      code: error.code,
      httpStatus: error.httpStatus,
      requestId: error.requestId,
      details: error.details,
    });
  } else {
    // Not a TokeflowError — rethrow or handle as a generic failure.
    throw error;
  }
}

import { TokeflowBridge } from '@tokeflow_com/bridge-js';

const tokeflow = new TokeflowBridge({
  publicKey: 'pk_live_mer_your_public_key',
  onError: (error) => {
    // Centralized logging — runs for every TokeflowError the SDK raises.
    logToService({
      code: error.code,
      message: error.message,
      httpStatus: error.httpStatus,
      requestId: error.requestId,
    });
  },
});

import { TokeflowProvider, useTokeflow } from '@tokeflow_com/bridge-js/react';

function App() {
  return (
    <TokeflowProvider
      config={{
        publicKey: 'pk_live_mer_your_public_key',
        onError: (error) => logToService({ code: error.code, requestId: error.requestId }),
      }}
    >
      <Checkout />
    </TokeflowProvider>
  );
}

function Checkout() {
  const { isReady, error } = useTokeflow();

  if (error) return <div role="alert">{error.message}</div>;
  if (!isReady) return <div>Loading…</div>;

  // render your payment form
}