# Vita Wallet Business API

> Vita Wallet Business API: cobra payins locales, envía payouts a bancos en LatAm y el mundo, convierte entre fiat y cripto, y recibe webhooks en tiempo real.

- [Introducción](https://docs.vitawallet.io/introduction.md): Vita Wallet Business API — pagos reales con LatAm y el mundo.
- [Primeros pasos](https://docs.vitawallet.io/getting-started.md): Crea tu cuenta de prueba, genera credenciales y realiza tu primera transacción.
- [Ambientes](https://docs.vitawallet.io/environments.md): Sandbox vs Producción — URLs base y diferencias clave.
- [Modelo de balances](https://docs.vitawallet.io/money-model.md): Cómo funcionan las wallets por moneda y cómo se mueven los fondos dentro de tu cuenta business.
- [Sandbox y pruebas](https://docs.vitawallet.io/sandbox-testing.md): Cómo probar tu integración end-to-end sin mover dinero real.
- [Idempotencia y reintentos](https://docs.vitawallet.io/idempotency-retries.md): Patrones seguros para reintentar operaciones sin duplicar transacciones.
- [Autenticación](https://docs.vitawallet.io/authentication.md): Firma HMAC-SHA256 y headers obligatorios para cada petición.
- [Códigos de error](https://docs.vitawallet.io/errors.md): Formato de errores y referencia completa de códigos.
- [Colección Postman](https://docs.vitawallet.io/postman.md): Importa la colección oficial y ejecuta cada endpoint desde Postman con las credenciales ya configuradas.
- [Casos de uso](https://docs.vitawallet.io/use-cases/overview.md): Ejemplos reales de cómo integrar Vita Wallet Business API según tu modelo de negocio.
- [Marketplaces y plataformas](https://docs.vitawallet.io/use-cases/marketplaces.md): Cobra a muchos compradores en su moneda y paga a muchos vendedores, incluso en otro país, con una sola integración.
- [Remesas internacionales](https://docs.vitawallet.io/use-cases/remittances.md): Cobra en el país de origen, convierte la moneda y acredita en la cuenta del beneficiario en otro país.
- [Agencias de viaje y turismo](https://docs.vitawallet.io/use-cases/travel.md): Cobra reservas en moneda local y paga a hoteles, operadores y aerolíneas internacionales con una sola integración.
- [Creadores, freelancers y equipos remotos](https://docs.vitawallet.io/use-cases/creators-freelancers.md): Envía pagos masivos a creadores y colaboradores en distintos países desde un saldo central en dólares.
- [On-ramp y off-ramp](https://docs.vitawallet.io/use-cases/on-off-ramp.md): Convierte moneda local a cripto y viceversa con payins, exchange y payouts estándar.
- [Billeteras digitales y neobancos](https://docs.vitawallet.io/use-cases/wallets-neobanks.md): Suma recarga de saldo, envíos entre usuarios y retiros a banco sin construir cada riel por país.
- [Pagos embebidos en ERP y software de gestión](https://docs.vitawallet.io/use-cases/erp-embedded.md): Ofrece cobros, pagos y conversión dentro de tu propio producto para todas las empresas que lo usan.
- [PSP, agregadores y white label](https://docs.vitawallet.io/use-cases/psp-aggregators.md): Expande tu PSP a nuevos países y métodos de pago locales sin construir cada conexión.
- [Comercio exterior y tesorería B2B](https://docs.vitawallet.io/use-cases/b2b-treasury.md): Cobra, convierte y paga grandes montos entre países con trazabilidad para auditoría contable.
- [Cuentas virtuales por cliente](https://docs.vitawallet.io/use-cases/virtual-accounts.md): Identifica cada depósito por cliente final y concilia sin trabajo manual.
- [Conciliación y reportes automáticos](https://docs.vitawallet.io/use-cases/reconciliation.md): Automatiza la conciliación contable con webhooks y endpoints de lectura.
- [Preguntas frecuentes](https://docs.vitawallet.io/faq.md): Dudas recurrentes de integradores: credenciales, firma, webhooks, idempotencia y reconciliación.
- [Payins](https://docs.vitawallet.io/api-reference/payins/overview.md): Generate shareable payment links to collect funds from your customers in local currency.
- [Create payin](https://docs.vitawallet.io/api-reference/create-payin/create-payin.md): Please use this endpoint to create a new payment order. Upon successful creation, you will receive a detailed response containing the data of the new payment order, along with a URL. This URL can be utilized to proceed with payment through one of the providers configured for your account. If a webho…
- [Direct Payment](https://docs.vitawallet.io/api-reference/direct-payment/overview.md): Process payins directly from your own UI — no redirection, no hosted checkout.
- [List payin prices](https://docs.vitawallet.io/api-reference/direct-payment/list-payin-prices.md): This method shows Vita Business prices for payins only, in order to calculate transactions final amount. This endpoint has no rate limit and can be used without freezing the price for other operations, like `/api/businesses/payins_prices`.
- [Payment Methods by Country](https://docs.vitawallet.io/api-reference/direct-payment/payment-methods-by-country.md): **GET /api/businesses/payment_methods/{country_iso_code}**
- [Direct Payment](https://docs.vitawallet.io/api-reference/direct-payment/direct-payment.md): Process a direct payment without redirection. This endpoint allows processing payments directly with customer data.
- [List Payment Orders](https://docs.vitawallet.io/api-reference/direct-payment/list-payment-orders.md): This endpoint returns a **paginated list of all payment orders** in your business account, with support for filters by date range, status, source currency, and target currency. It's the primary endpoint for **monitoring, auditing, and reconciling** the payment collection activity in your Payins inte…
- [Get Payment Order Attempt](https://docs.vitawallet.io/api-reference/direct-payment/get-payment-order-attempt.md): #### Overview - Get Payment Order Attempt
- [List All Payment Order Attempts](https://docs.vitawallet.io/api-reference/direct-payment/list-all-payment-order-attempts.md): #### Overview - Get Payment Order Attempts
- [Exchange](https://docs.vitawallet.io/api-reference/exchange/overview.md): Convert between crypto and fiat (or between cryptos) directly from your business wallet.
- [List crypto prices](https://docs.vitawallet.io/api-reference/exchange/list-crypto-prices.md): This endpoint returns Vita Business's current crypto exchange rates, which you'll use to calculate the final amount of any exchange transaction.
- [Create exchange](https://docs.vitawallet.io/api-reference/exchange/create-exchange.md): Create a crypto exchange transaction. This endpoint converts funds between a crypto and a fiat currency (in either direction) or between two cryptocurrencies, directly from your business wallet at the rate retrieved from `GET /crypto_prices`.
- [Payouts](https://docs.vitawallet.io/api-reference/payouts/overview.md): Send funds from your wallet to Vita users, bank accounts, or external blockchain addresses through a single endpoint.
- [Vita Sent](https://docs.vitawallet.io/api-reference/vita-sent/overview.md): Instant internal transfers from your business wallet to any Vita Wallet user.
- [List prices](https://docs.vitawallet.io/api-reference/vita-sent/list-prices.md): Returns Vita's current exchange rates, fixed costs, and operational parameters needed to calculate the final amount of any fiat transaction. The response is organized by **source currency** (every currency active in your wallet, e.g. `clp`, `usd`, `cop`). Each currency object contains **two independ…
- [Create Vita Sent](https://docs.vitawallet.io/api-reference/vita-sent/create-vita-sent.md): Send funds instantly from your business wallet to another Vita Wallet user by email.
- [Bank Payouts](https://docs.vitawallet.io/api-reference/bank-payouts/overview.md): Send funds from your wallet to bank accounts in any supported country.
- [List prices](https://docs.vitawallet.io/api-reference/vita-sent/list-prices.md): Returns Vita's current exchange rates, fixed costs, and operational parameters needed to calculate the final amount of any fiat transaction. The response is organized by **source currency** (every currency active in your wallet, e.g. `clp`, `usd`, `cop`). Each currency object contains **two independ…
- [List payout rules](https://docs.vitawallet.io/api-reference/bank-payouts/list-payout-rules.md): This endpoint returns the **dynamic form schema** required to create a fiat payout to a specific destination country. Since each country has its own banking regulations, account formats, and compliance requirements, the necessary fields vary from one destination to another.
- [Get beneficiary](https://docs.vitawallet.io/api-reference/bank-payouts/get-beneficiary.md): This endpoint allows you to **check whether a beneficiary is registered in Vita and able to receive funds** through a withdrawal in a specific country. It's typically used as a **pre-flight check** before creating a withdrawal — letting you verify the recipient's eligibility, retrieve their existing…
- [Validate beneficiaries](https://docs.vitawallet.io/api-reference/bank-payouts/validate-beneficiaries.md): #### Validate Beneficiary
- [Create Payout](https://docs.vitawallet.io/api-reference/bank-payouts/create-payout.md): Send funds from your business wallet to a bank account in any supported country.
- [External Crypto Payouts](https://docs.vitawallet.io/api-reference/external-crypto-payouts/overview.md): Send USDT or USDC from your wallet to external blockchain addresses across major networks.
- [Get available networks](https://docs.vitawallet.io/api-reference/external-crypto-payouts/get-available-networks.md): Before creating any crypto payout to an external blockchain address, you must consult this endpoint to discover:
- [Create Crypto Payout](https://docs.vitawallet.io/api-reference/external-crypto-payouts/create-crypto-payout.md): Send USDT or USDC from your business wallet to an external blockchain address.
- [Transactions](https://docs.vitawallet.io/api-reference/transactions/overview.md): Query, monitor, and reconcile all transactions created in your Vita account.
- [List API transactions](https://docs.vitawallet.io/api-reference/transactions/list-api-transactions.md): This method allows you to list all the API transactions, supports paging and filters.
- [List all transactions](https://docs.vitawallet.io/api-reference/transactions/list-all-transactions.md): This method allows you to list all the transactions, supports paging and filters such as amounts and dates.
- [Get Transaction](https://docs.vitawallet.io/api-reference/transactions/get-transaction.md): This method allows you to obtain the information of an API transaction by VITA ID.
- [Users](https://docs.vitawallet.io/api-reference/users/overview.md): Create and retrieve information about users and accounts operating within your integration.
- [Users Creation](https://docs.vitawallet.io/api-reference/users-creation/overview.md): Full onboarding lifecycle — create users, capture documentation, trigger KYC/KYB, and track verification status.
- [Create User](https://docs.vitawallet.io/api-reference/users-creation/create-user.md): This endpoint allows creating a user in Vita Wallet. Depending on the information provided:
- [Complete Verification](https://docs.vitawallet.io/api-reference/users-creation/complete-verification.md): This endpoint allows completing the verification of a previously created user in Vita Wallet (both natural and business users).
- [Verification Status](https://docs.vitawallet.io/api-reference/users-creation/verification-status.md): This endpoint allows you to check the verification status of a user based on their email. The response includes:
- [User Information](https://docs.vitawallet.io/api-reference/user-information/overview.md): Read-only lookups for user profiles, balances, and deposit methods.
- [User](https://docs.vitawallet.io/api-reference/user-information/user.md): VITA provides this module to check if there is a registered user on Vita Wallet with a specific email address. Additionally, it allows you to know the status of the user and whether they can receive money or not.
- [Balance](https://docs.vitawallet.io/api-reference/user-information/balance.md): This endpoint returns the **current balance of a wallet in real time**. By passing the wallet's `uuid` in the URL, the response includes the `balances` object reflecting the up-to-date balance at the exact moment of the request — across all currencies active in that wallet.
- [List Deposit Methods](https://docs.vitawallet.io/api-reference/user-information/list-deposit-methods.md): This method show Vita Business prices, in order to calculate transactions final amount.
- [Webhooks](https://docs.vitawallet.io/api-reference/webhooks/overview.md): Receive real-time notifications about account events — status changes, deposits, payouts, exchanges, and more.
- [Webhook Configuration](https://docs.vitawallet.io/api-reference/webhooks/webhook-configuration.md): Retrieves the current webhook configuration for your business account, including:
- [Update Webhook Configuration](https://docs.vitawallet.io/api-reference/webhooks/update-webhook-configuration.md): Updates the webhook configuration for your business, setting or replacing the destination URL and the list of subscribed categories.
- [Webhook Events](https://docs.vitawallet.io/api-reference/webhooks/webhook-events.md): Retrieves the 10 most recent events generated for your business account, ordered by creation date in descending order. Each event includes the transaction payload, delivery status, attempt history, and the server response received from your endpoint.

## OpenAPI Specs

- [openapi](/openapi.yaml)

## Optional

- [Vita Wallet](https://vitawallet.io)
- [Soporte](mailto:empresas@vitawallet.io)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.