用途:面向结账与支付场景的专用技能,聚焦 MercadoPago 集成、订单管理、地址校验和结账流程。
主要能力与建议流程:创建订单前先校验购物车数据;校验收货地址;在数据库中创建订单;接入 MercadoPago;处理支付 webhook;更新订单状态。
关键文件位置:src/app/checkout/ 为结账页面;src/components/Checkout/ 为结账组件;src/lib/integrations/mercadopago/ 为 MercadoPago 集成;src/lib/business/orders/ 为订单逻辑;src/hooks/useCheckout.ts 为结账 hook。
常见用法:在 API 路由中从 createOrder 建单(状态 pending_payment),再调用 createPayment 传入 transaction_amount、description 与 payer.email,随后用 updateOrder 写入 payment_id 与 payment_status。地址校验可调用 validateAddress,传入 street、city、postalCode、country,若 isValid 为 false 则返回 errors。前端可用 @mercadopago/sdk-react 的 initMercadoPago 初始化公钥,并用 Wallet 组件传 preferenceId 与 onSubmit。
订单状态包括:pending_payment、paid、processing、shipped、delivered、cancelled、refunded。
限制:资料未提供安装命令、依赖版本、具体收费或服务价格、完整配置步骤及运行环境要求,需结合实际项目确认。