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.

Переключиться на тестовый ключ.

Ключ sk_test_ транзакционируется на Base Sepolia; ключ sk_live_ транзакционируется на основной сети Base. Префикс выбирает сеть - нет отдельной переменной окружения сети, и тестовый ключ не может перемещать средства основной сети. Поэтому все, что вам нужно изменить для среды разработки, это ключ (и секрет вебхука для тестирования).

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

Сделать реальный тестовый платеж.

С пополненным кошельком вызовите payments.create на вашем ключе sk_test_. Это реальный перевод на Base Sepolia с использованием тестовых средств, и он вызывает вебхук payment.received точно так же, как это сделала бы основная сеть - так вы используете фактический код, а не симуляцию. Следите за тем, как событие попадает в ваш туннелированный обработчик.

// 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

Три сценария, которые нужно протестировать как минимум: платеж, который поступает (счастливый путь, payment.received), платеж, который никогда не поступает (укажите вебхук на недоступный URL и подтвердите, что ваша проверка согласования поймала застрявшую задачу - путь, который большинство команд игнорирует), и повторная попытка вебхука (вызовите 500 в первый раз и 200 во второй, затем убедитесь, что ваша идемпотентность пропустила дублирующую работу).

Скоро провалитесь на неправильно настроенных ключах.

Самый распространенный инцидент в производстве вокруг тестовых/живых ключей - это молчаливый: развертывание происходит с тестовым ключом, платежи не проходят, оповещения срабатывают только на следующий рабочий день. Заблокируйте это при запуске: отказывайтесь запускаться, если переменные окружения и префикс ключа не совпадают.

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

Как только тестовый цикл входит в ваш цикл разработки.

С наличием здорового тестового цикла оставшаяся работа в основном заключается в укреплении: надежная обработка вебхуков под нагрузкой, окончательный контрольный список безопасности и миграции от любого предыдущего платежного провайдера, который вы могли использовать.

Полная справка на docs.blockchain0x.com. Подробности тестовой сети: Глоссарий цепи Base. Поверхность продукта: Payment API.