react-native-pos-pagseguro 1.0.0

package/lib/typescript/src/PosPagseguro.nitro.d.ts

@@ -0,0 +1,27 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { CustomError } from './types/exceptions';
+import type { PaymentData, TransactionResult, VoidPayData } from './types/payments';
+import type { Capabilities, SubAcquirer, UserData } from './types/device';
+export interface PosPagseguro extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    getModel(): string;
+    getSerialNumber(): string;
+    getSubAcquirerData(): SubAcquirer | undefined;
+    getUserData(): UserData;
+    reboot(): void;
+    reprintCustomerReceipt(): Promise<number | CustomError>;
+    reprintStablishmentReceipt(): Promise<number | CustomError>;
+    printFromFile(file_path: string, quality: number, bottomPad?: number): Promise<number | CustomError>;
+    printFromBase64(base_64: string, quality: number, bottomPad?: number): Promise<number | CustomError>;
+    abort(): CustomError | undefined;
+    isServiceBusy(): boolean;
+    isAuthenticated(): boolean;
+    hasCapability(capability: Capabilities): boolean;
+    initialize(activation_code: string): void;
+    doPayment(payment_data: PaymentData, process_callback: (event: string) => void): Promise<TransactionResult | CustomError>;
+    voidPayment(void_data: VoidPayData, process_callback: (event: string) => void): Promise<TransactionResult | CustomError>;
+    getLastApprovedTransaction(): TransactionResult | CustomError;
+}
+//# sourceMappingURL=PosPagseguro.nitro.d.ts.map

package/lib/typescript/src/PosPagseguro.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PosPagseguro.nitro.d.ts","sourceRoot":"","sources":["../../../src/PosPagseguro.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1E,MAAM,WAAW,YAAa,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IACrF,QAAQ,IAAI,MAAM,CAAC;IACnB,eAAe,IAAI,MAAM,CAAC;IAC1B,kBAAkB,IAAI,WAAW,GAAG,SAAS,CAAC;IAC9C,WAAW,IAAI,QAAQ,CAAC;IAExB,MAAM,IAAI,IAAI,CAAC;IAEf,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IACxD,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IAE5D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IACrG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IAErG,KAAK,IAAI,WAAW,GAAG,SAAS,CAAC;IAEjC,aAAa,IAAI,OAAO,CAAC;IACzB,eAAe,IAAI,OAAO,CAAC;IAC3B,aAAa,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC;IACjD,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C,SAAS,CAAC,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,iBAAiB,GAAG,WAAW,CAAC,CAAC;IAC1H,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,iBAAiB,GAAG,WAAW,CAAC,CAAC;IAEzH,0BAA0B,IAAI,iBAAiB,GAAG,WAAW,CAAC;CAC/D"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,7 @@
+import PagSeguro from './pag_seguro';
+import { PaymentError, PrintError } from './types/exceptions';
+import { InstallmentTypes, PaymentTypes, VoidType } from './types/payments';
+import type { PaymentData, TransactionResult, VoidPayData } from './types/payments';
+export type { PaymentData, VoidPayData, TransactionResult };
+export { PagSeguro as default, VoidType, PrintError, PaymentError, PaymentTypes, InstallmentTypes, };
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpF,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EAClB,CAAA;AACD,OAAO,EACL,SAAS,IAAI,OAAO,EACpB,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,CAAA"}

package/lib/typescript/src/pag_seguro.d.ts

