Skip to main content
Todos los casos de uso
Compras / Tiendas admitidasOperations

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.

AntesReponer a mano en el sitio de la tienda, cada ciclo
DespuésEl agente compra en la tienda admitida y paga dentro del mandato
Pix
el Pix de la propia tienda, pagado dentro del mandato
Pruébalo en el Sandbox
VTEX · ML
Tiendas admitidas
Cobasi, Animale, Lojas Pompeia y Mercado Livre; no un catálogo de tus proveedores
1–2 min
El checkout de la tienda
La tienda arma el pedido en un flujo de navegador; el agente consulta hasta que está listo
auto_pay
Pagado bajo el mandato
auto_pay paga el Pix de la tienda desde la billetera del consumidor, dentro del mandato
paid
Comprobante
El pedido pagado vuelve con un recibo del pago
Ejemplo ilustrativo · datos de demostración

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.

Compra en tienda admitida · ejemplo
chk_demo · Cobasi (VTEX)
Pagado · ejemplo
TiendaCobasi · VTEX
ArtículosAreia higiênica 4 kg ×2
TotalR$ 89,80
Mandatomnd_demo · tope por transacción
Pixgenerado por la tienda · pagado con auto_pay
checkout-status.json
✓ pagado · ejemplochk_demo
El problema

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

Cómo lo hace el agente

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.

01
Buscar
codespar_shop

El catálogo en vivo de la tienda

Tienda admitida
02
Checkout
codespar_shop

Inicia el checkout real (1–2 min)

El checkout de la tienda
03
Estado
codespar_shop

Consulta hasta ready_for_payment

checkout_status
04
Pagar
codespar_shop

auto_pay · Pix desde la billetera, dentro del mandato

Billetera del consumidor
05
Recibo
CodeSpar

El pedido pagado vuelve con un recibo

Arquitectura

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.

En código

El código, y lo que supone.

storefront-reorder.ts
// 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.

Herramientas destacadas
codespar_shop

Busca, inicia el checkout y consulta su estado en las tiendas admitidas (Cobasi, Animale, Lojas Pompeia, Mercado Livre).

codespar_shop · auto_pay

Paga el Pix del pedido desde la billetera del consumidor, dentro del mandato, y devuelve un recibo del pago.

codespar_pay

Otra forma de pagar: pasa el checkout_session_id y el consumer_id; el backend resuelve el código Pix exacto.

Ver la referencia de meta-tools

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.

Agente de compras en tienda online — CodeSpar | CodeSpar