| name | commerce-payments |
| description | Manage payments, captures, refunds, and payment methods. Use when running `stateset-payments`, `stateset-pay`, or handling payment intents. |
Commerce Payments
Create, complete, and refund payments for orders.
How It Works
- Create a payment record tied to an order.
- Complete or fail the payment based on gateway results.
- Issue refunds (full or partial) when needed.
- Record transaction references and update order status.
Usage
- CLI:
stateset-payments ... and stateset-pay ... for stablecoin operations.
- Writes require
--apply.
- MCP tools:
list_payments, get_payment, create_payment, complete_payment, create_refund.
Output
{"status":"completed","payment_id":"pay_123","amount":129.99}
Present Results to User
- Payment or refund IDs and amounts.
- Method used and transaction references.
- Order status updates if applicable.
Troubleshooting
- Payment already captured: avoid duplicate completion.
- Refund exceeds paid amount: validate remaining balance.
References
- references/payments-flow.md
- /home/dom/stateset-icommerce/cli/.claude/agents/payments.md
- /home/dom/stateset-icommerce/cli/bin/stateset-pay.js
