Mercado Pago Payment Setup Guide
Updated October 31, 2026 · 7 min read
In this guide
- Accept Booking Payments with Mercado Pago
- Before you begin
- Step 1 – Create a Mercado Pago application
- Step 2 – Add your credentials in Accurate Scheduler
- Step 3 – Check your business currency
- Step 4 – Configure a signed webhook (optional)
- Step 5 — Test a booking payment
- How Mercado Pago booking payments work
- Using Mercado Pago with Deposit Payments
- Troubleshooting Mercado Pago Payment Integration
- Related payment guides
Accept Booking Payments with Mercado Pago
Use the Mercado Pago Payment Integration in Accurate Scheduler to collect online appointment payments through Mercado Pago’s hosted checkout in supported Latin American countries. Customers complete payment on Mercado Pago and return to your booking page; they do not enter their card details directly into Accurate Scheduler.
Mercado Pago is included in paid Accurate Scheduler plans. Availability depends on your Mercado Pago account’s country, compatible business currency and configured credentials. Payment methods and provider charges vary by account and region.
USD is not supported by this integration. Accurate Scheduler’s Mercado Pago settings list ARS, BRL, MXN, CLP, COP, PEN and UYU. Use the currency supported by your account’s country; this list does not mean one account can accept all seven currencies.
Before you begin
- An Accurate Scheduler account on a paid plan, with permission to manage payment settings.
- An eligible Mercado Pago account and access to Mercado Pago Developers.
- A Mercado Pago application configured for Checkout Pro and its Access Token.
- A business currency compatible with the Mercado Pago account.
Open Mercado Pago Developers ↗
Step 1 – Create a Mercado Pago application
- Sign in to Mercado Pago Developers and open Your integrations.
- Choose Create application.
- Select the appropriate online payment integration and choose Checkout Pro.
- Complete the application creation process for your account and country.
- Open the application’s credentials. Select the environment you intend to use before copying the Access Token.
Checkout Pro is a hosted payment experience. Available payment methods are determined by Mercado Pago and the account, rather than by a universal list of methods in Accurate Scheduler.
Step 2 – Add your credentials in Accurate Scheduler
- Open Settings → Payments.
- Find Mercado Pago and enable its toggle.
- Keep or update the customer-facing Label.
- Paste the application’s Access Token into its field.
- Optionally enter the Public Key. The current redirect checkout flow does not require it.
- Select Test connection. Review the result and any account-country or currency information returned.
- Select Save Payment Settings.

Test versus production: the supplied UI shows TEST-… and APP_USR-… examples. Test tokens commonly use TEST- and production tokens commonly use APP_USR-, but the prefix alone is not proof of the environment. Mercado Pago’s current Checkout Pro test-account documentation also describes test Access Tokens beginning with APP_USR. Confirm the selected environment and seller test account in the developer dashboard. See Mercado Pago’s test-account guidance ↗.
Keep credentials private. Never publish production Access Tokens or webhook secrets, or include them in screenshots, support messages or documentation examples. The masked fields in the settings are not a reason to share the underlying values.

