Do I prefund an agent wallet?
Do I prefund an agent wallet?
No. The borrower has a revolving facility. The agent spends inside an agent grant. USDC moves to the merchant when a batch settles, from the protocol, and the borrower owes that draw until they repay.
Who holds the keys?
Who holds the keys?
The borrower holds their wallet key and signs in that wallet. The agent holds an Ed25519 workload key and signs vouchers with
@sohopay/agent-signer. SohoPay holds a hardware-backed key that attests settlement batches, and neither of the other two. See Key management.Is there an MPC wallet I have to operate?
Is there an MPC wallet I have to operate?
No. That design is retired. See Settlement attestation.
Which environment do I use?
Which environment do I use?
Staging. Hosts and contract addresses are in Environment setup.
Are merchants paid the full amount?
Are merchants paid the full amount?
No. V2 pays the merchant
amount - fee. The default fee in the backend is 2.5%, overridable per merchant. See Fees.Do you send webhooks when a payment settles?
Do you send webhooks when a payment settles?
No. Poll until
CONFIRMED. See Settlements.Is there a Python or REST SDK?
Is there a Python or REST SDK?
No. Merchants use the facilitator HTTP API. Agents use hosted MCP plus
@sohopay/agent-signer.Next steps
Troubleshooting
Fixes for the common failures.
Glossary
The terms these answers use.