> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesadepagos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Summary of new ON RAMP features and changes.

Review the changes in each release and open the related documentation for contracts, examples, and testing instructions.

<Update label="July 20, 2026" description="v2.2.0">
  ## Crypto, payouts, and prefunding

  This release improves crypto operation tracking, makes Payout ACH v3 references more flexible, and automates prefunding processing.

  ### Automatic crypto deposit registration

  Deposits received at a wallet address are now registered automatically after blockchain confirmation. Each deposit is linked to the corresponding business and wallet, including its amount, asset, blockchain, and transaction hash.

  <Card title="View the crypto deposit flow" icon="download" href="/en/wallet#crypto-deposits">
    Learn how to receive funds and track their confirmation.
  </Card>

  ### Crypto webhooks with transaction hashes

  Crypto deposit and withdrawal notifications may now include `transactionHash`, in addition to `amount`, `asset`, `blockchain`, and, when applicable, `walletId`. Use the hash to verify the operation in a blockchain explorer.

  <Card title="View webhook contracts" icon="bell" href="/en/webhooks#crypto-transaction-payloads">
    Review the updated `deposit_crypto` and `withdrawal_crypto` payloads.
  </Card>

  ### Default network for new wallets by environment

  New wallets include `USDC` as their default asset. The assigned blockchain depends on the environment: `Ethereum` in Sandbox and `Polygon` in Production. Existing wallet assets are not changed.

  <Warning>
    Before transferring funds, always check the `blockchain` returned by the API
    and use the same network in the source wallet.
  </Warning>

  ### Controlled payout balance response

  Payout ACH and Payout QR balance queries now preserve a valid response when the balance provider is temporarily unavailable. In this case, the API returns zero balances until service is restored.

  <Card title="Retrieve payout balances" icon="scale-balanced" href="/en/queries#payout-balances">
    Review the balance endpoint and its response contract.
  </Card>

  ### Flexible references in Payout ACH v3

  The required Payout ACH v3 `external_reference` field now accepts partner-defined text references and no longer requires UUID v4 format. This lets partners use their own order or operation identifiers.

  <Card title="View Payout ACH v3" icon="building-columns" href="/en/payout#ach-payout">
    Review the request, validations, and payout response.
  </Card>

  ### Automatic prefunding processing

  Prefunding operations now continue automatically with bank processing after receipt of funds is confirmed. The reference number generated by the provider is linked to the transaction for easier traceability.
</Update>

<Update label="July 13, 2026" description="v2.1.0">
  ## Wallets, crypto, and PIX

  This release extends API v2 with wallet operations, crypto deposits and payouts, and instant PIX payments.

  ### Wallet management

  New endpoints create and list wallets, associate blockchain assets, and retrieve available balances.

  <Card title="View Wallet documentation" icon="wallet" href="/en/wallet">
    Review endpoint contracts and creation and retrieval examples.
  </Card>

  ### Crypto deposits

  Addresses associated with a wallet can now receive crypto deposits whose balance can be retrieved later.

  <Card title="View the crypto deposit flow" icon="download" href="/en/wallet#crypto-deposits">
    Learn how to obtain an address, transfer funds, and validate the deposit.
  </Card>

  ### Crypto payouts

  Partners can now send `USDC` and `USDT` from an internal wallet to an external address on Polygon, Ethereum, or TRON.

  <Card title="View Crypto Payout documentation" icon="arrow-up-right" href="/en/payout-crypto">
    Review the request, response, validations, and Sandbox example.
  </Card>

  ### PIX payouts

  Instant `BRL` payments to Brazil are now available with balance or crypto conversion funding.

  <Card title="View PIX Payout documentation" icon="bolt" href="/en/payout#pix-payout">
    Review the supported PIX keys and the response for each funding mode.
  </Card>

  ### Crypto webhooks

  Crypto deposit and withdrawal notifications now include `amount`, `asset`, `blockchain`, and, when applicable, `walletId`.

  <Card title="View webhook contracts" icon="bell" href="/en/webhooks#crypto-transaction-payloads">
    Review the `deposit_crypto` and `withdrawal_crypto` payloads.
  </Card>

  <Warning>
    If your integration already processes crypto webhooks, use `asset` and
    `blockchain` instead of relying on `currency`.
  </Warning>
</Update>