payment skill

Overview

This skill handles payment processing and transaction management for web and mobile applications. It streamlines invoice creation, payment capture, refunds, and transaction history across multiple gateways. The skill is designed to be a central payment layer that integrates with Stripe, PayPal, Square, and crypto providers.

How this skill works

The skill creates and sends invoices, accepts payment requests, and records transaction status updates from gateway webhooks. It reconciles payments, supports manual and automatic refunds, and exposes endpoints to query payment history and current balances. The system validates amounts and authorizations before executing transactions and logs events for auditing.

When to use it

• You need to generate and email invoices programmatically.
• You want a unified interface to accept payments from multiple gateways.
• You need to track and reconcile payments and refunds.
• You require transaction history and audit logs for accounting.
• You want to support both fiat and crypto payment methods.

Best practices

• Always validate and confirm invoice amounts with customers before charging.
• Never store raw gateway credentials or card data in plain text; use tokenization and secure vaults.
• Implement webhook signature verification to trust gateway callbacks.
• Keep detailed logs of payment attempts, successes, and failures for reconciliation.
• Limit sensitive data exposure and use role-based access for payment operations.

Example use cases

• Create an invoice for a customer and send it via email with a payment link.
• Process a one-time or recurring charge through Stripe, PayPal, or Square.
• Query recent transactions to reconcile a daily batch with accounting records.
• Issue a partial or full refund and record the refund reason for compliance.
• Accept crypto payments and map on-chain confirmations to internal orders.

FAQ