clawallex_subscribe
Create a reloadable virtual card for managing recurring subscription payments, with options for wallet-based or on-chain funding.
Instructions
Set up a reloadable virtual card for recurring/subscription payments. Creates a stream card (card_type=200) that stays active and can be refilled via clawallex_refill.
Mode A (mode_code=100, default): wallet balance → stream card. Immediate settlement. Mode B (mode_code=200): for callers with self-custody wallets — signing is performed by the caller. Same x402 two-stage flow as clawallex_pay. The 402 response is EXPECTED (a quote, not an error). See clawallex_pay for full Stage 1/2 details.
Fee structure: fee_amount = issue_fee_amount + monthly_fee_amount + fx_fee_amount.
Example: clawallex_subscribe({ initial_amount: 100, description: 'AWS monthly billing' })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| initial_amount | Yes | Initial deposit in USD | |
| description | Yes | Subscription purpose | |
| mode_code | No | 100=wallet (default), 200=x402 on-chain | |
| tx_limit | No | Per-transaction limit in USD (optional, default 100.0000) | |
| allowed_mcc | No | MCC whitelist, comma-separated (optional, e.g. '5734,5815') | |
| blocked_mcc | No | MCC blacklist, comma-separated (optional, e.g. '7995') | |
| client_request_id | No | UUID idempotency key (<=64 chars). Mode B Stage 2: MUST reuse from Stage 1. | |
| chain_code | No | Chain code for Mode B Stage 1 (e.g. 'ETH') | |
| token_code | No | Token code for Mode B Stage 1 (e.g. 'USDC') | |
| extra | No | Mode B Stage 2 (required): { card_amount, paid_amount } | |
| x402_reference_id | No | x402 reference ID. Card creation Stage 1: optional (server generates if omitted). Stage 2: use value from 402 response. Refill Mode B: required, serves as idempotency key. | |
| x402_version | No | x402 version (Mode B Stage 2, required) | |
| payment_payload | No | x402 payment payload (Mode B Stage 2, required) | |
| payment_requirements | No | x402 payment requirements (Mode B Stage 2, required) | |
| payer_address | No | Payer wallet address (optional, final value from verify) |