@@ -0,0 +1,188 @@
+import { type PaymentData, type TransactionResult, type VoidPayData } from "./types/payments";
+import { type SubAcquirer, type UserData } from "./types/device";
+/**
+ * PagSeguro POS SDK para React Native
+ *
+ * Biblioteca de alto desempenho para integração com terminais PagSeguro (Moderninha, Smart, Pro, etc.)
+ * utilizando react-native-nitro-modules para comunicação nativa direta em Swift (iOS) e Kotlin (Android).
+ *
+ * ### Funcionalidades principais
+ * - Inicialização e ativação do terminal
+ * - Pagamentos: Crédito, Débito, Voucher e PIX
+ * - Parcelamento (à vista, lojista sem juros, comprador com juros)
+ * - Cancelamento/estorno de transações
+ * - Consulta da última transação aprovada
+ * - Reimpressão de vias (cliente e estabelecimento)
+ * - Impressão personalizada (arquivo ou Base64)
+ * - Aborto de operações em andamento
+ * - Reinício do terminal
+ * - Consulta de informações do dispositivo e estabelecimento
+ * - Verificação de recursos (impressora, NFC, chip, tarja, etc.)
+ *
+ * ### Tratamento de erros
+ * A maioria dos métodos assíncronos lança exceções específicas:
+ * - {@link PaymentError} → Erros de pagamento, validação ou comunicação
+ * - {@link PrintError}   → Falhas na impressão ou reimpressão
+ * - {@link AbordError}  → Erro ao tentar abortar operação
+ *
+ * ### Exemplo básico de uso
+ * ```ts
+ * await PagSeguro.initialize("SEU_CODIGO");
+ *
+ * const resultado = await PagSeguro.do_payment({
+ *   amount: 1000, // R$ 10.00
+ *   type: PaymentTypes.CREDIT,
+ *   installment_type: InstallmentTypes.SELLER_INSTALLMENT,
+ *   installments: 3,
+ *   print_receipt: true
+ * });
+ *
+ * console.log("NSU:", resultado.transaction_code);
+ * ```
+ *
+ * @module PagSeguro
+ */
+export default class PagSeguro {
+    /**
+     * Inicializa o terminal PagSeguro com o código de ativação fornecido.
+     *
+     * Deve ser chamado antes de qualquer outra operação.
+     * Após a inicialização bem-sucedida, o terminal fica autenticado e pronto para pagamentos.
+     *
+     * @param activation_code Código de ativação do terminal (fornecido pelo PagSeguro)
+     * @throws PaymentError Caso o código seja inválido ou ocorra falha na comunicação
+     *
+     * @example
+     * await PagSeguro.initialize("ABC123456");
+     */
+    static initialize(activation_code: string): void;
+    /**
+     * Reinicia o terminal PagSeguro.
+     */
+    static reboot(): void;
+    /**
+     * Realiza um pagamento no terminal PagSeguro.
+     *
+     * Suporta todos os tipos de pagamento disponíveis (crédito, débito, voucher, PIX)
+     * e diferentes modalidades de parcelamento.
+     *
+     * @param data Dados do pagamento
+     * @param process_callback Callback opcional chamado com mensagens de progresso (ex: "APROXIME, INSIRA OU PASSE O CARTÃO")
+     * @returns Resultado completo da transação aprovada
+     * @throws PaymentError Em caso de erro de validação, rejeição ou falha na comunicação
+     *
+     * @example
+     * const tx = await PagSeguro.do_payment({
+     *   amount: 2500, // R$ 25.00
+     *   type: PaymentTypes.PIX,
+     *   installment_type: InstallmentTypes.NO_INSTALLMENT,
+     *   installments: 1,
+     *   print_receipt: true
+     * });
+     */
+    static do_payment(data: PaymentData, process_callback?: (message: string) => void): Promise<TransactionResult>;
+    /**
+     * Realiza o cancelamento ou estorno de uma transação previamente aprovada.
+     *
+     * Funciona apenas para transações realizadas no mesmo dia (regra PagSeguro).
+     * Para cancelamentos administrativos de dias anteriores, usar o portal.
+     *
+     * @param data Dados necessários para identificar a transação a ser cancelada
+     * @param process_callback Callback opcional com mensagens de progresso
+     * @returns Resultado da operação de cancelamento
+     * @throws PaymentError Em caso de erro de validação ou rejeição
+     */
+    static void_payment(data: VoidPayData, process_callback?: (message: string) => void): Promise<TransactionResult>;
+    /**
+     * Aborta imediatamente qualquer operação em andamento no terminal
+     *
+     * @throws AbordError Caso o aborto não seja possível ou falhe
+     */
+    static abort_current_operation(): void;
+    /**
+     * Obtém os dados da última transação aprovada realizada no terminal.
+     *
+     * @returns Dados completos da transação (valor, NSU, bandeira, etc.)
+     * @throws PaymentError Se não houver transação aprovada ou em caso de erro
+     */
+    static get_last_approved_transaction(): TransactionResult;
+    /**
+     * Reimprime a via do cliente da última transação aprovada.
+     *
+     * @returns Linhas impressas
+     * @throws PrintError Em caso de falha na impressora
+     */
+    static reprint_customer_receipt(): Promise<number>;
+    /**
+     * Reimprime a via do estabelecimento da última transação aprovada.
+     *
+     * @returns Linhas impressas
+     * @throws PrintError Em caso de falha
+     */
+    static reprint_stablishment_receipt(): Promise<number>;
+    /**
+     * Verifica se há usuário autenticado.
+     */
+    static is_authenticated(): boolean;
+    /**
+     * Verifica se o terminal está executando alguma operação no momento.
+     */
+    static is_busy(): boolean;
+    /**
+     * Retorna o modelo do terminal PagSeguro.
+     */
+    static get_model(): string;
+    /**
+     * Retorna os dados do usuário logado no terminal (vendedor).
+     */
+    static get_userdata(): UserData;
+    /**
+     * Retorna o número de série do terminal.
+     */
+    static get_serial_number(): string;
+    /**
+     * Retorna os dados do estabelecimento cadastrado no terminal (subadquirente).
+     */
+    static get_sub_acquirer_data(): SubAcquirer | undefined;
+    /**
+     * Imprime um arquivo de imagem armazenado no dispositivo.
+     *
+     * @param path Caminho completo do arquivo no filesystem
+     * @param quality Qualidade da impressão. Padrão: 1
+     * @param bottomPad Número de linhas em branco ao final. Padrão: 70
+     * @returns Linhas impressas
+     * @throws PrintError Em caso de falha
+     */
+    static print_from_filepath(path: string, quality?: number, bottomPad?: number): Promise<number>;
+    /**
+     * Imprime uma imagem a partir de uma string Base64.
+     * @param base64str String no formato Base64 (sem prefixo data:image/...)
+     * @param quality Qualidade da impressão. Padrão: 1
+     * @param bottomPad Linhas em branco ao final. Padrão: 70
+     * @returns Linhas impressas
+     * @throws PrintError Em caso de falha
+     */
+    static print_from_base64(base64str: string, quality?: number, bottomPad?: number): Promise<number>;
+    /**
+     * Verificação de recursos disponíveis no terminal.
+     *
+     * Permite adaptar a UI conforme os módulos presentes.
+     */
+    static readonly capabilities: {
+        /** Verifica presença de módulo Bluetooth */
+        has_bluetooth(): boolean;
+        /** Verifica leitor de tarja magnética */
+        has_mag(): boolean;
+        /** Verifica leitor de chip (EMV) */
+        has_icc(): boolean;
+        /** Verifica suporte a Contactless/NFC */
+        has_picc(): boolean;
+        /** Verifica presença de impressora térmica */
+        has_printer(): boolean;
+        /** Verifica conexão Ethernet */
+        has_ethernet(): boolean;
+        /** Verifica modem 3G/4G */
+        has_modem(): boolean;
+    };
+}
+//# sourceMappingURL=pag_seguro.d.ts.map

