# Mesta API Documentation > Documentation for Mesta API ## Guides: Getting Started Guide - [Getting Started](https://docs.mesta.xyz/docs/getting-started.md) - [Authentication and Authorization](https://docs.mesta.xyz/docs/quickstart.md) - [Webhook Signature Verification](https://docs.mesta.xyz/docs/webhook-signature-verification.md) - [Official SDKs](https://docs.mesta.xyz/docs/sdks.md): TypeScript and Python client libraries for the Mesta API. - [TypeScript SDK](https://docs.mesta.xyz/docs/typescript-sdk.md): @mestafi/sdk on npm: client options, request options, types, raw responses and logging. - [Python SDK](https://docs.mesta.xyz/docs/python-sdk.md): mesta on PyPI: client options, request options, async client, raw responses and logging. - [MCP and AI coding tools](https://docs.mesta.xyz/docs/ai-coding-tools.md): Connect Cursor, Claude Code or any MCP client to the Mesta docs and API reference. - [Getting Test Tokens](https://docs.mesta.xyz/docs/getting-test-tokens.md): A guide to acquiring and using test tokens for order flow testing in Mesta sandbox. - [Webhook Events](https://docs.mesta.xyz/docs/webhook-events.md): Reference for all webhook event types, payloads, and best practices for handling Mesta webhooks. - [Error Codes](https://docs.mesta.xyz/docs/error-codes.md): HTTP status codes, validation error formats, and business logic error codes returned by the Mesta API. - [Pagination](https://docs.mesta.xyz/docs/pagination.md): How pagination works across Mesta API list endpoints. - [Rate Limiting](https://docs.mesta.xyz/docs/rate-limiting.md): Rate limit policies and response headers for the Mesta API. ## Guides: Senders - [Request accounts during sender onboarding](https://docs.mesta.xyz/docs/onboarding.md): Select virtual bank account capabilities while creating a sender. - [Onboarding requirement matrix](https://docs.mesta.xyz/docs/onboarding-requirements.md): Public fields and API actions required for each sender account capability. - [Request a virtual bank account after onboarding](https://docs.mesta.xyz/docs/post-onboarding-setup.md): Create, complete, and monitor a virtual bank account request for an existing sender. - [Resolve representative blockers](https://docs.mesta.xyz/docs/representative-blockers.md): Add a Director or Authorized Representative when an account setup request requires one. - [Migrate from direct account generation](https://docs.mesta.xyz/docs/legacy-migration.md): Move an API integration from legacy generation endpoints to the setup-request lifecycle. ## Guides: Workflows - [Stablecoin to Fiat payments](https://docs.mesta.xyz/docs/stable-to-fiat.md) - [Fiat to Stablecoin Payments](https://docs.mesta.xyz/docs/fiat-to-stable.md) - [Fiat to Fiat Payments](https://docs.mesta.xyz/docs/fiat-to-fiat.md) - [Merchant Withdrawals](https://docs.mesta.xyz/docs/merchant-withdrawals.md) - [Funding Test Senders](https://docs.mesta.xyz/docs/funding-test-senders.md): Credit a sender's deposit account with simulated funds in the test environment, so you can run order flows end to end without moving real money. ## Guides: Currencies - [Source Currencies](https://docs.mesta.xyz/docs/source-currencies.md) - [Target Currencies](https://docs.mesta.xyz/docs/target-currencies.md) - [Trade Settlement & Cutoff Times](https://docs.mesta.xyz/docs/trade-settlement-cutoff-times.md) - [Currency transaction limits](https://docs.mesta.xyz/docs/currency-transaction-limits.md) - [Supported Countries](https://docs.mesta.xyz/docs/supported-countries.md) - [Supported States in the United States](https://docs.mesta.xyz/docs/supported-states-in-the-united-states.md) - [Prohibited countries for EUR and GBP accounts/ payments](https://docs.mesta.xyz/docs/prohibited-countries-for-eur-and-gbp-accounts.md) - [Prohibited countries for USD accounts](https://docs.mesta.xyz/docs/prohibited-countries-for-usd-payments.md) - [Prohibited countries for USD SWIFT payments](https://docs.mesta.xyz/docs/prohibited-countries-for-usd-swift-payments.md): Countries and regions that are not supported for USD SWIFT payments. ## Guides: Payment Types - [All Payment Types](https://docs.mesta.xyz/docs/all-payment-types.md) ## Guides: Identity Documents - [Supported Identity Document Types](https://docs.mesta.xyz/docs/supported-identity-document-types.md) ## Guides: Country Codes - [All Country Codes](https://docs.mesta.xyz/docs/all-country-codes.md) ## Guides: State Codes - [All State Codes](https://docs.mesta.xyz/docs/all-state-codes.md) - [Germany](https://docs.mesta.xyz/docs/germany.md) - [Argentina](https://docs.mesta.xyz/docs/argentina-state-codes.md) - [Australia](https://docs.mesta.xyz/docs/australia.md) - [Brazil](https://docs.mesta.xyz/docs/brazil.md) - [Canada](https://docs.mesta.xyz/docs/canada.md) - [Colombia](https://docs.mesta.xyz/docs/colombia.md) - [India](https://docs.mesta.xyz/docs/india.md) - [Mexico](https://docs.mesta.xyz/docs/mexico.md) - [Philippines](https://docs.mesta.xyz/docs/philippines.md) - [United States](https://docs.mesta.xyz/docs/united-states.md) - [Austria](https://docs.mesta.xyz/docs/austria.md) - [Belgium](https://docs.mesta.xyz/docs/belgium.md) - [Croatia](https://docs.mesta.xyz/docs/croatia.md) - [Cyprus](https://docs.mesta.xyz/docs/cyprus.md) - [Estonia](https://docs.mesta.xyz/docs/estonia.md) - [Finland](https://docs.mesta.xyz/docs/finland.md) - [France](https://docs.mesta.xyz/docs/france.md) - [Greece](https://docs.mesta.xyz/docs/greece.md) - [Hong Kong](https://docs.mesta.xyz/docs/hong-kong.md) - [Indonesia](https://docs.mesta.xyz/docs/indonesia.md) - [Ireland](https://docs.mesta.xyz/docs/ireland.md) - [Italy](https://docs.mesta.xyz/docs/italy.md) - [Latvia](https://docs.mesta.xyz/docs/latvia.md) - [Lithuania](https://docs.mesta.xyz/docs/lithuania.md) - [Luxembourg](https://docs.mesta.xyz/docs/luxembourg.md) - [Malta](https://docs.mesta.xyz/docs/malta.md) - [Netherlands](https://docs.mesta.xyz/docs/netherlands.md) - [Nigeria](https://docs.mesta.xyz/docs/nigeria.md) - [Portugal](https://docs.mesta.xyz/docs/portugal.md) - [Slovakia](https://docs.mesta.xyz/docs/slovakia.md) - [Slovenia](https://docs.mesta.xyz/docs/slovenia.md) - [South Korea](https://docs.mesta.xyz/docs/south-korea.md) - [Spain](https://docs.mesta.xyz/docs/spain.md) - [Thailand](https://docs.mesta.xyz/docs/thailand.md) - [United Kingdom](https://docs.mesta.xyz/docs/united-kingdom.md) - [United Arab Emirates](https://docs.mesta.xyz/docs/united-arab-emirates.md) - [Vietnam](https://docs.mesta.xyz/docs/vietnam.md) - [Norway](https://docs.mesta.xyz/docs/norway.md) - [China](https://docs.mesta.xyz/docs/china.md) - [Marshall Islands](https://docs.mesta.xyz/docs/marshall-islands.md) - [Liechtenstein](https://docs.mesta.xyz/docs/liechtenstein.md) - [Iceland](https://docs.mesta.xyz/docs/iceland.md) - [Switzerland](https://docs.mesta.xyz/docs/switzerland.md) - [Japan](https://docs.mesta.xyz/docs/japan.md) ## Mesta API Reference: Mesta API - [Get Merchant Information](https://docs.mesta.xyz/reference/get_v1-merchants-merchantid.md): Retrieves detailed information about a specific merchant, including account details and UBO (Ultimate Beneficial Owner) information. - [Get Merchant Account Transactions](https://docs.mesta.xyz/reference/get_v1-merchant-transactions.md): Retrieves a paginated list of merchant transactions with optional filtering. - [Get Merchant Accounts](https://docs.mesta.xyz/reference/get_v1-merchant-accounts.md): Retrieve the list of merchant accounts. - [Get Merchant Account Balances](https://docs.mesta.xyz/reference/get_v1-merchant-accounts-balances.md): Retrieve the current balances for all merchant accounts across different currencies. - [Get Sender Balances for Merchant](https://docs.mesta.xyz/reference/get_v1-merchant-accounts-senders-balances.md): Retrieve the current balances for all senders, optionally filtered by currency. - [List Fiat Deposits](https://docs.mesta.xyz/reference/get_v1-merchant-fiat-deposits.md): Retrieve a paginated list of fiat deposits for a merchant. Only completed deposits are returned. Supports filtering by currency, sender, and deposit bank account. - [Get Fiat Deposit by ID](https://docs.mesta.xyz/reference/get_v1-merchant-fiat-deposits-id.md): Retrieve a specific fiat deposit by its ID. - [List Stablecoin Deposits](https://docs.mesta.xyz/reference/get_v1-merchant-stablecoin-deposits.md): Retrieve a paginated list of stablecoin deposits for a merchant. Supports filtering by currency, status, sender, and risk level. - [Get Stablecoin Deposit by ID](https://docs.mesta.xyz/reference/get_v1-merchant-stablecoin-deposits-id.md): Retrieve a specific stablecoin deposit by its ID. - [Accept Merchant Terms](https://docs.mesta.xyz/reference/post_v1-merchants-id-accept-terms.md): Records the merchant's acceptance of Terms of Service. Captures acceptance timestamp, user identity, and IP address. - [Get Merchant Balances](https://docs.mesta.xyz/reference/get_v1-merchants-merchantid-balances.md): Retrieves the current balances for a merchant across all currencies and stablecoins. - [Create Source Address](https://docs.mesta.xyz/reference/post_v1-senders-id-source-wallet-addresses.md): Creates new source addresses for a specific sender. Multiple addresses can be created in a single request. - [Get Source Wallet Address](https://docs.mesta.xyz/reference/get_v1-source-wallet-addresses-id.md): Retrieves a single source wallet address by its unique identifier. - [Sender Management](https://docs.mesta.xyz/reference/sender-management.md): Create, retrieve, update, verify, and manage senders. - [Get Sender List](https://docs.mesta.xyz/reference/get_v1-senders.md): Retrieves a list of all senders associated with a merchant. - [Create Sender (v2)](https://docs.mesta.xyz/reference/post_v2-senders.md): ## Overview * Creates a new sender * Supports both individual and business senders * Includes additional onboarding fields used for compliance review * Requirements vary by country and ownerType ##… - [Get Sender](https://docs.mesta.xyz/reference/get_v1-senders-senderid.md): Retrieves detailed information about a specific sender account. - [Update Sender](https://docs.mesta.xyz/reference/patch_v1-senders-senderid.md): Updates an existing sender's information. Note that certain fields cannot be modified after initial creation: - type (individual/business) - identificationNumber (for business senders) -… - [Delete Sender](https://docs.mesta.xyz/reference/delete_v1-senders-senderid.md): Deletes a sender account. - [Verify Sender](https://docs.mesta.xyz/reference/post_v1-senders-senderid-verify.md): Initiates verification when requirements are complete; otherwise returns actionable capability-requirement blockers. - [Simulate Sender Verification Result (Test Environments Only)](https://docs.mesta.xyz/reference/post_v1-senders-senderid-mock-verification-result.md): Settles a pending sender verification with a simulated provider decision so you can drive onboarding end to end without waiting on the identity provider. For a business sender the result cascades to… - [Sender Documents](https://docs.mesta.xyz/reference/sender-documents.md): Upload and manage sender onboarding documents. - [Upload Document](https://docs.mesta.xyz/reference/post_v1-senders-senderid-documents.md): Uploads a document for a specific sender. - [Delete Document](https://docs.mesta.xyz/reference/delete_v1-senders-senderid-documents-documentid.md): Deletes a specific document associated with a sender. - [Ultimate Beneficial Owners](https://docs.mesta.xyz/reference/ultimate-beneficial-owners.md): Create, manage, and verify sender UBOs. - [Create UBO (v2)](https://docs.mesta.xyz/reference/post_v2-senders-ubo.md): Creates a new UBO (Ultimate Beneficial Owner) for a specific sender. Note: Document requirements (documentFront, documentBack) vary by country. Please refer to the validation-rules endpoint with… - [Get UBO Details](https://docs.mesta.xyz/reference/get_v1-senders-uboid-1.md): Retrieves details of a specific Ultimate Beneficial Owner (UBO) - [Get UBO Selfie Verification URL](https://docs.mesta.xyz/reference/get_v1-senders-uboid-verification-url.md): Fetches the latest selfie verification session for a UBO and, optionally, generates or regenerates a verification link. Action behavior: * no `action`: return the current verification-session state… - [Update UBO Details](https://docs.mesta.xyz/reference/patch_v1-senders-uboid-1.md): Updates an existing Ultimate Beneficial Owner (UBO). In addition to the base UBO fields, this endpoint supports `pepDeclaration`, `verificationReport`, and `sofDocument`. `sofDocument` is required… - [Delete UBO](https://docs.mesta.xyz/reference/delete_v1-senders-uboid-1.md): Deletes an existing UBO (Ultimate Beneficial Owner) - [Directors and Authorized Representatives](https://docs.mesta.xyz/reference/directors-and-authorized-representatives.md): Create, manage, and verify sender representatives. - [Create Director or Authorized Representative](https://docs.mesta.xyz/reference/post_v1-senders-associates.md): Adds a Director or Authorized Representative to a sender. - [List Directors and Authorized Representatives](https://docs.mesta.xyz/reference/get_v1-senders-associates.md): Returns all Directors and Authorized Representatives for a sender. - [Get Director or Authorized Representative](https://docs.mesta.xyz/reference/get_v1-senders-associates-associateid.md): Returns one Director or Authorized Representative. - [Get Representative Selfie Verification URL](https://docs.mesta.xyz/reference/get_v1-senders-associates-associateid-verification-url.md): Returns or creates the selfie-verification session for an unlinked representative. - [Update Director or Authorized Representative](https://docs.mesta.xyz/reference/patch_v1-senders-associates-associateid.md): Updates an existing Director or Authorized Representative. - [Delete Director or Authorized Representative](https://docs.mesta.xyz/reference/delete_v1-senders-associates-associateid.md): Deletes a Director or Authorized Representative when deletion is allowed. - [Sender Virtual Bank Accounts](https://docs.mesta.xyz/reference/sender-virtual-bank-accounts.md): Request and retrieve sender virtual bank accounts. - [Create Virtual Bank Account](https://docs.mesta.xyz/reference/post_v1-senders-senderid-virtual-bank-accounts-currency-setup-request.md): Creates or reuses the current virtual bank account request for a sender and currency. - [Get Virtual Bank Account Status](https://docs.mesta.xyz/reference/get_v1-senders-senderid-virtual-bank-accounts-currency-setup-request.md): Returns the current virtual bank account status and actionable blockers. - [Update Virtual Bank Account Setup Data](https://docs.mesta.xyz/reference/patch_v1-senders-senderid-virtual-bank-accounts-currency-setup-request-data.md): Supplies missing sender or UBO information and re-evaluates the virtual bank account request. - [Cancel Virtual Bank Account Request](https://docs.mesta.xyz/reference/delete_v1-senders-senderid-virtual-bank-accounts-currency-setup-request.md): Cancels a virtual bank account request before setup begins or after a failure. - [Get Sender Virtual Bank Accounts](https://docs.mesta.xyz/reference/get_v1-senders-senderid-virtual-bank-accounts-currency.md): Returns the virtual bank accounts available to the sender for the requested currency. - [Terms of Service](https://docs.mesta.xyz/reference/terms-of-service.md): Retrieve and complete sender Terms of Service acceptance. - [Get Sender TOS Status](https://docs.mesta.xyz/reference/get_v1-senders-senderid-tos-status-1.md): Retrieves the current Terms of Service acceptance status for a specific sender, along with the active shareable acceptance link. In the current sender flow, a TOS acceptance link is generated during… - [Get TOS Acceptance Details](https://docs.mesta.xyz/reference/get_v1-senders-tos-acceptance-token.md): Retrieves the Terms of Service acceptance details for a given token. This is a public endpoint that does not require authentication. - [Accounts and Balances](https://docs.mesta.xyz/reference/accounts-and-balances.md): Retrieve sender balances and access legacy account-setup operations. - [Get Sender Balances](https://docs.mesta.xyz/reference/get_v1-senders-senderid-balances.md): Retrieves the account balances for a specific sender across all supported currencies. Returns an array of currency-balance pairs for all currencies where the sender has an account. - [Simulate Sender Deposit (Test Environments Only)](https://docs.mesta.xyz/reference/post_v1-senders-senderid-accounts-mock-deposit.md): Credits a sender's deposit account with simulated funds so you can test order flows end to end without moving real money. Available in test environments only — disabled in production. - [Generate On-Demand Deposit Bank Accounts](https://docs.mesta.xyz/reference/post_v1-senders-id-generate-ondemand-deposit-bank-accounts.md): **For new integrations:** use `POST /v1/senders/{senderId}/virtual-bank-accounts/{currency}/setup-request`. It reports missing information and provisions automatically when ready. Initiates the… - [Create Beneficiary (V3)](https://docs.mesta.xyz/reference/post_v3-beneficiaries.md): Create a new beneficiary with mandatory compliance fields. Same as V2 but `beneficiaryRelationship` and `purposeOfPayment` are required. - [Update Beneficiary (v2)](https://docs.mesta.xyz/reference/patch_v2-beneficiaries-id.md): Partially update a beneficiary. Only the provided fields will be updated. - [Delete Beneficiary](https://docs.mesta.xyz/reference/delete_v1-beneficiaries-beneficiaryid.md): Deletes a beneficiary account. - [Verify Beneficiary](https://docs.mesta.xyz/reference/post_v1-beneficiaries-beneficiaryid-verify.md): Verifies a specific beneficiary account by initiating sanction/watchlist screenings. - [Simulate Beneficiary Verification Result (Test Environments Only)](https://docs.mesta.xyz/reference/post_v1-beneficiaries-beneficiaryid-mock-verification-result.md): Settles a pending beneficiary verification with a simulated provider decision so you can drive payout flows end to end without waiting on the identity provider. Available in test environments only —… - [Get Bank Id](https://docs.mesta.xyz/reference/get_v1-beneficiaries-banks.md): Retrieve a list of bank Ids for a specific country. - [List Beneficiaries (v2)](https://docs.mesta.xyz/reference/get_v2-beneficiaries.md): Retrieves a paginated list of beneficiaries using the V2 API. Unlike v1, the v2 API separates payment methods from beneficiary data. Payment methods are available on the detail endpoint. - [Get Beneficiary (v2)](https://docs.mesta.xyz/reference/get_v2-beneficiaries-id.md): Retrieve a single beneficiary by ID with their associated payment methods. - [Get Beneficiary Document Presigned URL](https://docs.mesta.xyz/reference/get_v1-beneficiaries-beneficiaryid-documents-documentid-presigned-url.md): Generates a pre-signed URL to download a beneficiary's uploaded document. The URL expires after 300 seconds. - [Get Purpose of Payment Document Presigned URL](https://docs.mesta.xyz/reference/get_v2-beneficiaries-id-purpose-of-payment-document-presigned-url.md): Generate a pre-signed URL for downloading the purpose of payment document attached to a beneficiary. The URL expires in 300 seconds. - [Payment Method API](https://docs.mesta.xyz/reference/payment-method-api.md): Create and manage payment methods for beneficiaries. Payment methods define how funds are delivered to a beneficiary (bank account, PIX, mobile money, etc.). - [List Payment Methods](https://docs.mesta.xyz/reference/get_v1-payment-methods.md): Retrieve a paginated list of payment methods. Filter by beneficiary, type, or status. - [Create Payment Method](https://docs.mesta.xyz/reference/post_v1-payment-methods.md): Create a new payment method for a beneficiary. The payment method type determines the required data fields. - [Get Payment Method](https://docs.mesta.xyz/reference/get_v1-payment-methods-id.md): Retrieve a specific payment method by its ID. - [Update Payment Method](https://docs.mesta.xyz/reference/put_v1-payment-methods-id.md): Update an existing payment method. All required fields must be provided. - [Delete Payment Method](https://docs.mesta.xyz/reference/delete_v1-payment-methods-id.md): Delete a payment method by its ID. - [Make Consent Decision](https://docs.mesta.xyz/reference/patch_v1-payment-methods-id-consent.md): Approve or decline a payment method that requires user consent. - [Get Quote](https://docs.mesta.xyz/reference/get_v1-quotes-quoteid.md): Retrieve the details of a specific quote by its unique identifier (quoteId). - [Create Quote](https://docs.mesta.xyz/reference/post_v1-quotes.md): Obtain a quote for converting USD or USDC to another specified currency. For web3 merchants, sourceCurrency is required and must be a stable coin. For web2 merchants, sourceCurrency is optional and… - [Get All Quotes](https://docs.mesta.xyz/reference/get_v1-quotes.md): Retrieves a paginated list of quotes with optional filtering. - [Get Order List](https://docs.mesta.xyz/reference/get_v1-orders.md): Retrieves a list of orders for the authenticated user, with optional filters to narrow down results based on status, date range, target currency, or other relevant criteria. - [Create Order (v2)](https://docs.mesta.xyz/reference/post_v2-orders.md): Create a new order using a payment method ID. This is the recommended way to create orders. Requires an accepted quote, a sender, and a payment method. - [Get Order](https://docs.mesta.xyz/reference/get_v1-orders-orderid.md): Retrieves detailed information about a specific order, including its current status and progress. - [Get Deposit Wallet Address for the order](https://docs.mesta.xyz/reference/get_v1-orders-orderid-deposit-wallet-address.md): Retrieves the deposit wallet address for a specific order - [Get Order Deposit Bank Account](https://docs.mesta.xyz/reference/get_v1-orders-orderid-deposit-bank-account.md): Retrieves the deposit bank account details for onramp orders. This endpoint provides bank account information where funds should be deposited to complete the order. - [Get Order Events](https://docs.mesta.xyz/reference/get_v1-orders-orderid-events.md): Retrieve the event history for a specific order. Returns a chronological list of state transitions and their timestamps. - [Cancel Order](https://docs.mesta.xyz/reference/post_v1-orders-orderid-cancel.md): Cancels an existing order. The order must be in a cancellable state. - [Get Order Document Presigned URL](https://docs.mesta.xyz/reference/get_v1-orders-id-documents-id.md): Retrieves a temporary presigned URL for downloading an order document. The URL expires after 5 minutes. - [Create Internal Transfer](https://docs.mesta.xyz/reference/post_v1-transfers.md): Creates an internal transfer that moves funds between two verified senders belonging to your merchant account. Only enabled for select merchants and use cases, on request — contact our support team… - [Events API](https://docs.mesta.xyz/reference/events.md): Retrieve external events for tracking order lifecycle, sender verification, and other system events. - [List External Events](https://docs.mesta.xyz/reference/get_v1-external-events.md): Retrieve a paginated list of external events. Filter by aggregate type, merchant, or event name. - [Get Sender Validation Rules](https://docs.mesta.xyz/reference/get_v1-validation-rules-senders.md): Retrieves all validation rules required for creating a sender in a specific country. Use these rules to validate sender information before submission. - [Get UBO (Ultimate Beneficial Owner) Validation Rules](https://docs.mesta.xyz/reference/get_v1-validation-rules-senders-ubo.md): Retrieves validation rules for UBO information based on country and owner type. These rules specify all required fields for UBO verification. - [Get Required Document Types for Sender](https://docs.mesta.xyz/reference/get_v1-validation-rules-senders-document-types.md): Retrieves the list of required documents for sender verification. This includes business registration documents and identity proofs. - [Get Sender-Supported Countries](https://docs.mesta.xyz/reference/get_v1-validation-rules-senders-countries.md): Retrieve a list of countries from which senders can originate payments. - [Get Beneficiary Validation Rules](https://docs.mesta.xyz/reference/get_v1-validation-rules-beneficiaries.md): Retrieves all validation rules required for creating a beneficiary, including required fields and payment information requirements. - [Get Required Document Types for Beneficiary](https://docs.mesta.xyz/reference/get_v1-validation-rules-beneficiaries-document-types.md): Retrieves the list of required documents for beneficiary verification based on country and owner type. Note that some countries may not require any documents. - [Get Supported Payment Types for Beneficiary](https://docs.mesta.xyz/reference/get_v1-validation-rules-beneficiaries-payment-types.md): Retrieves the list of supported payment types and their required fields for a beneficiary in a specific country. Use this to determine what payment information needs to be collected. - [Get Beneficiary-Supported Countries](https://docs.mesta.xyz/reference/get_v1-validation-rules-beneficiaries-countries.md): Retrieve a list of countries to which payments can be delivered. - [Get States by Country](https://docs.mesta.xyz/reference/get_v1-validation-rules-states.md): Retrieve a list of states/provinces for a given country code. Returns state codes in ISO 3166-2 format. - [Get Sender Validation Rules (V2)](https://docs.mesta.xyz/reference/get_v2-validation-rules-senders.md): Retrieves all validation rules required for creating a sender in a specific country. V2 adds structured `supportedDocumentTypes` on identity fields, indicating which document types are available per… - [Get UBO Validation Rules (V2)](https://docs.mesta.xyz/reference/get_v2-validation-rules-senders-ubo.md): Retrieves validation rules for UBO (Ultimate Beneficial Owner) information. V2 adds structured `supportedDocumentTypes` on the identity documentType field, indicating available document types per… - [Get Required Document Types for Business Sender (V2)](https://docs.mesta.xyz/reference/get_v2-validation-rules-senders-document-types.md): Retrieves the list of required documents for sender verification. This includes business registration documents and identity proofs. Same as V1. - [Get Registered Webhooks](https://docs.mesta.xyz/reference/get_v1-webhooks.md): Retrieves a list of all registered webhooks for the calling client. - [Register Webhook](https://docs.mesta.xyz/reference/post_v1-webhooks.md): Registers a new webhook for a specific event. - [Get Webhook by ID](https://docs.mesta.xyz/reference/get_v1-webhooks-id.md): Retrieves a specific webhook by its unique identifier. - [Update Webhook](https://docs.mesta.xyz/reference/patch_v1-webhooks-id.md): Updates a registered webhook. - [Delete Webhook](https://docs.mesta.xyz/reference/delete_v1-webhooks-id.md): Deletes a registered webhook. - [Sample Webhook payloads](https://docs.mesta.xyz/reference/sample-webhook-payloads.md) - [Get Sender Source Wallet Addresses](https://docs.mesta.xyz/reference/get_v1-senders-id-source-wallet-addresses-1.md): Retrieves all source wallet addresses for a specific sender. Supports pagination, sorting, and search. - [Delete Sender Source Wallet Address](https://docs.mesta.xyz/reference/delete_v1-senders-id-source-wallet-addresses-id.md): Deletes a specific source wallet address for a sender. - [Get Merchant Source Wallet Addresses](https://docs.mesta.xyz/reference/get_v1-merchants-id-source-wallet-addresses.md): Retrieves all source wallet addresses for a specific merchant. - [Create Merchant Source Wallet Addresses](https://docs.mesta.xyz/reference/post_v1-merchants-id-source-wallet-addresses.md): Creates or updates source wallet addresses for a merchant. Accepts an array of addresses. - [Delete Merchant Source Wallet Address](https://docs.mesta.xyz/reference/delete_v1-merchants-id-source-wallet-addresses-id.md): Deletes a specific source wallet address for a merchant. - [Merchant Login](https://docs.mesta.xyz/reference/post_v1-auth-merchant-login.md): Authenticates a merchant user with email and password. Returns access and refresh tokens upon successful authentication. Supports MFA via TOTP. - [Authorize Request](https://docs.mesta.xyz/reference/post_v1-auth-authorize.md): Validates an access token or API key and returns the authenticated principal with their permissions. Used internally for request authorization. - [Create API Key](https://docs.mesta.xyz/reference/post_v1-api-keys.md): Creates a new API key for the merchant. The API secret is only returned in the creation response and cannot be retrieved later. - [List API Keys](https://docs.mesta.xyz/reference/get_v1-api-keys.md): Retrieves a paginated list of API keys for the merchant. - [Get API Key](https://docs.mesta.xyz/reference/get_v1-api-keys-id.md): Retrieves details of a specific API key by ID. - [Update API Key](https://docs.mesta.xyz/reference/patch_v1-api-keys-id.md): Updates the name and/or permissions of an existing API key. - [Delete API Key](https://docs.mesta.xyz/reference/delete_v1-api-keys-id.md): Permanently deletes an API key. This action cannot be undone. ## Changelog - [Multi-currency Expansion & API Upgrade](https://docs.mesta.xyz/changelog/multi-currency-expansion-api-upgrade.md)