Mercadopago

Workflow	Type	Description
mercadopago.addresses.create-customer-address	Atomic	Adds a shipping or billing address to a customer profile.
mercadopago.addresses.delete-customer-address	Atomic	Delete a customer address
mercadopago.addresses.get-customer-address	Atomic	Get a customer address
mercadopago.addresses.list-customer-addresses	Atomic	List customer addresses
mercadopago.addresses.update-customer-address	Atomic	Update a customer address
mercadopago.cancellations-refunds.cancel-payment	Atomic	Cancels a payment that is in pending or authorized status. Only payments that have not yet been captured or processed can be cancelled. For approved payments use the refunds endpoint instead.
mercadopago.cancellations-refunds.create-refund	Atomic	Creates a full or partial refund for an approved payment. Omit the amount field for a full refund. Partial refunds are supported; multiple partials are allowed up to the original transaction amount. Idempotent: Supports X-Idempotency-Key header to safely retry without duplicate charges.
mercadopago.cancellations-refunds.get-refund	Atomic	Get a specific refund
mercadopago.cancellations-refunds.list-refunds	Atomic	List refunds for a payment
mercadopago.cards.delete-card	Atomic	Delete a saved card
mercadopago.cards.get-card	Atomic	Get a saved card
mercadopago.cards.list-cards	Atomic	List customer cards
mercadopago.cards.save-card	Atomic	Saves a tokenized card to a customer profile for future payments. The token must be created client-side via MercadoPago.js. Raw card data must never pass through your server. PCI scope: Handling this endpoint brings your integration into PCI DSS scope.
mercadopago.cards.update-card	Atomic	Update a saved card
mercadopago.chargebacks.get-chargeback	Atomic	Get chargeback by ID
mercadopago.chargebacks.update-chargeback	Atomic	Upload chargeback documentation
mercadopago.claim-messages.attach-claim-file	Atomic	Uploads and attaches a file (image, PDF) to a claim. Supported formats: JPEG, PNG, PDF. Max size: 10 MB.
mercadopago.claim-messages.download-claim-file	Atomic	Download an attached file
mercadopago.claim-messages.get-claim-file	Atomic	Get attached file metadata
mercadopago.claim-messages.get-claim-messages	Atomic	Get claim messages
mercadopago.claim-messages.send-claim-message	Atomic	Sends a text message (with optional attachments) in the claim thread.
mercadopago.claim-resolutions.get-claim-mediation-resolutions	Atomic	Returns the possible resolution options for a claim at the mediation stage.
mercadopago.claim-resolutions.request-claim-mediation	Atomic	Escalates a claim to mediation, requesting MP to intervene in the dispute.
mercadopago.claim-shipping.upload-shipping-evidence	Atomic	Uploads shipping evidence (tracking code, proof of delivery) to support the seller's case in a claim. Accepted as part of the claims resolution process.
mercadopago.claims.get-claim	Atomic	Returns full details of a post-sale claim including status, stage, and players.
mercadopago.claims.get-claim-evidence	Atomic	Get claim evidence
mercadopago.claims.get-claim-history	Atomic	Get claim status history
mercadopago.claims.get-claim-reasons	Atomic	Returns the description and metadata for a specific claim reason code.
mercadopago.claims.search-claims	Atomic	Search claims
mercadopago.customers.create-customer	Atomic	Creates a customer profile for storing payment methods. The customer email is unique per account.
mercadopago.customers.delete-customer	Atomic	Permanently deletes a customer profile. This action cannot be undone. Saved cards associated with the customer will also be removed.
mercadopago.customers.get-customer	Atomic	Get customer by ID
mercadopago.customers.search-customers	Atomic	Search customers
mercadopago.customers.update-customer	Atomic	Update a customer
mercadopago.merchant-orders.create-merchant-order	Atomic	Webhook events triggered: merchant_order
mercadopago.merchant-orders.get-merchant-order	Atomic	Get merchant order
mercadopago.merchant-orders.search-merchant-orders	Atomic	Search merchant orders
mercadopago.merchant-orders.update-merchant-order	Atomic	Update merchant order
mercadopago.oauth.create-oauth-token	Atomic	Exchanges authorization codes for access tokens, refreshes expired tokens, or requests client credentials tokens for machine-to-machine flows. Security notes: - The state parameter is mandatory for authorization_code flows to prevent CSRF. - Store refresh tokens in server-side encrypted storage — never in localStorage. - Rotate client_secret regularly and store in a secrets manager.
mercadopago.orders.add-order-transaction	Atomic	Adds a payment transaction to an order. Only available when processing_mode=manual. The order must be in status=created.
mercadopago.orders.cancel-order	Atomic	Cancels an order and all its transactions. Only orders with status=action_required or status=created can be canceled.
mercadopago.orders.capture-order	Atomic	Fully captures a previously authorized order (capture_mode=manual). All associated authorized transactions are captured in full.
mercadopago.orders.create-order	Atomic	Creates an Order for processing payment transactions. Supports automatic (single-stage, set processing_mode=automatic) and manual (multi-stage, set processing_mode=manual) modes. In automatic mode, include the transactions.payments array with the payment method. In manual mode, omit transactions and add them later via POST /v1/orders/{id}/transactions, then trigger processing with POST /v1/orders/{id}/process. Available for: credit card, debit card, Pix (MLB), Boleto (MLB), OXXO (MLM), SPEI (MLM), PSE (MCO), Rapipago (MLA), Pago Fácil (MLA).
mercadopago.orders.delete-order-transaction	Atomic	Removes a transaction from a manual-mode order. Only available before processing.
mercadopago.orders.get-order	Atomic	Returns all order information for the given order ID.
mercadopago.orders.process-order	Atomic	Triggers processing of an order and all its transactions. Only available for manual-mode orders (processing_mode=manual). After calling this endpoint the order transitions to processed or action_required.
mercadopago.orders.refund-order	Atomic	Performs a full or partial refund of transactions associated with an order. For a full refund, send an empty request body (omit transactions). For a partial refund, include the transactions array with the specific transaction IDs and amounts to refund.
mercadopago.orders.search-orders	Atomic	Search for orders using date range and optional filters. begin_date and end_date are required.
mercadopago.orders.update-order-transaction	Atomic	Updates the payment method of a pending transaction on a manual-mode order.
mercadopago.payment-methods.get-installments	Atomic	Returns available installment plans for a given card BIN, amount, and site. Use this to populate installment selectors in your checkout.
mercadopago.payment-methods.list-payment-methods	Atomic	Returns all payment methods available for the credential's site_id. Use this to build payment method selectors and validate method availability before attempting a payment.
mercadopago.payments.create-payment	Atomic	Creates a payment. For card payments, generate a card token client-side via MercadoPago.js before calling this endpoint. For cash/offline methods (Boleto, OXXO, Pix), the response includes a payment URL in transaction_details.external_resource_url. Idempotency: Include X-Idempotency-Key to safely retry on network errors without risk of double charges. Recommendation: For new integrations, prefer the Orders API (POST /v1/orders). Idempotent: Supports X-Idempotency-Key header to safely retry without duplicate charges. Webhook events triggered: payment, merchant_order
mercadopago.payments.get-payment	Atomic	Get payment by ID
mercadopago.payments.search-payments	Atomic	Search payments
mercadopago.payments.update-payment	Atomic	Update payment fields or capture an authorized payment. To capture an authorized two-step payment: send {"capture": true}. To cancel an authorized payment: send {"status": "cancelled"}.
mercadopago.plans.create-subscription-plan	Atomic	Creates a recurring billing plan. Individual subscriptions reference this plan. The response includes init_point to send subscribers to authorize billing.
mercadopago.plans.get-subscription-plan	Atomic	Get subscription plan
mercadopago.plans.search-subscription-plans	Atomic	Search subscription plans
mercadopago.plans.update-subscription-plan	Atomic	Update a subscription plan
mercadopago.pos.create-pos	Atomic	Creates a point of sale in a store to receive payments for products or services. Each POS will have a unique QR code linked to it.
mercadopago.pos.delete-pos	Atomic	Delete a point of sale
mercadopago.pos.get-pos	Atomic	Get a point of sale
mercadopago.pos.list-pos	Atomic	List POS devices for a user
mercadopago.pos.search-pos	Atomic	Search points of sale
mercadopago.pos.update-pos	Atomic	Update a point of sale
mercadopago.preferences.create-preference	Atomic	Creates a Checkout Pro preference. The response contains init_point (production) and Webhook events triggered: payment, merchant_order
mercadopago.preferences.get-preference	Atomic	Get preference by ID
mercadopago.preferences.search-preferences	Atomic	Search preferences
mercadopago.preferences.update-preference	Atomic	Update a preference
mercadopago.stores.create-store	Atomic	Create a store
mercadopago.stores.delete-store	Atomic	Delete a store
mercadopago.stores.search-stores	Atomic	Search stores
mercadopago.stores.update-store	Atomic	Update a store
mercadopago.subscriptions.create-subscription	Atomic	Create a subscription
mercadopago.subscriptions.export-subscriptions	Atomic	Exports a list of subscriptions for a collector as a downloadable file. Filter by plan ID, status, and sort order.
mercadopago.subscriptions.get-subscription	Atomic	Get subscription
mercadopago.subscriptions.search-subscriptions	Atomic	Search subscriptions
mercadopago.subscriptions.update-subscription	Atomic	Update subscription status or billing details. Common use: {"status": "paused"} to pause, {"status": "authorized"} to resume, {"status": "cancelled"} to cancel.