Step 3 – Check your business currency
Check the business currency in Accurate Scheduler settings before offering Mercado Pago. The integration checks compatibility with the Mercado Pago account. An unsupported or mismatched currency can keep Mercado Pago hidden on the public booking form even when its toggle is enabled.
- ARS – Argentine Peso
- BRL – Brazilian Real
- MXN – Mexican Peso
- CLP – Chilean Peso
- COP – Colombian Peso
- PEN – Peruvian Sol
- UYU – Uruguayan Peso
For example, a business configured in USD cannot offer Mercado Pago through this integration. Do not switch currencies casually: first review existing service prices, bookings and payment records. Changing a currency setting is not a currency conversion of historical amounts. Confirm the supported local currency for your own account.
Step 4 – Configure a signed webhook (optional)
The current Accurate Scheduler settings explain that each checkout already supplies a payment notification URL to Mercado Pago. You may additionally configure an application-level signed webhook.
- Open your Mercado Pago application and its Webhooks configuration.
- In Accurate Scheduler, open Settings → Payments → Mercado Pago.
- Copy the Webhook URL displayed in your own workspace.
- Paste that exact URL into the appropriate test or production webhook configuration in Mercado Pago.
- Select the Payments event and save the configuration.
- Reveal and copy the webhook’s secret signature.
- Paste it into Accurate Scheduler’s Webhook secret field.
- Select Save Payment Settings.
No example workspace endpoint is supplied here: use the generated URL in your workspace. When a webhook secret is configured, the settings specify that notifications with an invalid signature are rejected. This does not mean unsigned notifications are always rejected when no secret is configured. Keep the secret private and use the matching environment. See Mercado Pago’s payment-notification guide ↗.
Step 5 — Test a booking payment
- Use Mercado Pago’s documented test environment, seller/buyer test accounts and test credentials for your account country.
- Save the test credentials in Accurate Scheduler’s payment settings.
- Open your public booking page, preferably in a separate private browser session for the test buyer.
- Select a service and an appointment time, then choose Mercado Pago as the payment method.
- Complete Mercado Pago’s test checkout with its currently documented test card and test-buyer data. Never use real card data for testing.
- Return to Accurate Scheduler and inspect the appointment’s payment record and status.
- Test both a successful and rejected payment before preparing a live configuration.
Mercado Pago’s documented test-cardholder names include APRO for an approved payment and OTHE for a general rejection. These are simulated outcomes, not credentials or live-payment instructions. Test cards, identity-document values and account requirements depend on country and the current provider documentation. Use the appropriate regional version of Mercado Pago’s test-purchase guide ↗; do not copy a different country’s identity-document example.
Before accepting real payments, select the production environment, replace test credentials with the correct production credentials and review account approval, currency and payment settings. This guide does not verify your own payment connection or run transactions for you.
How Mercado Pago booking payments work
- Customer books an appointment — selects the service and booking details.
- Selects Mercado Pago — when the enabled gateway and currency are compatible.
- Completes payment on Mercado Pago — through its secure hosted checkout.
- Accurate Scheduler verifies and records the payment — based on the server-side integration’s payment verification.
Returning to the booking page is not, by itself, proof of payment. Check the verified payment record, not only the browser’s return screen. Some payment methods or notifications may remain pending; instant confirmation is not guaranteed for every case.
Using Mercado Pago with Deposit Payments
Mercado Pago may be available for supported online deposit or balance-payment flows, depending on the current Accurate Scheduler integration and your configured payment method. Do not assume that every deposit type is supported.
Refundable security authorization holds are not handled by Mercado Pago in this integration. The supplied application settings identify supported Stripe or PayPal flows for security holds. Review the provider requirements for the deposit type you choose in the Deposit Payment setup guide.
Troubleshooting Mercado Pago Payment Integration
Mercado Pago does not appear on my booking form
Confirm the gateway is enabled, credentials are valid and payment settings were saved. Check the account country, the account’s supported currency and the business currency in Accurate Scheduler. USD and unsupported or mismatched currencies keep Mercado Pago unavailable. Confirm that your Accurate Scheduler plan includes Mercado Pago. Test connection fails
Check the Access Token, selected test or production environment, account/application status and network connectivity. Re-copy the token from the intended application without spaces. Do not infer the environment solely from the token prefix. If it still fails, note the error and contact support without sending the token. Payment completed, but the booking is not marked paid
Inspect the server-verified payment status, payment records and application logs. Review the workspace webhook URL, selected event, environment and matching webhook secret if configured. A browser return or customer screenshot is not payment verification. Do not manually mark an unverified payment successful; investigate or contact support. Can I accept USD?
Not through the currently documented Mercado Pago integration. Use a supported local currency compatible with your account after reviewing the effect on existing prices and records, or use another gateway compatible with the intended currency. Is the Public Key required?
The current Accurate Scheduler redirect checkout flow treats it as optional. The Access Token is needed for the connection. Follow the fields and help text shown in your workspace. Are webhooks mandatory?
The settings state that checkout creation already supplies a payment notification URL. A separately configured, signed application webhook is optional in this configuration. Copy your workspace’s exact URL and save its secret if you choose to configure it.
Related payment guides
- Payment integrations overview
- Stripe payment setup
- PayPal payment setup
- Deposit Payment setup
- Payment features and supported gateways
- Compare plan availability
For Paystack hosted checkout, see the Paystack Payment Setup Guide for API keys, separate Test/Live webhooks and account-currency eligibility. Paystack requires a paid plan and is not offered for Accurate Scheduler security authorization holds.
Need a hand with your setup?
Tell us which step you reached and what happened. Keep passwords and client secrets out of your message.
Contact Accurate Scheduler →