package/lib/typescript/src/pag_seguro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pag_seguro.d.ts","sourceRoot":"","sources":["../../../src/pag_seguro.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4C,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGxI,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAIhD;;OAEG;IACH,MAAM,CAAC,MAAM;IAEb;;;;;;;;;;;;;;;;;;;OAmBG;WACU,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,gBAAgB,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO/H;;;;;;;;;;OAUG;WACU,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,gBAAgB,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOjI;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,IAAI,IAAI;IAMtC;;;;;OAKG;IACH,MAAM,CAAC,6BAA6B,IAAI,iBAAiB;IAMzD;;;;;OAKG;WACU,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC;IAMxD;;;;;OAKG;WACU,4BAA4B,IAAI,OAAO,CAAC,MAAM,CAAC;IAM5D;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,OAAO;IAIlC;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,QAAQ;IAI/B;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,WAAW,GAAG,SAAS;IAIvD;;;;;;;;OAQG;WACU,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,EAAE,SAAS,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpG;;;;;;;OAOG;WACU,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,EAAE,SAAS,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvG;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,YAAY;QACxB,4CAA4C;;QAK5C,yCAAyC;;QAKzC,oCAAoC;;QAKpC,yCAAyC;;QAKzC,8CAA8C;;QAK9C,gCAAgC;;QAKhC,2BAA2B;;MAI9B;CACJ"}

