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.

Mude para uma chave de teste.

Uma chave sk_test_ transaciona na Base Sepolia; uma chave sk_live_ transaciona na mainnet da Base. O prefixo escolhe a rede - não há variável de ambiente de rede separada, e uma chave de teste não pode mover fundos da mainnet. Portanto, tudo o que você muda para um ambiente de desenvolvimento é a chave (e o segredo do webhook de teste).

# .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

Faça um pagamento de teste real.

Com a carteira financiada, chame payments.create na sua chave sk_test_. É uma transferência real no Base Sepolia usando fundos de teste, e dispara o webhook payment.received exatamente como a mainnet faria - então você exercita o caminho de código real, não uma simulação. Observe o evento chegar ao seu manipulador 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

Três cenários para exercitar no mínimo: um pagamento que chega (o caminho feliz, payment.received), um pagamento que nunca chega (aponte o webhook para uma URL morta e confirme que sua varredura de reconciliação captura o trabalho preso - o caminho que a maioria das equipes ignora) e uma nova tentativa de webhook (force um 500 na primeira vez e 200 na segunda, então verifique se sua idempotência pulou o trabalho duplicado).

Falhe rapidamente em chaves mal configuradas.

O incidente de produção mais comum em torno de chaves de teste/produção é silencioso: uma implementação chega com uma chave de teste, nenhum pagamento passa, alertas só disparam após o próximo dia útil. Bloqueie isso na inicialização: recuse-se a iniciar se as variáveis de ambiente e o prefixo da chave não corresponderem.

// 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.")

Uma vez que o loop de teste está no seu ciclo de desenvolvimento.

Com um loop de teste saudável em funcionamento, o trabalho restante é principalmente de fortalecimento: manipulação confiável de webhook sob carga, uma lista de verificação de segurança final e migrações de qualquer provedor de pagamento anterior que você possa estar usando.

Referência completa em docs.blockchain0x.com. Detalhes da Testnet: Glossário da cadeia Base. Superfície do produto: API de Pagamento.