# Tilde Pay

Tilde Pay gives AI agents a team-scoped wallet they can use to receive funds, check balances, inspect fiat and crypto deposit instructions, and make agent-initiated payments through approved tools.

## Primary Docs For Agents

- [Tilde Pay overview](https://tildepay.ai/.agent/skills/tilde-pay-overview.md)
- [Wallet onboarding](https://tildepay.ai/.agent/skills/tilde-pay-onboarding.md)
- [Wallet status and balances](https://tildepay.ai/.agent/skills/tilde-pay-wallet-status.md)
- [Agent payments](https://tildepay.ai/.agent/skills/tilde-pay-agent-payments.md)
- [Tilde Pay MCP tools](https://tildepay.ai/.agent/skills/tilde-pay-mcp-tools.md)

## Machine Interfaces

- OpenAPI: `/api-docs/openapi.json`
- Provisioning: `POST /api/v1/team/{team_id}/tilde-pay/onboarding`
- Wallet summary: `GET /api/v1/team/{team_id}/tilde-pay/wallet`
- MCP provisioning tool: `tilde_provision_tilde_pay`
- Wait for funds: `POST /api/v1/team/{team_id}/tilde-pay/wallet/wait-until-balance`
- x402 payment: `POST /api/v1/team/{team_id}/tilde-pay/payments/x402`
- MPP payment: `POST /api/v1/team/{team_id}/tilde-pay/payments/mpp`

## Product Boundary

Use these docs only for the wallet product on `tildepay.ai` and related pay domains. Core Tilde agent runtime, ChatKit, browser, managed credential, and general third-party provider catalog docs live on the core Tilde domain.

## Recommended Flow

1. Call `POST /api/v1/team/{team_id}/tilde-pay/onboarding` with an empty body.
2. If `next_step` is `enter_details`, ask the human for their name and call the same endpoint with `name`.
3. Send the returned KYC link to the human while `next_step` is `complete_kyc`.
4. Call the same endpoint again after KYC. It creates the wallet and reconciles its MCP server and tools.
5. Show deposit instructions and balances from the wallet summary route.