commerce-payments

Process e-commerce payments via the stateset-payments CLI with captures and refunds.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/stateset/icommerce-skills --skill commerce-payments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commerce-payments
Source: https://github.com/stateset/icommerce-skills/tree/main/skills/commerce-payments
Command: npx skills add https://github.com/stateset/icommerce-skills --skill commerce-payments

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Businesses need to securely create, capture, refund, and reconcile payments for orders while keeping order state accurate and auditable.

Core Features & Use Cases

  • Create payments tied to orders and record gateway results.
  • Capture and refund partial or full amounts with proper validations.
  • Track transaction references and update order status across stablecoin workflows via CLI tools.

Quick Start

Create a payment for an order, then complete or refund it using the stateset-payments CLI.

Frequently Asked Questions about commerce-payments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I process payments for e-commerce orders via CLI?

You can process e-commerce payments by creating a payment tied to an order and recording the gateway result using the stateset-payments CLI. This captures the transaction reference and updates the order status automatically.

Can I issue partial refunds for order payments?

Yes, you can refund partial or full amounts for order payments. The system validates the refund amount against the original transaction and checks capture eligibility before processing the refund via the stateset-payments CLI.

How do payment authorizations and captures work for order management?

Payment authorizations and captures work by creating a payment record tied to an order, then completing the capture through the stateset-payments CLI. The system validates capture eligibility and updates the order status with the gateway transaction reference.

Do I need to validate balance before refunding a payment transaction?

Yes, balance validation is required before refunding a payment transaction. The system validates refund amounts and capture eligibility across gateway results to ensure the transaction is eligible for a full or partial refund.

What is the best way to manage payment methods and transaction records for orders?

The best way to manage payment methods and transaction records is through the stateset-payments CLI. It records gateway results, tracks transaction references, and maintains accurate order state across payment captures and refunds.

Why does my order status not update after a payment capture?

Your order status may not update if the gateway result or transaction reference was not properly recorded. The stateset-payments CLI requires successful balance validation and capture eligibility checks before updating the order status.