El agente compra en una tienda admitida y paga dentro del mandato.
Para compras recurrentes en las tiendas que admite codespar_shop: Cobasi, Animale y Lojas Pompeia (VTEX), y Mercado Livre con la sesión conectada del comprador. El agente busca en el catálogo en vivo, inicia el checkout real de la tienda, un flujo de navegador de uno a dos minutos, y cuando el pedido está listo el Pix de la tienda se paga desde la billetera del consumidor, dentro del mandato. Qué tienda, qué artículos y cuándo reponer siguen siendo lógica de tu agente.
Un pedido en una tienda admitida, pagado dentro del mandato.
Un ejemplo con datos de demostración: el agente busca en el catálogo de Cobasi, inicia el checkout de la tienda con los artículos elegidos, consulta hasta que el pedido está listo para pagar y, con auto_pay, el Pix de la tienda se paga desde la billetera del consumidor dentro del mandato.
- Solo tiendas que admite codespar_shop: Cobasi, Animale, Lojas Pompeia y Mercado Livre
- El checkout es el de la propia tienda: el agente consulta hasta ready_for_payment
- El Pix de la tienda se paga desde la billetera del consumidor, dentro del mandato
Reponer arena para gatos cuando se esté acabando.
Buscando en Cobasi el mismo artículo de la última compra e iniciando el checkout de la tienda.
La conversación es la parte fácil.
Las compras recurrentes de bajo valor rara vez tienen una integración: alguien abre el mismo sitio, busca los mismos artículos, rearma el carrito y paga con una tarjeta compartida que nadie controla.
Abrir la tienda y rearmar el mismo carrito en cada reposición
El agente busca en el catálogo en vivo e inicia el checkout de la tienda
Pagar con una tarjeta compartida, sin tope ni responsable
El Pix de la tienda se paga desde la billetera del consumidor, dentro del mandato
Copiar a mano el código Pix del pedido
auto_pay paga el pedido del lado del servidor; el agente no maneja el código Pix
Buscar el correo de confirmación para probar el pago
El pedido pagado vuelve con un recibo del pago
Shop compra en las tiendas que admite.
codespar_shop actúa como comprador en las tiendas admitidas: action=search devuelve el catálogo en vivo, action=checkout inicia el checkout real de la tienda y action=checkout_status consulta el pedido hasta que está listo para pagar. Con auto_pay y el consumer_id, el Pix de la tienda se paga desde la billetera gobernada del consumidor, dentro del mandato. Qué tienda, qué artículos y cuándo reponer son decisiones de tu agente.
codespar_shopEl catálogo en vivo de la tienda
Tienda admitidacodespar_shopInicia el checkout real (1–2 min)
El checkout de la tiendacodespar_shopConsulta hasta ready_for_payment
checkout_statuscodespar_shopauto_pay · Pix desde la billetera, dentro del mandato
Billetera del consumidorEl pedido pagado vuelve con un recibo
El agente usa codespar_shop en una tienda admitida: busca en el catálogo en vivo, inicia el checkout de la tienda (un flujo de navegador que responde de inmediato con un checkout_session_id) y consulta checkout_status hasta ready_for_payment. Con auto_pay, el backend paga el Pix de la tienda desde la billetera gobernada del consumidor, dentro del mandato, y responde status "paid" con un recibo del pago. En Mercado Livre el checkout usa la sesión conectada del comprador.
El código, y lo que supone.
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…), a consumer // (user_0000) with a signed mandate and a funded wallet, and a store that // codespar_shop supports: cobasi, animale or lojaspompeia (VTEX), or meli // (Mercado Livre, with the buyer's connected login). import { CodeSpar } from "@codespar/sdk"; const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 1 · search the store's live catalog; each offer carries a sku_id const found = await session.execute("codespar_shop", { action: "search", merchant: "cobasi", query: "areia higiênica" }); console.log(found.data); // 2 · start the store's real checkout; it answers at once with status "in_progress" const started = await session.execute("codespar_shop", { action: "checkout", merchant: "cobasi", items: [{ variant_id: "<sku_id from the search>", quantity: 2 }], }); const { checkout_session_id } = started.data as { checkout_session_id: string }; // 3 · poll; once the order is ready, auto_pay pays the store's Pix from the // consumer's wallet, inside the mandate, and answers status "paid" let status: string | undefined; do { await new Promise((r) => setTimeout(r, 15_000)); const res = await session.execute("codespar_shop", { action: "checkout_status", checkout_session_id, consumer_id: "user_0000", auto_pay: true, }); status = (res.data as { status?: string }).status; } while (status === "in_progress"); console.log(status); // "paid", or "canceled" with a reason
Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.
codespar_shopBusca, inicia el checkout y consulta su estado en las tiendas admitidas (Cobasi, Animale, Lojas Pompeia, Mercado Livre).
codespar_shop · auto_payPaga el Pix del pedido desde la billetera del consumidor, dentro del mandato, y devuelve un recibo del pago.
codespar_payOtra forma de pagar: pasa el checkout_session_id y el consumer_id; el backend resuelve el código Pix exacto.
Empieza con una clave de prueba.
Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.