mercadopago

Commerce Agents Checkout — Development skill for Claude Code

Development community

Python adapter that plugs Mercado Pago Checkout Pro into the StorefrontBackend handoff from anthropics/commerce-agents, verifies every cart price against your own catalog and returns a validated hoste.

How to install Commerce Agents Checkout

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mercadopago/commerce-agents-checkout and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Commerce Agents Checkout does

Python adapter that plugs Mercado Pago Checkout Pro into the StorefrontBackend handoff from anthropics/commerce-agents, verifies every cart price against your own catalog and returns a validated hosted payment link.

Alternatives in Development

  • Internet Court Skill — The trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 4.9k ★
  • Commerce Agents — Reference blueprint for building shopping and merchant agents with Claude 2.6k ★
  • Agentic Stack — One brain, many harnesses 2.2k ★

README

Mercado Pago Checkout Pro for commerce-agents

`mercadopago-commerce-agents-checkout` is an independent Mercado Pago integration that helps a seller backend implement the `StorefrontBackend` handoff from [`anthropics/commerce-agents`](https://github.com/anthropics/commerce-agents). It creates a Checkout Pro Order and returns its validated hosted payment link.

**Not affiliated with, endorsed by, or maintained by Anthropic.** Wire the adapter into the backend you already implement for the agent:

class MyBackend(StorefrontBackend):
    def __init__(self, token, attempt_store):
        self.mercadopago = MercadoPagoCheckout(sdk=mercadopago.SDK(token), catalog=self)
        self.attempt_store = attempt_store  # implemented durably by the seller

    async def checkout_handoff(self, session, cart):
        attempt = await self.attempt_store.get_or_create(session, cart)
        return await self.mercadopago.checkout_handoff(
            session,
            cart,
            external_reference=attempt.external_reference,
            idempotency_key=attempt.idempotency_key,
            # Set once this attempt has already ended in CheckoutOutcomeUnknown.
            recovering=attempt.outcome_unknown,
        )

commerce-agents still calls the backend method with exactly two arguments. The backend must create and durably persist both identifiers before calling the inner adapter, then reuse that same pair for every retry of the confirmed purchase. A retry that follows a `CheckoutOutcomeUnknown` needs one thing more: either pass `recovering=True`, so that a refusal decided locally raises instead of releasing your fallback, or refuse to call the adapter at all until the attempt is reconciled, which is what [`examples/seller_integration.py`](https://github.com/mercadopago/commerce-agents-checkout/blob/main/examples/seller_integration.py) does. Persisting the two identifiers without also persisting *that the outcome was unknown* leaves the original gap open. Wha