使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/bagisto/agent-skills --skill bagisto-payment-method-development开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Payment Method Development
Overview
Creating custom payment methods in Bagisto allows you to integrate any payment gateway or processor with your store. Whether you need local payment methods, cryptocurrency payments, or specialized payment flows, custom payment methods provide the flexibility your business requires.
For our tutorial, we'll create a Custom Stripe Payment method that demonstrates all the essential concepts you need to build any type of payment solution.
When to Apply
Activate this skill when:
- Creating new payment methods
- Integrating payment gateways (Stripe, PayPal, Razorpay, etc.)
- Adding payment options to checkout
- Modifying existing payment configurations
- Creating admin configuration for payment methods
Bagisto Payment Architecture
Bagisto's payment system is built around a flexible method-based architecture that separates configuration from business logic.
Core Components
| Component | Purpose | Location |
|---|---|---|
| Payment Methods Configuration | Defines payment method properties | Config/payment-methods.php |
| Payment Classes | Contains payment processing logic | Payment/ClassName.php |
| System Configuration | Admin interface forms | Config/system.php |
| Service Provider | Registers payment method | Providers/ServiceProvider.php |
Key Features
- Flexible Payment Processing: Support for redirects, APIs, webhooks, or custom flows.
- Configuration Management: Admin-friendly settings interface.
- Multi-channel Support: Different settings per sales channel.
- Security Ready: Built-in CSRF protection and secure handling.
- Extensible Architecture: Easy integration with third-party gateways.
Reference files — load only what the current task needs
| File | Load when |
|---|---|
| implementation.md | Building a payment method — the step-by-step guide |
| payment-api.md | The base payment class and the methods to override |
| reference.md | Built-in methods, best practices, a complex integration example, package layout, testing, pitfalls |
REQUIRED SUB-SKILL: Use bagisto-change-verification before calling any change done.