package/lib/typescript/src/types/device.d.ts

@@ -0,0 +1,92 @@
+export type SubAcquirer = {
+    name: string;
+    address: string;
+    city: string;
+    uf: string;
+    country: string;
+    zip_code: string;
+    mcc: string;
+    cnpj_cpf: string;
+    doc_type: string;
+    telephone: string;
+    full_name: string;
+    merchant_id: string;
+};
+export type UserData = {
+    address?: string;
+    city?: string;
+    cnpj_cpf?: string;
+    address_complement?: string;
+    company_name?: string;
+    nick_name?: string;
+    address_state?: string;
+    email?: string;
+};
+declare enum Capabilities {
+    /**
+     * Módulo de leitor de tarja magnética.
+     */
+    MAG = 1,
+    /**
+     * Módulo de leitor de chip.
+     */
+    ICC = 2,
+    /**
+     * Módulo de leitura por aproximação (Contactless).
+     */
+    PICC = 3,
+    /**
+     * Módulo de teclado seguro.
+     */
+    PED = 4,
+    /**
+     * Módulo de teclado externo.
+    */
+    KEYBOARD = 5,
+    /**
+     * Módulo de impressora.
+     */
+    PRINTER = 6,
+    /**
+     * Módulo de bluetooth.
+     */
+    BLUETOOTH = 7,
+    /**
+     * Módulo de caixa registradora.
+     */
+    CASH_BOX = 8,
+    /**
+     * Módulo de tela auxiliar.
+     */
+    CUSTOMER_DISPLAY = 9,
+    /**
+     * Módulo de rede.
+     */
+    ETHERNET = 10,
+    /**
+     * Módulo de leitor de digital.
+     */
+    FINGERPRINT_READER = 11,
+    /**
+     * Módulo de acelerômetro.
+     */
+    G_SENSOR = 12,
+    /**
+     * Módulo de saída HDMI.
+     */
+    HDMI = 13,
+    /**
+     * Módulo de leitor de cartões.
+     */
+    ID_CARD_READER = 14,
+    /**
+     * Módulo de SM.
+     */
+    SM = 15,
+    /**
+     * Módulo de modem.
+     */
+    MODEM = 16
+}
+export { Capabilities };
+//# sourceMappingURL=device.d.ts.map

package/lib/typescript/src/types/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../src/types/device.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAA;AAGD,aAAK,YAAY;IACb;;OAEG;IACH,GAAG,IAAI;IACP;;OAEG;IACH,GAAG,IAAI;IACP;;OAEG;IACH,IAAI,IAAI;IACR;;OAEG;IACH,GAAG,IAAI;IACP;;MAEE;IACF,QAAQ,IAAI;IACZ;;OAEG;IACH,OAAO,IAAI;IACX;;OAEG;IACH,SAAS,IAAI;IACb;;OAEG;IACH,QAAQ,IAAI;IACZ;;OAEG;IACH,gBAAgB,IAAI;IACpB;;OAEG;IACH,QAAQ,KAAK;IACb;;OAEG;IACH,kBAAkB,KAAK;IACvB;;OAEG;IACH,QAAQ,KAAK;IACb;;OAEG;IACH,IAAI,KAAK;IACT;;OAEG;IACH,cAAc,KAAK;IACnB;;OAEG;IACH,EAAE,KAAK;IACP;;OAEG;IACH,KAAK,KAAK;CACb;AAGD,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/lib/typescript/src/types/exceptions.d.ts

@@ -0,0 +1,16 @@
+export type CustomError = {
+    code: string;
+    message: string;
+};
+declare class CustomException extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+export declare class PaymentError extends CustomException {
+}
+export declare class PrintError extends CustomException {
+}
+export declare class AbordError extends CustomException {
+}
+export {};
+//# sourceMappingURL=exceptions.d.ts.map

