API Reference.

import { RecaSmart } from "@recasmart/sdk";

const reca = new RecaSmart(); // lee RECASMART_API_KEY

const checkout = await reca.checkouts.create({
  amount: 15000,
  description: "Plan Pro - Marzo",
  external_reference: "order_1234",
});

// Redirigí al pagador acá:
console.log(checkout.payment_url);

curl -X POST "https://recasmart.online/api/public/checkout/create" \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{ "amount": 1500 }'

import { RecaSmart } from "@recasmart/sdk";

const reca = new RecaSmart(); // lee RECASMART_API_KEY

// El SDK genera la Idempotency-Key automáticamente
const checkout = await reca.checkouts.create({
  amount: 1500.50,
  currency: "ARS",
  description: "Plan Premium mensual",
  external_reference: "ORDER_123",
  webhook_url: "https://tu-sitio.com/webhook",
});

console.log(checkout.payment_url);

curl "https://recasmart.online/api/public/checkouts?status=pending&limit=20" \
  -H "Authorization: Bearer sk_live_..."

curl "https://recasmart.online/api/public/checkout/14b1abb3-1458-4f3d-8740-83e457a4596e/status"

curl -X POST "https://recasmart.online/api/public/checkout/14b1abb3-1458-4f3d-8740-83e457a4596e/intent" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "pix",
    "customerEmail": "[email protected]"
  }'

curl -X POST "https://recasmart.online/api/public/invoices/bulk" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '[
      {
        "amount": 15000.00,
        "first_due_date": "2026-04-10T23:59:59Z",
        "currency": "ARS"
      }
  ]'

curl -X POST "https://recasmart.online/api/public/checkout/create" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "currency": "BRL",
    "payment_method": "pix",
    "description": "Venda Teste PIX",
    "customer": {
      "name": "Cliente Brasil",
      "email": "[email protected]"
    }
  }'

import { RecaSmart } from "@recasmart/sdk";
const reca = new RecaSmart();

// PYG → tarjeta vía Bancard, automático
const checkout = await reca.checkouts.create({
  amount: 150000, // guaraníes, solo enteros
  currency: "PYG",
  description: "Plan Pro - Paraguay",
  external_reference: "order_py_001",
});

// checkout.cvu es null en este riel:
// el pagador paga con tarjeta en payment_url
console.log(checkout.payment_url);

# La máquina (vending, caja de súper, kiosco)
# pide su QR con su DEVICE KEY:
curl -X POST "https://recasmart.online/api/public/pos/POS_ID/checkout" \
  -H "Authorization: Bearer sk_test_DEVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 12000,
    "currency": "PYG",
    "description": "Coca-Cola 500ml",
    "external_reference": "vend12-slot4",
    "expires_in_seconds": 300
  }'

curl -X POST "https://recasmart.online/api/public/invoices/bulk" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "invoices": [
      {
        "amount": 15000.00,
        "first_due_date": "2026-04-10T23:59:59Z",
        "second_amount": 17500.00,
        "second_due_date": "2026-04-20T23:59:59Z",
        "external_reference": "FACT-10023",
        "currency": "ARS"
      }
    ]
  }'

<!-- 1. Agrega el script en tu <head> -->
<script src="https://recasmart.online/sdk/js/magic.js"></script>

<!-- 2. Abre el checkout cuando el cliente haga clic en Pagar -->
<script>
  window.RecaSmart.openCheckout({
    checkoutId: "14b1abb3-1458-...", // ID generado en tu backend
    onSuccess: (data) => {
      console.log("¡Pago exitoso!", data);
      window.location.href = "/gracias";
    },
    onClose: () => {
      console.log("El cliente cerró el modal");
    }
  });
</script>

curl "https://recasmart.online/api/public/transactions?status=COMPLETED&start_date=2026-01-01&end_date=2026-02-01&limit=20" \
  -H "Authorization: Bearer sk_live_..."

curl "https://recasmart.online/api/public/settlements?limit=10" \
  -H "Authorization: Bearer sk_live_..."

curl -X POST "https://recasmart.online/api/public/subscriptions/plans" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Plan Mensual Pro",
    "description": "Acceso completo a la plataforma",
    "amount": 5000,
    "currency": "ARS",
    "interval_unit": "month",
    "interval_count": 1,
    "trial_period_days": 7,
    "grace_period_days": 3
  }'

{
  "type": "checkout.completed",
  "data": {
    "checkout_id": "14b1abb3-1458-4f3d-8740-83e457a4596e",
    "transaction_id": "a3f8c2d1-9b7e-4f3a-bc21-5d8e1f2a9c4b",
    "status": "COMPLETED",
    "amount": 1500.50,
    "currency": "ARS",
    "external_reference": "ORDER_123",
    "paid_at": "2026-02-19T12:05:22Z"
  },
  "timestamp": "2026-02-19T12:05:23Z"
}

import { constructEvent } from "@recasmart/sdk";

// Next.js App Router
export async function POST(req: Request) {
  const body = await req.text(); // ← CRUDO, sin parsear

  // Valida firma + ventana anti-replay.
  // Lanza WebhookSignatureError si no valida.
  const event = await constructEvent(
    body,
    req.headers,
    process.env.RECASMART_WEBHOOK_SECRET!
  );

  if (event.type === "checkout.completed") {
    await activarCuenta(event.data.external_reference);
  }
  return new Response("ok");
}

1. Descarga el plugin ZIP desde nuestro portal.
2. En WordPress: Plugins → Añadir nuevo → Subir.
3. Configuración: Ingresa tu API Key y Webhook Secret.
4. Verifica el endpoint de webhook: ?wc-api=recasmart

# Un solo comando desde tu proyecto:
claude mcp add recasmart \
  -e RECASMART_API_KEY=sk_test_... \
  -- npx -y @recasmart/mcp

# O compartilo con tu equipo versionando .mcp.json
# en la raíz del repo:
# {
#   "mcpServers": {
#     "recasmart": {
#       "command": "npx",
#       "args": ["-y", "@recasmart/mcp"],
#       "env": { "RECASMART_API_KEY": "sk_test_..." }
#     }
#   }
# }