Library Reference

const engine = new eWallet.Engine(sessionToken, requiredAncillaryInfo, language, uiOptions);

const engine = new eWallet.Engine(sessionToken, null, 'EN', {
  displayMode: 'iframe',
  iframeContainerSelector: '#card-form-container',
  hideLogo: true
});

const requiredAncillaryInfo = {
  billingInfo: {
    details: 'MIN',            // 'MIN' or 'FULL'
    phoneRequired: true,
    emailAddressRequired: true,
    fields: { name: true, countryCode: true, postalCode: true }  // optional, overrides the three settings above
  },
  shippingInfo: { phoneRequired: false, emailAddressRequired: false }
};

const iframeStyleConfig = {
  colorPalette: { primary: '#6c2bd9', background: '#ffffff', text: '#1a1a2e', border: '#d0d0e0', error: '#d92b2b', success: '#1ea672' },
  field: {
    typography: { fontFamily: "'Roboto', sans-serif", fontSize: '15px', fontWeight: '500' },
    borderRadius: '6px',
    states: { focus: { borderColor: '#6c2bd9' }, invalid: { borderColor: '#d92b2b' } }
  },
  layout: { fieldLayout: 'stacked', labelPosition: 'top', fieldSpacing: '12px' },
  branding: { logoUrl: 'https://example.com/logo.svg', logoMaxHeight: '48px', showCardBrandIcon: true, showSecurityBadge: true },
  locale: 'en-GB',
  direction: 'ltr'
};
engine.payBy(['CardPay'], callback, { containerSelector: '#payment-buttons' }, undefined, iframeStyleConfig);

const methods = await engine.checkAvailability();
// e.g. ['CardPay', 'ApplePay', 'GooglePay']

engine.payBy(['CardPay', 'ApplePay'], function(result) {
  if (!result) return; // cancelled
  console.log(result.token);
}, {
  containerSelector: '#payment-buttons'
});

const [data, success] = engine.parseResultToken(result.token);

{
  clientSuccess: boolean;
  clientErrorMessage: any;

  // For PSP charges (CardPay, ApplePay, GooglePay)
  upgChargeResults?: {
    gatewayName: string;
    gatewayReference: string;
    authorizationCode: string;
    amount: number;
    currency: string;
    operationType: string;  // "Charge", "PreAuth", etc.
    operationResultCode: string;  // "Success", "Rejected", etc.
    operationResultDescription: string;  // Human-readable result message
    gatewayResultDescription: string;  // Message from the payment gateway
  };

  // Earlier failed gateway attempts when a fallback chain ran.
  // upgChargeResults always holds the final attempt only (single object, never an array).
  // Absent when the first gateway attempt was the only one.
  failedUpgChargeResults?: Array<OperationResult>;  // same shape as upgChargeResults

  // Summary of the final result, present for every payment method
  selectedPaymentMethod: string;      // "CardPay", "ApplePay", "GooglePay", "PayPal", "BankPay" or "UPI"
  transactionAmount: number;          // standard currency unit
  transactionCurrency: string;        // ISO 4217
  transactionTimestamp: string;       // UTC, ISO 8601
  providerTransactionId: string;      // PSP reference of the final attempt
  providerAuthorizationCode: string;  // may be null
  providerAccountId: string;          // name of the gateway or eWallet account that processed it

  // One entry per processing attempt, primary first, fallbacks after. Abbreviated keys.
  attempts: Array<{
    seq: number;    // 1 for the first attempt
    prv: string;    // provider used, e.g. "CardPay"
    ts: string;     // UTC start time
    suc: boolean;   // attempt succeeded
    fail: string;   // failure reason, null on success
    err: string;    // provider error code, null on success
    dur: number;    // processing time in ms
    fb: boolean;    // this failure triggered a fallback
    req: string;    // sanitized request snapshot (JSON string), may be null
    res: string;    // sanitized response snapshot (JSON string), may be null
    tid: string;    // PSP transaction ID for this attempt
    auth: string;   // authorization code for this attempt
  }>;

  // For direct charges (PayPal, BankPay, UPI)
  directChargeResults?: {
    success: boolean;
    message: string;
    data: object;  // Provider-specific payload, structure varies by payment method
  };

  // For tokenization (TOKENIZE, CHARGE_AND_TOKENIZE, PREAUTH_AND_TOKENIZE)
  tokenAndMaskedCardModel?: {
    token: string;
    bankCard: {
      type: string;      // "Visa", "MasterCard", etc.
      number: string;    // Masked: "************1234"
      expirationMonth: number;
      expirationYear: number;
      nameOnCard: string;
    };
  };
}

const type = engine.getSessionType();
// e.g. 'CHARGE', 'TOKENIZE', 'CHARGE_AND_TOKENIZE'

const provider = engine.getSelectedProviderName();
// e.g. 'CardPay', 'ApplePay'