Dashboard
DocsTelegram & Discord Subscription Bot — Mercado Pago Setup

Mercado Pago for Your Telegram & Discord Subscription Bot

Use Mercado Pago hosted checkout to accept payments for your Telegram subscription bot or Discord subscription bot. BotSubscription grants membership access after verifying the payment.

This integration supports individual payments. Members choosing a recurring plan must pay manually for each renewal; it does not provide automatic recurring charges or saved payment methods.

Prepare Mercado Pago for subscription payments

Create a separate Mercado Pago application for each merchant connection. In the developer dashboard, open Your integrations, select the application, and find its Credentials.

Copy its Access Token, beginning with APP_USR. Keep this token private. If you configure a webhook signature secret, have that value ready too.

Supported currencies are ARS, BRL, CLP, COP, MXN, PEN, and UYU. Use a currency supported by your Mercado Pago account and country.

Connect Mercado Pago to your subscription bot

  1. Open Settings → Merchant Accounts → Install Merchant Account in your project's bot.
  2. Select Mercado Pago and choose the environment for your account.
  3. Enter the Access Token and, when configured, the webhook signature secret.
  4. Submit the form and copy the webhook URL supplied by BotSubscription.

Follow the subscription bot testing guide when choosing between Sandbox and Production. Use the credentials requested by the installation form for that environment.

Configure Mercado Pago payment notifications

Review the Mercado Pago Checkout Pro requirements for the provider's current dashboard instructions.

Open your application's Webhooks → Configure notifications screen. Set the URL from BotSubscription and enable Payments and Chargebacks notifications. Copy the signature secret into the account configuration in BotSubscription.

Send a simulated signed notification from Mercado Pago to verify the webhook. Payment processing can work without the optional signature secret, but the account's webhook remains unverified. BotSubscription checks the payment with Mercado Pago when handling a notification.

Provider notifications update payments in BotSubscription. Use outbound project webhooks separately if your own application needs payment events.

Verify checkout and subscription access

Complete a test purchase and confirm that the payment completes and the expected membership access appears. If notifications fail, check that the URL, application credentials, and signature secret belong to the same connection.

Compare available payment options in the subscription payment currency guide.

Last updated: