Swap your API key for a sk_test_ key - that alone puts you on Base Sepolia. Fund the agent's wallet from the public Base Sepolia USDC faucet, make a real test payment with payments.create (test funds, no real money), and tunnel your local webhook through ngrok. The response shapes match live, so a flow that passes in test passes in production. Exercise the failure paths, not just the happy one.

Cambia a una clave de prueba.

Una clave sk_test_ transacciona en Base Sepolia; una clave sk_live_ transacciona en la mainnet de Base. El prefijo elige la red - no hay una variable de entorno de red separada, y una clave de prueba no puede mover fondos de la mainnet. Así que todo lo que cambias para un entorno de desarrollo es la clave (y el secreto del webhook de prueba).

# .env.development
# A sk_test_ key picks Base Sepolia automatically - there is no network env var.
BLOCKCHAIN0X_API_KEY=sk_test_01J9...
BLOCKCHAIN0X_WEBHOOK_SECRET=...   # the test webhook's secret, from the dashboard

Realiza un pago de prueba real.

Con la billetera financiada, llama a payments.create en tu clave sk_test_. Es una transferencia real en Base Sepolia utilizando fondos de prueba, y activa el webhook payment.received exactamente como lo haría mainnet - así que ejercitas la ruta de código real, no una simulación. Observa cómo el evento llega a tu manejador tunelado.

// On a sk_test_ key this is a REAL transfer on Base Sepolia (test funds, no
// real money). It fires the payment.received webhook just like mainnet does.
const tx = await client.payments.create({
  agentId: "agt_123",
  to: "0xRecipientOnSepolia",
  amountWei: "10000", // 0.01 USDC
});

console.log(tx); // watch payment.received arrive at your webhook

tx = client.payments.create(body={
    "agentId": "agt_123",
    "to": "0xRecipientOnSepolia",
    "amountWei": "10000",  # 0.01 USDC
})

print(tx)  # watch payment.received arrive at your webhook

Tres escenarios para ejercitar como mínimo: un pago que llega (el camino feliz, payment.received), un pago que nunca llega (apunta el webhook a una URL muerta y confirma que tu barrido de reconciliación captura el trabajo atascado - el camino que la mayoría de los equipos ignoran), y un reintento de webhook (fuerza un 500 la primera vez y 200 la segunda, luego verifica que tu idempotencia omitió el trabajo duplicado).

Fallar rápido en claves mal configuradas.

El incidente de producción más común relacionado con claves de prueba/vivas es silencioso: un despliegue llega con una clave de prueba, no llegan pagos, las alertas solo se activan después del siguiente día hábil. Bloquea esto al inicio: rechaza iniciar si las variables de entorno y el prefijo de la clave no coinciden.

// Fail fast if test/live get mixed up.
const apiKey = process.env.BLOCKCHAIN0X_API_KEY!;
const env = process.env.NODE_ENV;

if (env === "production" && apiKey.startsWith("sk_test_")) {
  throw new Error("Test key in production environment - aborting boot.");
}
if (env !== "production" && apiKey.startsWith("sk_live_")) {
  throw new Error("Live key in non-production environment - aborting boot.");
}

import os, sys

api_key = os.environ["BLOCKCHAIN0X_API_KEY"]
env = os.environ.get("ENV", "development")

if env == "production" and api_key.startswith("sk_test_"):
    sys.exit("Test key in production environment - aborting boot.")
if env != "production" and api_key.startswith("sk_live_"):
    sys.exit("Live key in non-production environment - aborting boot.")

Una vez que el bucle de prueba esté en tu ciclo de desarrollo.

Con un bucle de prueba saludable en su lugar, el trabajo restante es principalmente endurecimiento: manejo confiable de webhooks bajo carga, una lista de verificación de seguridad final y migraciones de cualquier proveedor de pago anterior que puedas estar utilizando.

Referencia completa en docs.blockchain0x.com. Detalles de Testnet: glosario de la cadena Base. Superficie del producto: API de Pago.