VividKit Crystal clear AI coding
EN
Chọn Thiết Lập Bắt Đầu với AgentKit Tiếp Tục với ClaudeKit Chuyển từ ClaudeKit sang AgentKit Gỡ hẳn ClaudeKit AgentKit Là Gì? AgentKit Hoạt Động Như Thế Nào? Kit, Skill, Agent & Hook AgentKit Hỗ Trợ Runtime AgentKit Ứng Dụng AgentKit Desktop Cấu Hình AgentKit Tra Cứu CLI ak Cheatsheet skill AgentKit Workflows AgentKit Statusline AgentKit Cập Nhật CLI ak & Kits AgentKit Helper Cài lại clean AgentKit Xử Lý Sự Cố AgentKit Giới Thiệu ClaudeKit Hướng Dẫn ClaudeKit CLI Tìm Lệnh Phù Hợp Bảng Lệnh Nhanh Quy Trình Mẫu Tham Chiếu CLI Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Tool coding khác Cách ClaudeKit Hoạt Động Inside ClaudeKit Tìm Unknowns Của Bạn Khôi Phục Session Sửa Lỗi Từ Log Thiết Kế UI/UX Chuyển Đổi Tài Khoản Cấu Hình IDE Remote Control Codex App Sơ đồ hệ thống UI Review Gate Khuyến Mãi Ủng Hộ VividKit

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:payment-integration

Tích hợp thanh toán

Tích hợp checkout, thanh toán QR, subscription, tính phí theo mức dùng, license key, webhook và luồng đơn hàng đa provider với SePay, PayFS, Polar, Stripe, Creem, Dodo Payments, Lemon Squeezy, Paddle và PayPal.

01

Xác định việc thanh toán

02

Chọn provider

03

Đọc tài liệu provider

04

Mô hình hóa đơn hàng

Nguyên tắc 01

Chọn provider theo thị trường và mô hình sản phẩm

Nguyên tắc 02

Webhook phải được xác minh và idempotent

Nguyên tắc 03

Trạng thái đơn hàng là nguồn sự thật bền vững

Nguyên tắc 04

Luồng đa provider cần mapping tiền tệ và vòng đời rõ ràng

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Xác định việc thanh toán Làm rõ nhu cầu checkout, subscription, webhook, VietQR, quản lý đơn hàng, benefit hoặc thanh toán enterprise.
  2. 2 Chọn provider Chọn SePay hoặc PayFS cho chuyển khoản ngân hàng Việt Nam và VietQR; Polar, Creem, Dodo Payments, Paddle hoặc Lemon Squeezy (chỉ cho store đang có, đang ở chế độ bảo trì) làm Merchant of Record cho SaaS và sản phẩm số; Stripe cho enterprise và Connect; PayPal cho checkout ví và thẻ khi bạn tự lo thuế. Phiên bản, giới hạn và phí của provider là dữ kiện có thời điểm, cần kiểm lại ở tài liệu chính thức.
02

Xử lý

Agent / skill thực thi

  1. 3 Đọc tài liệu provider Đọc reference phù hợp: overview, API, SDK, webhook, product, checkout, subscription hoặc best practices.
  2. 4 Mô hình hóa đơn hàng Thiết kế product, giá, tiền tệ, trạng thái đơn hàng, mapping giao dịch, vòng đời subscription và chuẩn hóa đa provider.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Xây checkout Tạo checkout session, luồng QR code, payment element hoặc hosted checkout theo provider đã chọn.
  2. 6 Xử lý webhook Xác minh chữ ký hoặc payload provider, làm handler idempotent, map event vào đơn hàng và lưu chuyển trạng thái.
04

Đóng

Báo cáo, bàn giao, artifact

  1. 7 Cấp quyền lợi Cấp quyền truy cập SaaS, benefit GitHub/Discord, hóa đơn, trạng thái gia hạn, nâng/hạ gói và khôi phục khi lỗi.
  2. 8 Xác minh production Kiểm tra sandbox hoặc webhook local, rate limit, retry, event trùng, làm tròn tiền tệ và đối soát.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:payment-integration [provider] [task]

Đối số

[provider]

Provider

Nêu provider thanh toán hoặc ranh giới multi-provider có chủ đích, như SePay, PayFS, Polar, Stripe, Creem, Dodo Payments, Lemon Squeezy, Paddle, PayPal hoặc order đa provider.

/ak:payment-integration stripe Add một sandbox subscription checkout
[task]

Tác vụ thanh toán

Mô tả contract thiết kế hoặc triển khai checkout, subscription, webhook, VietQR, order, refund, test và quyền hạn; không đưa secret.

/ak:payment-integration "stripe Add một sandbox subscription checkout và xác minh webhook signatures trên raw body"

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

QR SePay Khuyến nghị 
/ak:payment-integration SePay VietQR checkout cho đơn hàng VND
Dùng khi:
Dùng cho thanh toán chuyển khoản ngân hàng Việt Nam và QR code.
Kết quả:
Trả về tài liệu SePay, luồng checkout VietQR, bước xác minh webhook và kế hoạch trạng thái đơn hàng bền vững.
SaaS với Polar 
/ak:payment-integration đăng ký Polar với quyền lợi GitHub
Dùng khi:
Dùng cho subscription SaaS và cấp benefit tự động.
Kết quả:
Thiết kế checkout Polar, xử lý vòng đời subscription, cấp benefit, xác minh webhook và mapping trạng thái gia hạn.
Stripe enterprise 
/ak:payment-integration payout marketplace Stripe Connect
Dùng khi:
Dùng cho hạ tầng thanh toán global phức tạp hoặc nền tảng Connect.
Kết quả:
Đưa hướng tích hợp Stripe bao phủ checkout, payout Connect, kiểm thử webhook cục bộ và đối soát.
SaaS dùng Merchant of Record 
/ak:payment-integration subscription Paddle có proration cho các gói SaaS
Dùng khi:
Dùng khi cần Merchant of Record lo thuế và hoá đơn cho SaaS hoặc sản phẩm số.
Kết quả:
Dựng checkout Paddle.js và subscription nhiều item có proration, xác minh webhook Paddle-Signature trong ngưỡng timestamp cho phép, và giữ số tiền cùng trạng thái đơn hàng ở phía server.

Phạm vi xử lý

  • Chuyển khoản và VietQR với SePay, PayFS
  • Merchant of Record: Polar, Creem, Dodo Payments, Paddle, Lemon Squeezy
  • Stripe Checkout, Billing và Connect
  • Orders và Subscriptions của PayPal
  • Tính phí theo mức dùng và license key
  • Xác minh webhook
  • Quản lý đơn hàng đa provider

Artifact tạo ra

Output tích hợp thanh toán

Mẫu đường dẫn

Checkout + webhook + trạng thái đơn hàng theo provider

Thay đổi thanh toán production cần có lý do chọn provider, xử lý webhook an toàn, chuyển trạng thái idempotent và ghi chú đối soát/test.

Tiếp theo