# VivaWallet SDK (Community)

## Docs

- [VivaWallet Node SDK: Authentication and Credentials](https://vivawallet-sdk-docs.mintlify.app/authentication.md): Supply your VivaWallet OAuth 2.0 and Basic Auth credentials once at construction time and let the SDK handle all token fetching and header signing.
- [VivaISV Client: Multi-Merchant ISV API Integration](https://vivawallet-sdk-docs.mintlify.app/clients/isv.md): The VivaISV client lets Independent Software Vendors manage merchant payments, connected accounts, and POS terminals across multiple merchants.
- [Marketplace Client: Multi-Seller Platform Integration](https://vivawallet-sdk-docs.mintlify.app/clients/marketplace.md): The Marketplace client enables platform operators to manage sellers, payment orders, transactions, and fund transfers across their marketplace.
- [Vivawallet Client: Standard Merchant API Integration](https://vivawallet-sdk-docs.mintlify.app/clients/vivawallet.md): The Vivawallet client covers payments, transactions, webhooks, fees, bank transfers, wallets, data services, POS helpers, and more for standard merchants.
- [Bank Transfers and Account Linking with VivaWallet](https://vivawallet-sdk-docs.mintlify.app/guides/bank-transfers.md): Link bank accounts, retrieve transfer options, create fee commands, and execute outgoing bank transfers using the bankTransfers module.
- [Cloud Terminal and Standard POS Helpers](https://vivawallet-sdk-docs.mintlify.app/guides/cloud-terminal.md): Use Cloud Terminal tokens and the standard Vivawallet POS helper modules to search devices, initiate POS transactions, retrieve sessions, and abort sessions.
- [Manage ISV Connected Merchant Accounts](https://vivawallet-sdk-docs.mintlify.app/guides/isv-connected-accounts.md): Onboard and manage connected merchant accounts under your VivaWallet ISV account using the connectedAccounts module of the VivaISV client.
- [ISV Payment Orders: Create and Cancel on Behalf of Merchants](https://vivawallet-sdk-docs.mintlify.app/guides/isv-payments.md): Create and cancel VivaWallet payment orders on behalf of your connected merchants using the VivaISV payments module and your ISV credentials.
- [ISV POS Terminal Management and Sessions](https://vivawallet-sdk-docs.mintlify.app/guides/isv-pos.md): Manage POS terminals and initiate Cloud Terminal sessions for connected merchants using the pos module of the VivaISV client and your ISV credentials.
- [Marketplace Payment Orders: Accept Payments for Sellers](https://vivawallet-sdk-docs.mintlify.app/guides/marketplace-payments.md): Create and retrieve Marketplace payment orders for your platform. Collect buyer payments and route funds to sellers using the payments module.
- [Manage Marketplace Seller Accounts and Payout Settings](https://vivawallet-sdk-docs.mintlify.app/guides/marketplace-sellers.md): Onboard, update, and configure connected seller accounts on your marketplace platform using the Marketplace sellers module and connected account types.
- [Distribute Payments to Marketplace Sellers via Transfers](https://vivawallet-sdk-docs.mintlify.app/guides/marketplace-transfers.md): Create fund transfers and transfer reversals between your marketplace platform and seller accounts using the Marketplace transfers module.
- [Create and Manage Payments via VivaWallet SmartCheckout](https://vivawallet-sdk-docs.mintlify.app/guides/payments.md): Create payment orders, redirect customers to SmartCheckout, retrieve fees, and manage the full order lifecycle using the VivaWallet payments and fees modules.
- [Retrieve and Manage VivaWallet Payment Transactions](https://vivawallet-sdk-docs.mintlify.app/guides/transactions.md): Retrieve transaction details, cancel transactions, issue refunds, create card tokens, and run advanced transaction operations through the transactions module.
- [Manage VivaWallet Merchant Wallets and Balance Transfers](https://vivawallet-sdk-docs.mintlify.app/guides/wallets.md): Retrieve merchant wallet balances, access legacy wallet data, and transfer funds between wallets using the wallets module.
- [Webhook Helper Functions for VivaWallet Events](https://vivawallet-sdk-docs.mintlify.app/guides/webhook-helpers.md): Use the SDK's exported webhook helper functions to answer URL verification challenges, verify Data Services signatures, extract idempotency keys, and soft-validate Viva webhook payloads.
- [Handle VivaWallet Webhook Events with Full Type Safety](https://vivawallet-sdk-docs.mintlify.app/guides/webhooks.md): Manage VivaWallet webhook subscriptions, retrieve verification keys, create ISV webhooks, and route incoming events to the SDK's webhook helper functions.
- [Installing the VivaWallet Node SDK in Your Project](https://vivawallet-sdk-docs.mintlify.app/installation.md): Add @nkhind/vivawallet-sdk to your Node.js project with npm, yarn, or pnpm, then import client classes and TypeScript types from the package root.
- [VivaWallet Node SDK: Overview, Clients, and Concepts](https://vivawallet-sdk-docs.mintlify.app/introduction.md): Understand the @nkhind/vivawallet-sdk architecture: choose between the Vivawallet, VivaISV, or Marketplace client and see how typed responses work.
- [Error Handling and the MethodReturn Pattern Reference](https://vivawallet-sdk-docs.mintlify.app/reference/errors.md): How the VivaWallet SDK reports errors: the MethodReturn discriminated union, known error codes, and handling unexpected network exceptions.
- [VivaISV Class – ISV Integration API Client Reference](https://vivawallet-sdk-docs.mintlify.app/reference/isv-class.md): Complete reference for VivaISV: constructor options, ISV OAuth and reseller credentials, and the connected account, payment, transaction, source, webhook, and POS modules.
- [Marketplace Class – Multi-Seller Platform Reference](https://vivawallet-sdk-docs.mintlify.app/reference/marketplace-class.md): Complete reference for the Marketplace class constructor configuration options, and sub-client modules for multi-seller platform integrations.
- [TypeScript Type Reference for @nkhind/vivawallet-sdk](https://vivawallet-sdk-docs.mintlify.app/reference/types.md): Reference for documented public TypeScript types exported by @nkhind/vivawallet-sdk: MethodReturn, webhook payloads, and per-domain input/return types.
- [Vivawallet Class – Payments API Client Reference](https://vivawallet-sdk-docs.mintlify.app/reference/vivawallet-class.md): Complete reference for the Vivawallet class: constructor options, thirteen sub-client modules, and the standalone getSmartCheckout function.