如何在Mercado Pago Checkout Bricks中启用钱包支付选项？

开发者阿泽

2026-6-20

解决Mercado Pago Checkout Bricks钱包支付选项缺失问题

1. 检查测试环境账号与凭证

确认你的Sandbox测试账号已开启Mercado Pago钱包的测试权限：登录Sandbox后台，找到钱包设置项，确保测试环境的钱包支付功能处于启用状态。
核对public_key和access_token，必须使用Sandbox环境的凭证，避免与生产环境凭证混用。

2. 修正Preference配置

创建Preference时，不要将wallet_purchase加入排除支付方式列表，甚至可以主动明确允许：

const preference = {
  items: [/* 你的商品数据 */],
  payment_methods: {
    excluded_payment_methods: [], // 不要包含wallet_purchase
    excluded_payment_types: []
  }
};

确认back_urls和notification_url配置正常，Sandbox环境无需正式域名，但需保证地址可访问（测试时可使用ngrok临时映射）。

3. 调整Bricks初始化代码

初始化支付Brick时，显式开启钱包选项：

mp.bricks().create('payment', 'payment_brick_container', {
  initialization: {
    preferenceId: '你的preferenceID'
  },
  customization: {
    paymentMethods: {
      wallet: true // 强制开启钱包支付选项
    }
  }
});

如果控制台提示wallet_purchase不存在，大概率是SDK版本过低，将引入的SDK替换为最新稳定版，比如https://sdk.mercadopago.com/js/v2。

4. 替代方案：单独集成Wallet Brick

若全量支付Bricks仍无法显示钱包，可单独集成Wallet Brick作为补充：

mp.bricks().create('wallet', 'wallet_brick_container', {
  initialization: {
    preferenceId: '你的preferenceID'
  },
  callbacks: {
    onError: (err) => console.error(err),
    onReady: () => {}
  }
});

将该Brick放置在全量支付Brick旁，单独提供钱包支付入口。