shoplazza CLI — billing module

CRITICAL — before anything else, use Read on ../shoplazza-common/SKILL.md. It owns every cross-cutting mechanic: access tiers, the output envelope (.data), --dry-run, --jq, schema, api rest, auth / profiles, and the safety protocol. This file covers only the billing domain and never repeats them.

Overview

The billing module lets an app developer charge a merchant for app usage: one-time fees, recurring subscriptions, and metered usage charges (plus transaction records). It is spec-leaf only — there are no +shortcuts. Every charge moves real money, so --dry-run first and restate the charge to the user before executing (shoplazza-common → Safety).

Charges are two-phase: create alone moves no money — the charge sits pending until the merchant opens the approval URL the response returns (confirm_url for one-time, confirmation_url for recurring) and approves it in the Shoplazza admin, after which they land on your return_url. Usage charges skip approval — they bill under an already-approved recurring charge.