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 ...andstateset-pay ...for stablecoin operations. - •Writes require
--apply. - •MCP tools:
list_payments,get_payment,create_payment,complete_payment,create_refund.
Output
json
{"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