{"_id":"@baaskit/capacitor-payments","name":"@baaskit/capacitor-payments","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.4":{"name":"@baaskit/capacitor-payments","version":"0.1.4","description":"Capacitor plugin for Baaskit payment solutions (SmartPOS Nexgo & Tap-on-Phone): payments, refunds, printing, identity verification and barcode scanning","main":"dist/plugin.cjs.js","module":"dist/esm/index.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","bin":{"cap-payments-setup":"scripts/cap-payments-setup.mjs"},"author":{"name":"Baaskit","email":"luis.chavez@baaskit.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/baaskit/bsk-capacitor-smartpos.git"},"bugs":{"url":"https://github.com/baaskit/bsk-capacitor-smartpos/issues"},"keywords":["capacitor","plugin","native","baaskit","smartpos","nexgo","payments","pos","refund","identity-verification"],"scripts":{"verify":"npm run verify:ios && npm run verify:android && npm run verify:web","verify:ios":"xcodebuild -scheme BaaskitCapacitorSmartpos -destination generic/platform=iOS","verify:android":"cd android && ./gradlew clean build test && cd ..","verify:web":"npm run build","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","eslint":"eslint . --ext ts","prettier":"prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java","swiftlint":"node-swiftlint","docgen":"docgen --api BaaskitSmartPOSPlugin --output-readme README.md --output-json dist/docs.json","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","prepublishOnly":"npm run build"},"devDependencies":{"@capacitor/android":"^8.0.0","@capacitor/core":"^8.0.0","@capacitor/docgen":"^0.3.1","@capacitor/ios":"^8.0.0","@ionic/eslint-config":"^0.4.0","@ionic/prettier-config":"^4.0.0","@ionic/swiftlint-config":"^2.0.0","eslint":"^8.57.1","prettier":"^3.6.2","prettier-plugin-java":"^2.7.7","rimraf":"^6.1.0","rollup":"^4.53.2","swiftlint":"^2.0.0","typescript":"^5.9.3"},"peerDependencies":{"@capacitor/core":">=7.0.0"},"prettier":"@ionic/prettier-config","swiftlint":"@ionic/swiftlint-config","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"_id":"@baaskit/capacitor-payments@0.1.4","gitHead":"353221dbd9ac401a23eeb242ffe0ba57cf32f795","homepage":"https://github.com/baaskit/bsk-capacitor-smartpos#readme","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-8EjHGNjbIO3sVC8mXnUGVw9elihO1okepMsw3EmFKY8Esn11H2uCegVrWBcFiyYKeBlr18Eq3J2QtF1WfNkHRg==","shasum":"3ba173ccfe5c738b09f58a34ebf7356700a48f0e","tarball":"https://registry.npmjs.org/@baaskit/capacitor-payments/-/capacitor-payments-0.1.4.tgz","fileCount":59,"unpackedSize":455389,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC+BOf5HC966z/o4icaABU0wyzByrhyl4cQsJGa167oZAIhAIBMxmXXinR/SMygu73+YyhpV4tnYG3kb1rCt6dDRmPJ"}]},"_npmUser":{"name":"baaskit","email":"patricio.tellez@baaskit.com"},"directories":{},"maintainers":[{"name":"baaskit","email":"patricio.tellez@baaskit.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/capacitor-payments_0.1.4_1781632245920_0.7095049484403806"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-16T17:50:45.788Z","0.1.4":"2026-06-16T17:50:46.098Z","modified":"2026-06-16T17:50:46.303Z"},"maintainers":[{"name":"baaskit","email":"patricio.tellez@baaskit.com"}],"description":"Capacitor plugin for Baaskit payment solutions (SmartPOS Nexgo & Tap-on-Phone): payments, refunds, printing, identity verification and barcode scanning","homepage":"https://github.com/baaskit/bsk-capacitor-smartpos#readme","keywords":["capacitor","plugin","native","baaskit","smartpos","nexgo","payments","pos","refund","identity-verification"],"repository":{"type":"git","url":"git+https://github.com/baaskit/bsk-capacitor-smartpos.git"},"author":{"name":"Baaskit","email":"luis.chavez@baaskit.com"},"bugs":{"url":"https://github.com/baaskit/bsk-capacitor-smartpos/issues"},"license":"MIT","readme":"# @baaskit/capacitor-payments\n\nPlugin de Capacitor para integrar el **SmartPOS Nexgo de Baaskit** desde cualquier app Capacitor (Ionic / React / Vue / Angular), sin escribir código nativo Android.\n\nEl plugin se comunica con la app **Baaskit Oxygen Lite** (`com.baaskit.oxygenlite`) instalada en el terminal, usando los Intent Data Contracts de [`baaskit-common-library`](https://central.sonatype.com/artifact/com.baaskit/baaskit-common-library) — el plugin no reimplementa constantes ni parsing.\n\n> **Solo Android es funcional.** En Web e iOS todos los métodos rechazan como `unavailable` (e `isAvailable()` resuelve `{ available: false }`), de modo que la app consumidora compila para todas las plataformas sin guards especiales.\n\n## Requisitos\n\n- **Baaskit Oxygen Lite** instalada en el SmartPOS Nexgo.\n- Android **minSdk 28** (requisito de Oxygen Lite, superior al default de Capacitor).\n- `@capacitor/core >= 7.0.0`.\n\n## Instalación\n\n```bash\nnpm install @baaskit/capacitor-payments\nnpx cap sync\n```\n\nNo se requiere ninguna configuración nativa adicional: el plugin declara la dependencia de `baaskit-common-library` y el bloque `<queries>` de package visibility (Android 11+) en su propio manifest, y el manifest merger los propaga a la app.\n\n## Integración asistida por IA (skill)\n\nEl paquete incluye un **skill agnóstico al agente**: una guía que cualquier asistente de código (Claude, GitHub Copilot, Kiro, Codex, Cursor, Antigravity…) puede seguir para integrar el plugin con solo pedírselo. Tras instalar, corre una vez en la raíz de tu proyecto:\n\n```bash\nnpx cap-payments-setup\n```\n\nEsto copia el skill a `.baaskit/capacitor-skill/` y crea el archivo de entrada que tu herramienta detecta (`AGENTS.md`, `.github/copilot-instructions.md`, `.kiro/steering/…` o `.claude/skills/…`). Detecta las herramientas presentes; usa `--all` para todas o `--tool claude,copilot` para elegir.\n\nLuego pídele a tu asistente algo como *\"integra los pagos de Baaskit en esta app\"*: te preguntará qué funciones quieres (pago, reembolso, impresión, verificación de identidad) y las implementará por ti. El skill queda versionado en tu repo, así que el equipo entero lo comparte.\n\n## Prompts de ejemplo para tu asistente de IA\n\nCon el plugin instalado, copia y pega cualquiera de estos prompts a tu asistente (Claude, Copilot, Cursor, Kiro, Codex…). Son simples a propósito: el skill se encarga del detalle.\n\n**Pagos**\n- `Integra los pagos de Baaskit SmartPOS en esta app.`\n- `Agrega un botón \"Cobrar\" que cobre el total con Baaskit.`\n- `Quiero cobrar con el terminal Baaskit desde la pantalla de pago.`\n\n**Escanear códigos de barra / QR**\n- `Permíteme escanear códigos de barra con el lector del POS para buscar productos.`\n- `Conecta el botón de escaneo del terminal para agregar productos al carrito.`\n\n**Pago + escaneo (e-commerce)**\n- `En la pantalla de venta: escanear productos con el lector del POS y cobrar el total con Baaskit.`\n\n**Reembolso**\n- `Implementa el reembolso de un pago de Baaskit.`\n\n**Impresión de voucher**\n- `Imprime el comprobante de la última transacción en la impresora del POS.`\n\n**Verificación de identidad**\n- `Agrega verificación de identidad con la cédula usando Baaskit.`\n\n**Pantalla de prueba**\n- `Crea una pantalla demo para probar pago, reembolso, impresión y escaneo de Baaskit.`\n\n> Si tu asistente no encuentra el skill automáticamente, dile:\n> `Sigue la guía en node_modules/@baaskit/capacitor-payments/skill/PLAYBOOK.md`\n\n## Uso\n\nEl mismo código funciona en React, Vue, Angular o JS vanilla — el plugin es framework-agnostic:\n\n```ts\nimport { BaaskitSmartPOS } from '@baaskit/capacitor-payments';\n\n// Verificar disponibilidad antes de operar\nconst { available } = await BaaskitSmartPOS.isAvailable();\n\n// Pago\ntry {\n  const result = await BaaskitSmartPOS.pay({\n    orderNumber: 'ORD-001',\n    amount: 150000, // centavos: CLP $1.500\n    currency: 'CLP',\n    description: 'Compra de producto',\n    source: 'merchant',\n    mode: 'payment',\n    installmentsEnabled: true,\n    acceptPartialAuthorization: false,\n    livemode: true,\n    metadata: { sucursal: 'centro' },\n  });\n  console.log(result.status, result.paymentIntentId, result.jwt);\n} catch (e: any) {\n  // e.code: APP_NOT_INSTALLED | INVALID_INPUT | CANCELLED | BRIDGE_ERROR |\n  //         OPERATION_IN_PROGRESS | <categoría de error Baaskit>\n  // e.data: { httpCode, category, internalCode, message, description, originalRequest }\n  console.error(e.code, e.message, e.data);\n}\n\n// Reembolso\nconst refund = await BaaskitSmartPOS.refund({\n  paymentIntentId: 'pi_123',\n  amount: 150000,\n  channel: 'pos',\n  reason: 'requested_by_customer',\n  description: 'Devolución',\n});\n\n// Verificación de identidad (MRZ + chip NFC)\nconst identity = await BaaskitSmartPOS.verifyIdentity({ includePhoto: false });\nif (identity.verificationSuccess) {\n  console.log(identity.rut, identity.holderName);\n}\n```\n\n## Códigos de error\n\nLos métodos rechazan la promesa con un `code` estable:\n\n| Código | Significado |\n| --- | --- |\n| `APP_NOT_INSTALLED` | Baaskit Oxygen Lite no está instalada o no es resoluble |\n| `INVALID_INPUT` | Falló la validación temprana de campos requeridos (el mensaje indica el campo) |\n| `CANCELLED` | El usuario canceló el flujo |\n| `BRIDGE_ERROR` | Oxygen Lite devolvió `RESULT_CANCELED` sin error estructurado |\n| `OPERATION_IN_PROGRESS` | Ya hay una operación en vuelo (solo se admite una a la vez) |\n| _categoría Baaskit_ | Error estructurado de Baaskit; el detalle viene en `e.data` (`httpCode`, `category`, `internalCode`, `description`, `originalRequest`) |\n\n## Matriz de compatibilidad\n\n| Plugin | `baaskit-common-library` | Oxygen Lite mínima | Capacitor |\n| --- | --- | --- | --- |\n| 0.1.x | 1.2.4 | minSdk 28 | >= 7.0.0 |\n\n## Datos sensibles\n\nEl resultado de `verifyIdentity()` expone `serial` y `mrz` del documento de identidad. **El consumidor es responsable del tratamiento, almacenamiento y protección de esos datos** conforme a la normativa aplicable.\n\n## API\n\n<docgen-index>\n\n* [`isAvailable()`](#isavailable)\n* [`pay(...)`](#pay)\n* [`refund(...)`](#refund)\n* [`print(...)`](#print)\n* [`verifyIdentity(...)`](#verifyidentity)\n* [`getEnvironment()`](#getenvironment)\n* [`payTap2Pay(...)`](#paytap2pay)\n* [`refundTap2Pay(...)`](#refundtap2pay)\n* [`startScan()`](#startscan)\n* [`addListener('barcodeScanned', ...)`](#addlistenerbarcodescanned-)\n* [`removeAllListeners()`](#removealllisteners)\n* [Interfaces](#interfaces)\n* [Type Aliases](#type-aliases)\n\n</docgen-index>\n\n<docgen-api>\n<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->\n\n### isAvailable()\n\n```typescript\nisAvailable() => Promise<{ available: boolean; }>\n```\n\nChecks that Baaskit Oxygen Lite is installed and resolvable on this device.\n\nOn web and iOS it always resolves with `{ available: false }`.\n\n**Returns:** <code>Promise&lt;{ available: boolean; }&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### pay(...)\n\n```typescript\npay(options: PayOptions) => Promise<PaymentResult>\n```\n\nStarts a payment on the SmartPOS by launching Baaskit Oxygen Lite.\n\nRejects with `APP_NOT_INSTALLED`, `INVALID_INPUT`, `CANCELLED`,\n`BRIDGE_ERROR`, `OPERATION_IN_PROGRESS`, or the Baaskit error category.\n\n| Param         | Type                                              |\n| ------------- | ------------------------------------------------- |\n| **`options`** | <code><a href=\"#payoptions\">PayOptions</a></code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#paymentresult\">PaymentResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### refund(...)\n\n```typescript\nrefund(options: RefundOptions) => Promise<RefundResult>\n```\n\nStarts a refund of a previous payment on the SmartPOS.\n\n| Param         | Type                                                    |\n| ------------- | ------------------------------------------------------- |\n| **`options`** | <code><a href=\"#refundoptions\">RefundOptions</a></code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#refundresult\">RefundResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### print(...)\n\n```typescript\nprint(options: PrintOptions) => Promise<PrintResult>\n```\n\nPrints client/merchant vouchers for a transaction on the SmartPOS printer.\n\n| Param         | Type                                                  |\n| ------------- | ----------------------------------------------------- |\n| **`options`** | <code><a href=\"#printoptions\">PrintOptions</a></code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#printresult\">PrintResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### verifyIdentity(...)\n\n```typescript\nverifyIdentity(options?: IdentityVerifyOptions | undefined) => Promise<IdentityVerifyResult>\n```\n\nStarts the identity verification flow (MRZ capture + NFC chip read).\n\nThe promise resolves even when the verification fails on the document side —\nalways check `verificationSuccess` on the result.\n\n| Param         | Type                                                                    |\n| ------------- | ----------------------------------------------------------------------- |\n| **`options`** | <code><a href=\"#identityverifyoptions\">IdentityVerifyOptions</a></code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#identityverifyresult\">IdentityVerifyResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### getEnvironment()\n\n```typescript\ngetEnvironment() => Promise<{ backend: 'smartpos' | 'taptophone' | 'none'; }>\n```\n\nResolves which Baaskit payment app this device can transact with. Used by the\nunified `BaaskitPOS` facade to route to the right backend.\n\n**Returns:** <code>Promise&lt;{ backend: 'smartpos' | 'taptophone' | 'none'; }&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### payTap2Pay(...)\n\n```typescript\npayTap2Pay(options: Record<string, unknown>) => Promise<Record<string, unknown>>\n```\n\nPayment via the Tap2Pay (SoftPOS) app. Takes a canonical (SoftPOS-shaped)\nrequest and returns the decoded SoftPOS response. Used by the `BaaskitPOS`\nfacade; prefer that facade over calling this directly.\n\n| Param         | Type                                                             |\n| ------------- | ---------------------------------------------------------------- |\n| **`options`** | <code><a href=\"#record\">Record</a>&lt;string, unknown&gt;</code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#record\">Record</a>&lt;string, unknown&gt;&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### refundTap2Pay(...)\n\n```typescript\nrefundTap2Pay(options: Record<string, unknown>) => Promise<Record<string, unknown>>\n```\n\nRefund via the Tap2Pay (SoftPOS) app. See {@link payTap2Pay}.\n\n| Param         | Type                                                             |\n| ------------- | ---------------------------------------------------------------- |\n| **`options`** | <code><a href=\"#record\">Record</a>&lt;string, unknown&gt;</code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#record\">Record</a>&lt;string, unknown&gt;&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### startScan()\n\n```typescript\nstartScan() => Promise<void>\n```\n\nSoftware-triggers the SmartPOS 2D barcode/QR scanner. The physical scan button\nalso works without calling this. SmartPOS only; resolves as a no-op on web/iOS.\n\nDecoded codes are delivered through the `barcodeScanned` listener.\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### addListener('barcodeScanned', ...)\n\n```typescript\naddListener(eventName: 'barcodeScanned', listenerFunc: (result: BarcodeScanResult) => void) => Promise<PluginListenerHandle>\n```\n\nSubscribes to barcodes/QR codes decoded by the SmartPOS 2D scanner (physical\nbutton or {@link startScan}). Events are delivered only while the app is in the\nforeground. SmartPOS only — the listener never fires on web/iOS.\n\n| Param              | Type                                                                                 |\n| ------------------ | ------------------------------------------------------------------------------------ |\n| **`eventName`**    | <code>'barcodeScanned'</code>                                                        |\n| **`listenerFunc`** | <code>(result: <a href=\"#barcodescanresult\">BarcodeScanResult</a>) =&gt; void</code> |\n\n**Returns:** <code>Promise&lt;<a href=\"#pluginlistenerhandle\">PluginListenerHandle</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### removeAllListeners()\n\n```typescript\nremoveAllListeners() => Promise<void>\n```\n\nRemoves all listeners registered for this plugin.\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### Interfaces\n\n\n#### PaymentResult\n\nMirror of the native `TerminalCheckoutResponse`.\n\n| Prop                         | Type                                                            | Description                                                                                                                                      |\n| ---------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |\n| **`paymentIntentId`**        | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantId`**             | <code>string</code>                                             |                                                                                                                                                  |\n| **`description`**            | <code>string</code>                                             |                                                                                                                                                  |\n| **`amount`**                 | <code>number</code>                                             | Amount in cents.                                                                                                                                 |\n| **`currency`**               | <code>string</code>                                             |                                                                                                                                                  |\n| **`status`**                 | <code>string</code>                                             |                                                                                                                                                  |\n| **`createdAt`**              | <code>string</code>                                             | Creation timestamp (ISO format).                                                                                                                 |\n| **`authorizationCode`**      | <code>string</code>                                             |                                                                                                                                                  |\n| **`orderNumber`**            | <code>string</code>                                             |                                                                                                                                                  |\n| **`livemode`**               | <code>boolean</code>                                            |                                                                                                                                                  |\n| **`metadata`**               | <code><a href=\"#record\">Record</a>&lt;string, string&gt;</code> | Metadata parsed back into an object.                                                                                                             |\n| **`rrn`**                    | <code>string</code>                                             | Retrieval reference number.                                                                                                                      |\n| **`terminalSerialnumber`**   | <code>string</code>                                             |                                                                                                                                                  |\n| **`tipPercentages`**         | <code>number</code>                                             |                                                                                                                                                  |\n| **`installmentCount`**       | <code>number</code>                                             |                                                                                                                                                  |\n| **`installmentType`**        | <code>string</code>                                             |                                                                                                                                                  |\n| **`installmentAmount`**      | <code>number</code>                                             | Amount of each installment, in cents.                                                                                                            |\n| **`cardBrand`**              | <code>string</code>                                             |                                                                                                                                                  |\n| **`cardFundingType`**        | <code>string</code>                                             | Funding type (credit/debit).                                                                                                                     |\n| **`cardEntryMode`**          | <code>string</code>                                             |                                                                                                                                                  |\n| **`cardBin`**                | <code>number</code>                                             |                                                                                                                                                  |\n| **`cardLastFourDigit`**      | <code>string</code>                                             |                                                                                                                                                  |\n| **`cardAid`**                | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantIdentification`** | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantAddress`**        | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantName`**           | <code>string</code>                                             |                                                                                                                                                  |\n| **`jwt`**                    | <code>string</code>                                             | Signed JWT issued by the SmartPOS backend. Validates response authenticity and can be used as a bearer token to call other Baaskit backend APIs. |\n\n\n#### PayOptions\n\n| Prop                             | Type                                                             | Description                                                                                     |\n| -------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |\n| **`orderNumber`**                | <code>string</code>                                              | Order identifier.                                                                               |\n| **`amount`**                     | <code>number</code>                                              | Amount in cents, exactly as the native contract expects (e.g. CLP 1.500 → 1500).                |\n| **`currency`**                   | <code>string</code>                                              | ISO currency code, e.g. `\"CLP\"`.                                                                |\n| **`description`**                | <code>string</code>                                              | Transaction description.                                                                        |\n| **`source`**                     | <code>string</code>                                              | Source identifier, e.g. `\"merchant\"`.                                                           |\n| **`mode`**                       | <code>string</code>                                              | Operation mode, e.g. `\"payment\"`.                                                               |\n| **`installmentsEnabled`**        | <code>boolean</code>                                             | Enable installments.                                                                            |\n| **`acceptPartialAuthorization`** | <code>boolean</code>                                             | Accept partial authorization.                                                                   |\n| **`livemode`**                   | <code>boolean</code>                                             | Production mode flag.                                                                           |\n| **`metadata`**                   | <code><a href=\"#record\">Record</a>&lt;string, string&gt;</code>  | Additional metadata. Serialized to a JSON string internally — never build JSON strings by hand. |\n| **`locationId`**                 | <code>string</code>                                              | Location identifier.                                                                            |\n| **`tipPercentages`**             | <code>number</code>                                              | Tip percentage.                                                                                 |\n| **`items`**                      | <code>unknown[]</code>                                           | Item details. Serialized to a JSON array internally.                                            |\n| **`payer`**                      | <code><a href=\"#record\">Record</a>&lt;string, unknown&gt;</code> | Payer details. Serialized to a JSON object internally.                                          |\n| **`completeBridgeTransaction`**  | <code>boolean</code>                                             | Bridge transaction flag.                                                                        |\n\n\n#### RefundResult\n\nMirror of the native `RefundResponse`.\n\n| Prop                         | Type                                                            | Description                                                                                                                                      |\n| ---------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |\n| **`id`**                     | <code>string</code>                                             |                                                                                                                                                  |\n| **`amount`**                 | <code>number</code>                                             | Refunded amount in cents.                                                                                                                        |\n| **`channel`**                | <code>string</code>                                             |                                                                                                                                                  |\n| **`createdAt`**              | <code>string</code>                                             |                                                                                                                                                  |\n| **`currency`**               | <code>string</code>                                             |                                                                                                                                                  |\n| **`expiredAt`**              | <code>string</code>                                             |                                                                                                                                                  |\n| **`paymentIntentId`**        | <code>string</code>                                             |                                                                                                                                                  |\n| **`reason`**                 | <code>string</code>                                             |                                                                                                                                                  |\n| **`status`**                 | <code>string</code>                                             |                                                                                                                                                  |\n| **`statusReason`**           | <code>string</code>                                             |                                                                                                                                                  |\n| **`terminalSerialnumber`**   | <code>string</code>                                             |                                                                                                                                                  |\n| **`description`**            | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantId`**             | <code>string</code>                                             |                                                                                                                                                  |\n| **`authorizationCode`**      | <code>string</code>                                             |                                                                                                                                                  |\n| **`metadata`**               | <code><a href=\"#record\">Record</a>&lt;string, string&gt;</code> | Metadata parsed back into an object.                                                                                                             |\n| **`updatedAt`**              | <code>string</code>                                             |                                                                                                                                                  |\n| **`rrn`**                    | <code>string</code>                                             |                                                                                                                                                  |\n| **`jwt`**                    | <code>string</code>                                             | Signed JWT issued by the SmartPOS backend. Validates response authenticity and can be used as a bearer token to call other Baaskit backend APIs. |\n| **`merchantName`**           | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantAddress`**        | <code>string</code>                                             |                                                                                                                                                  |\n| **`merchantIdentification`** | <code>string</code>                                             |                                                                                                                                                  |\n| **`cardFundingType`**        | <code>string</code>                                             |                                                                                                                                                  |\n| **`aid`**                    | <code>string</code>                                             |                                                                                                                                                  |\n| **`cardBrand`**              | <code>string</code>                                             |                                                                                                                                                  |\n| **`cardLastFourDigits`**     | <code>string</code>                                             |                                                                                                                                                  |\n\n\n#### RefundOptions\n\n| Prop                  | Type                                                            | Description                                                  |\n| --------------------- | --------------------------------------------------------------- | ------------------------------------------------------------ |\n| **`paymentIntentId`** | <code>string</code>                                             | ID of the original payment intent.                           |\n| **`amount`**          | <code>number</code>                                             | Amount to refund, in cents.                                  |\n| **`channel`**         | <code>string</code>                                             | Channel identifier.                                          |\n| **`reason`**          | <code>string</code>                                             | Refund reason.                                               |\n| **`description`**     | <code>string</code>                                             | Refund description.                                          |\n| **`metadata`**        | <code><a href=\"#record\">Record</a>&lt;string, string&gt;</code> | Additional metadata. Serialized to a JSON string internally. |\n\n\n#### PrintResult\n\nMirror of the native `PrintResponse`.\n\n| Prop                             | Type                |\n| -------------------------------- | ------------------- |\n| **`clientVoucherPrintStatus`**   | <code>string</code> |\n| **`merchantVoucherPrintStatus`** | <code>string</code> |\n\n\n#### PrintOptions\n\n| Prop                         | Type                 | Description                                                                 |\n| ---------------------------- | -------------------- | --------------------------------------------------------------------------- |\n| **`clientVoucher`**          | <code>boolean</code> | Print the client voucher.                                                   |\n| **`merchantVoucher`**        | <code>boolean</code> | Print the merchant voucher.                                                 |\n| **`installmentCount`**       | <code>number</code>  | Installment count of the transaction.                                       |\n| **`cardBrand`**              | <code>string</code>  | Card brand.                                                                 |\n| **`cardFundingType`**        | <code>string</code>  | Funding type (credit/debit).                                                |\n| **`cardEntryMode`**          | <code>string</code>  | Card entry mode.                                                            |\n| **`cardBin`**                | <code>string</code>  | Card BIN.                                                                   |\n| **`cardLastFourDigit`**      | <code>string</code>  | Last four digits of the card.                                               |\n| **`cardAid`**                | <code>string</code>  | Card AID.                                                                   |\n| **`merchantIdentification`** | <code>string</code>  | Merchant identification.                                                    |\n| **`merchantAddress`**        | <code>string</code>  | Merchant address.                                                           |\n| **`merchantName`**           | <code>string</code>  | Merchant name. If omitted, the terminal's configured merchant name is used. |\n| **`rrn`**                    | <code>string</code>  | Retrieval reference number.                                                 |\n| **`amount`**                 | <code>number</code>  | Transaction amount in cents.                                                |\n| **`currency`**               | <code>string</code>  | ISO currency code.                                                          |\n| **`createdAt`**              | <code>string</code>  | Creation timestamp (ISO format).                                            |\n| **`authorizationCode`**      | <code>string</code>  | Authorization code.                                                         |\n| **`orderNumber`**            | <code>string</code>  | Order number.                                                               |\n| **`terminalSerialnumber`**   | <code>string</code>  | Terminal serial number.                                                     |\n| **`paymentIntentId`**        | <code>string</code>  | Payment intent ID. If provided, Oxygen Lite validates that it is printable. |\n\n\n#### IdentityVerifyResult\n\nMirror of the native `IdentityVerificationResponse`.\n\nNote: `serial` and `mrz` are sensitive document data — the consumer is\nresponsible for their proper handling and storage.\n\n| Prop                      | Type                 | Description                                                                                                        |\n| ------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| **`verificationSuccess`** | <code>boolean</code> | Whether the verification succeeded. Check this flag — a resolved promise does not imply a successful verification. |\n| **`rut`**                 | <code>string</code>  |                                                                                                                    |\n| **`holderName`**          | <code>string</code>  |                                                                                                                    |\n| **`documentType`**        | <code>string</code>  |                                                                                                                    |\n| **`serial`**              | <code>string</code>  |                                                                                                                    |\n| **`mrz`**                 | <code>string</code>  |                                                                                                                    |\n| **`errorCode`**           | <code>string</code>  |                                                                                                                    |\n| **`errorMessage`**        | <code>string</code>  |                                                                                                                    |\n\n\n#### IdentityVerifyOptions\n\n| Prop                 | Type                 | Description                                                                                   | Default            |\n| -------------------- | -------------------- | --------------------------------------------------------------------------------------------- | ------------------ |\n| **`includePhoto`**   | <code>boolean</code> | If `true`, the chip read includes the holder photo (DG2). Adds a few seconds to the NFC read. | <code>false</code> |\n| **`skipOnboarding`** | <code>boolean</code> | If `true`, skips the onboarding screen and starts directly with the MRZ capture.              | <code>false</code> |\n\n\n#### PluginListenerHandle\n\n| Prop         | Type                                      |\n| ------------ | ----------------------------------------- |\n| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |\n\n\n#### BarcodeScanResult\n\nResult of a barcode/QR code decoded by the SmartPOS 2D scanner.\n\n| Prop          | Type                | Description                                                       |\n| ------------- | ------------------- | ----------------------------------------------------------------- |\n| **`barcode`** | <code>string</code> | The decoded code content (e.g. an EAN-13 like `\"7501001164058\"`). |\n| **`length`**  | <code>number</code> | Length of the decoded content.                                    |\n\n\n### Type Aliases\n\n\n#### Record\n\nConstruct a type with a set of properties K of type T\n\n<code>{\r [P in K]: T;\r }</code>\n\n</docgen-api>\n","readmeFilename":"README.md","_rev":"1-d2b06ec4451857e1f0367c91bab372ac"}