# Mesta API Documentation > Documentation for Mesta API Append .md to any documentation page URL to get its markdown version. ## Guides - [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. - [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. - [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. - [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. - [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 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. - [All Payment Types](https://docs.mesta.xyz/docs/all-payment-types.md) - [Supported Identity Document Types](https://docs.mesta.xyz/docs/supported-identity-document-types.md) - [All Country Codes](https://docs.mesta.xyz/docs/all-country-codes.md) - [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) ## API Reference - [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 ## Validation Rules * **Important**: Always check validation rules before creating a sender * Validation rules endpoint: `GET /v2/validation-rules/senders` * Required query parameters: * `ownerType=[individual|business]` * `country=[ISO 3166-1 alpha-2 code]` * Example request: ``` GET /v2/validation-rules/senders?ownerType=individual&country=MX ``` ## Additional v2 Notes * `expectedMonthlyVolumeEstimate`, `averageTransactionSize`, `primaryCounterpartyJurisdictions`, `natureOfPayments`, and `sourceOfFunds` are required for both sender types * Each value in `primaryCounterpartyJurisdictions` must be an ISO 3166-1 alpha-2 country code (for example: `US`, `IN`, `GB`) * `isFinancialInstitution` and `numberOfEmployees` are required for business senders * `websiteAbsenceReason` is required for business senders when `websiteUrl` is not provided * If `isFinancialInstitution` is `true`, upload the FI registration proof using `POST /v1/senders/{senderId}/documents` with document type `fi_registration_proof` before calling `POST /v1/senders/{senderId}/verify` ## Virtual bank account capabilities * Optionally request `eur_account`, `usd_account`, `gbp_account`, or `mxn_account` using the `capabilities` array * The response reports `acceptedCapabilities` and `unavailableCapabilities` using the same capability values * An unavailable capability does not fail sender creation * Complete UBOs, associates, documents, and verification normally; Mesta starts accepted account setup automatically when ready * See the [Onboarding requirement matrix](doc:onboarding-requirements) for capability-specific sender fields, UBO rules, representatives, documents, and the endpoint used to supply each requirement - [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) - taxIdentificationNumber (for business senders) Before updating a sender, always check the validation rules using: GET /v2/validation-rules/senders?ownerType=[individual|business]&country=[ISO 3166-1 alpha-2 code] - [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 its UBOs and authorized representatives. Available in test environments only — disabled in production. - [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 ownerType='business' and the specific country to determine exact documentation requirements. Multiple UBOs can be added by calling this endpoint multiple times. The total ownership percentage across all UBOs should not exceed 100%. Additional v2 details: * `pepDeclaration` is required. * `verificationReport` and `verificationReportFileName` are supported. * The total request payload size must be less than 10 MB. * `sofDocument` is required when any of the following is true: * UBO age is less than 25 * UBO age is greater than 60 * `pepDeclaration` is `true` * `address.country` is one of: `DZ`, `AO`, `BO`, `BG`, `BF`, `CM`, `CI`, `ET`, `HT`, `IQ`, `KE`, `LA`, `LB`, `ML`, `MC`, `MZ`, `NA`, `NP`, `NI`, `NG`, `SO`, `SY`, `VN`, `VG`, `YE` * `identity.countryCode` is one of: `DZ`, `AO`, `BO`, `BG`, `BF`, `CM`, `CI`, `ET`, `HT`, `IQ`, `KE`, `LA`, `LB`, `ML`, `MC`, `MZ`, `NA`, `NP`, `NI`, `NG`, `SO`, `SY`, `VN`, `VG`, `YE` * `pepQuestionnaire` is supported. It is required when `pepDeclaration` is `true`. * `pepQuestionnaire.declarationType` controls which section is required: `self` (for `SELF`) or `association` (for `IMMEDIATE_FAMILY` and `CLOSE_ASSOCIATE`). - [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 without creating a new link. * `GENERATE`: create the first verification link only when no previous selfie session exists. * `REGENERATE`: create a fresh verification link only when the latest session is `DECLINED` or `EXPIRED`. Response behavior: * `latestSession`: the most recent selfie verification session, or `null` if none exists. * `previousSessions`: older selfie verification sessions in reverse chronological order. - [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 when the UBO is younger than 25 or older than 60, when `pepDeclaration` is `true`, or when either `address.country` or `identity.countryCode` is one of: `DZ`, `AO`, `BO`, `BG`, `BF`, `CM`, `CI`, `ET`, `HT`, `IQ`, `KE`, `LA`, `LB`, `ML`, `MC`, `MZ`, `NA`, `NP`, `NI`, `NG`, `SO`, `SY`, `VN`, `VG`, `YE`. `pepQuestionnaire` is supported. When `pepDeclaration` is `true`, include `pepQuestionnaire` with `declarationType` and the matching conditional section (`self` or `association`). - [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 sender creation. Use this endpoint to check whether the sender has accepted the TOS, retrieve the active acceptance link, and verify whether the link has expired. - [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 creation of a deposit bank account for a sender on demand, in the requested currency (EUR, GBP, MXN, or USD). The account is provisioned with the appropriate banking provider based on currency. This is an asynchronous operation that may take up to 60 seconds to complete. - [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 — disabled in production. - [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 defaults to USD if omitted. - [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 to discuss enabling it. - [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 country and their file upload requirements. The `documentNumber`, `documentFront`, and `documentBack` nested fields are removed as their requirements are conveyed by `supportedDocumentTypes`. - [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 country and their file upload requirements. - [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)