package/lib/typescript/src/types/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../../src/types/exceptions.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,cAAM,eAAgB,SAAQ,KAAK;IAC/B,IAAI,EAAE,MAAM,CAAC;gBACD,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5C;AAGD,qBAAa,YAAa,SAAQ,eAAe;CAAE;AACnD,qBAAa,UAAW,SAAQ,eAAe;CAAE;AACjD,qBAAa,UAAW,SAAQ,eAAe;CAAE"}

package/lib/typescript/src/types/payments.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Tipos de pagamento disponíveis.
+ */
+declare enum PaymentTypes {
+    /**
+     * Pagamento realizado via cartão de crédito.
+     */
+    CREDIT = 1,
+    /**
+     * Pagamento realizado via cartão de débito.
+     */
+    DEBIT = 2,
+    /**
+     * Pagamento realizado via voucher (vale-refeição, vale-alimentação etc.).
+     */
+    VOUCHER = 3,
+    /**
+     * Pagamento realizado via PIX.
+     */
+    PIX = 5
+}
+/**
+ * Tipos de parcelamento disponíveis.
+ */
+declare enum InstallmentTypes {
+    /**
+     * Pagamento sem parcelamento (à vista).
+     */
+    NO_INSTALLMENT = 1,
+    /**
+     * Parcelamento realizado pelo lojista.
+     */
+    SELLER_INSTALLMENT = 2,
+    /**
+     * Parcelamento realizado pelo comprador (administradora).
+     */
+    BUYER_INSTALLMENT = 3
+}
+/**
+ * Tipo de operação de cancelamento/estorno.
+ */
+declare enum VoidType {
+    /**
+     * Cancelamento de um pagamento já efetuado.
+     */
+    PAYMENT = 1,
+    /**
+     * Cancelamento de um QR Code PIX gerado (antes da leitura/captura).
+     */
+    QRCODE = 2
+}
+export type PaymentData = {
+    /**
+     * Valor em centavos.
+     * Exemplo: 1000 representa R$10,00.
+     */
+    amount: number;
+    /**
+     * Tipo de parcelamento utilizado.
+     * Define se o pagamento será à vista, parcelado pelo lojista ou pela administradora.
+     */
+    installment_type: InstallmentTypes;
+    /**
+     * Número de parcelas.
+     * Exemplo: 3 significa que o pagamento será dividido em 3 vezes.
+     */
+    installments: number;
+    /**
+     * Indica se o comprovante deve ser impresso.
+     * Valor padrão: false.
+     */
+    print_receipt?: boolean;
+    /**
+     * Tipo de pagamento.
+     * Exemplo: crédito, débito, PIX, voucher etc.
+     */
+    type: PaymentTypes;
+    /**
+     * Referência opcional do usuário ou da transação.
+     * Pode ser usada para vincular o pagamento a um pedido ou cliente específico.
+     */
+    user_reference?: number;
+};
+/**
+ * Dados necessários para realizar um cancelamento/estorno.
+ */
+export type VoidPayData = {
+    /**
+     * Código da transação retornado pela adquirente/operadora.
+     */
+    transaction_code: string;
+    /**
+     * Identificador interno da transação no sistema.
+     */
+    transaction_id: string;
+    /**
+     * Indica se o comprovante de cancelamento deve ser impresso.
+     * Valor padrão: false (dependendo da implementação).
+     */
+    print_receipt?: boolean;
+    /**
+     * Tipo de operação que está sendo cancelada.
+     */
+    void_type?: VoidType;
+};
+/**
+ * Nacionalidade da bandeira/emissor do cartão.
+ */
+export declare enum CardIssuerNationality {
+    /**
+     * Informação não disponível ou não aplicável.
+     */
+    UNAVAILABLE = "UNAVAILABLE",
+    /**
+     * Cartão emitido por instituição nacional (ex.: bandeiras brasileiras).
+     */
+    DOMESTIC = "DOMESTIC",
+    /**
+     * Cartão emitido por instituição internacional.
+     */
+    INTERNATIONAL = "INTERNATIONAL"
+}
+/**
+ * Resultado detalhado de uma transação de pagamento.
+ */
+export type TransactionResult = {
+    /** Código da transação retornado pela adquirente. */
+    transaction_code?: string;
+    /** Identificador interno da transação. */
+    transaction_id?: string;
+    /** Data da transação. */
+    date?: string;
+    /** Hora da transação. */
+    time?: string;
+    /** NSU da hospedagem (host NSU). */
+    host_nsu?: string;
+    /** Bandeira do cartão (ex.: Visa, Mastercard). */
+    card_brand?: string;
+    /** BIN (primeiros 6-8 dígitos) do cartão. */
+    bin?: string;
+    /** Nome impresso no cartão. */
+    holder?: string;
+    /** Referência informada pelo usuário/lojista. */
+    user_reference?: string;
+    /** Número de série do terminal/PIN pad utilizado. */
+    terminal_serial_number?: string;
+    /** Valor da transação formatado como string (em reais ou centavos, depende da implementação). */
+    amount?: string;
+    /** Saldo disponível após a transação (para cartões pré-pagos/voucher). */
+    available_balance?: string;
+    /** Aplicação do cartão (ex.: crédito, débito). */
+    card_application?: string;
+    /** Rótulo ou descrição da bandeira. */
+    label?: string;
+    /** Nome do portador do cartão (normalizado). */
+    holder_name?: string;
+    /** Nome extendido do portador (caso disponível). */
+    extended_holder_name?: string;
+    /** Nacionalidade do emissor da bandeira. */
+    card_issuer_nationality?: CardIssuerNationality;
+    /** Modelo do leitor de cartão utilizado. */
+    reader_model?: string;
+    /** NSU da transação. */
+    nsu?: string;
+    /** Código de autorização. */
+    auto_code?: string;
+    /** Quantidade de parcelas da transação. */
+    installments?: number;
+    /** Valor original da transação (antes de descontos ou ajustes). */
+    original_amount?: number;
+    /** Nome do comprador (quando informado). */
+    buyer_name?: string;
+    /** Tipo numérico do pagamento (compatibilidade com enums antigos). */
+    payment_type?: number;
+    /** Descrição do tipo de transação (ex.: "CREDITO", "DEBITO"). */
+    type_transaction?: string;
+    /** Identificação da aplicação no terminal. */
+    app_identification?: string;
+    /** Hash do cartão (tokenização). */
+    card_hash?: string;
+    /** Data de vencimento da pré-autorização. */
+    pre_auto_due_date?: string;
+    /** Valor original da pré-autorização. */
+    pre_auto_original_amount?: string;
+    /** Indicador se o usuário estava cadastrado. */
+    user_registered?: number;
+    /** Valor acumulado (para programas de fidelidade ou carteiras). */
+    accumulated_value?: string;
+    /** Identificação do consumidor. */
+    consumer_identification?: string;
+    /** Saldo atual (após transação). */
+    current_balance?: string;
+    /** Número de telefone do consumidor. */
+    consumer_phone_number?: string;
+    /** IDs de telas do Clube Pag (específico de alguns produtos). */
+    clube_pag_screens_ids?: string;
+    /** Valor parcialmente autorizado em pagamento parcial. */
+    partial_pay_partially_authorized_amount?: string;
+    /** Valor restante em pagamento parcial. */
+    partial_pay_remaining_amount?: string;
+    /** TxId do PIX (identificador da transação PIX). */
+    pix_tx_id_code?: string;
+};
+export { VoidType, PaymentTypes, InstallmentTypes };
+//# sourceMappingURL=payments.d.ts.map

package/lib/typescript/src/types/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../../../src/types/payments.ts"],"names":[],"mappings":"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"}

package/nitro.json

@@ -0,0 +1,16 @@
+{
+  "cxxNamespace": ["pospagseguro"],
+  "ios": {
+    "iosModuleName": "PosPagseguro"
+  },
+  "android": {
+    "androidNamespace": ["pospagseguro"],
+    "androidCxxLibName": "pospagseguro"
+  },
+  "autolinking": {
+    "PosPagseguro": {
+      "kotlin": "PosPagseguro"
+    }
+  },
+  "ignorePaths": ["node_modules"]
+}