Skip to main content

Test MPP payments

MPP testing requires either stub mode (no real blockchain) or a funded Tempo testnet wallet. Start with stub mode, then graduate to testnet once your integration is working. Set PAYMENT_STUB_MODE=true on your server. In stub mode, the server accepts any payment credential without calling the Tempo RPC.
Test with the stub payment header:

Testnet setup

For full end-to-end testing with real Tempo transactions:
  1. Get a Tempo testnet RPC URL (from your Tempo provider)
  2. Fund a test wallet with testnet USDC.e from the faucet
  3. Set PAYMENT_STUB_MODE=false and configure your Tempo RPC URL

The MPP agent test script

This script demonstrates the full MPP agent flow from example-07-mpp-agent.ts:

Run the test