NewebPay Integration Methodology

When to use this skill

• Accepting payment on a Taiwan storefront through NewebPay (藍新金流): credit card, ATM (虛擬帳號), CVS barcode (超商條碼), LINE Pay, Apple Pay, Taiwan Pay, Samsung Pay
• Setting up 定期定額 (credit card recurring billing) — subscription boxes, SaaS, content sites, donation platforms
• Reconciling NewebPay callback webhooks against internal order state, or debugging why an order is "paid on NewebPay" but "open in our DB"
• Issuing refunds, cancelling authorizations, or closing (請款) credit card transactions through mcp-newebpay
• Debugging AES-256-CBC / TradeSha signature mismatches, 3DS 2.0 liability shift behavior, or MPGGateway form submission failures

Do NOT use when

• The question is "which gateway should we pick?" — use tw-payment-integration (comparison of NewebPay / ECPay / TapPay / LINE Pay Direct)
• The merchant is on ECPay (綠界) or TapPay — those providers have their own skills and different API / signature schemes
• You only need the exact API schema for one NDNF/NDNP endpoint — read mcp-newebpay tool descriptions or the NewebPay official PDF (線上交易─幕前支付技術串接手冊_NDNF / 信用卡定期定額串接技術手冊_NDNP)
• The dispute is about chargeback / 爭議款 handling — see tw-ecom-payment-dispute

Core concepts