A unified Taiwan payment SDK that provides a provider-agnostic PaymentProvider interface with adapters for ECPay, NewebPay, and PAYUNi, so applications can switch gateways without rewriting business logic.

Stars

22

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-31

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It is a TypeScript-first monorepo that keeps the core free of adapter dependencies, ships per-provider packages you install only as needed, and includes offline MSW tests plus live ECPay stage tests.

Who it is for

  • TypeScript/Node.js developers integrating Taiwan payment gateways
  • E-commerce teams using ECPay, NewebPay, or PAYUNi
  • Teams planning to switch or support multiple gateway providers
  • Developers exploring provider-agnostic payment abstractions

Use cases

  • Create a payment and receive a redirect form from ECPay
  • Query transaction info via a normalized PaymentProvider interface
  • Swap between supported Taiwan gateways without changing business logic
  • Use ECPay AIO or ECPG variants from the same adapter package

Strengths

  • Core package defines typed PaymentProvider, capabilities, PaymentError, and MockProvider; adapters stay separate
  • Per-provider packages mean you only install the gateways you actually use
  • CI runs offline MSW tests by default and optional live tests against ECPay's public stage merchant
  • ECPay adapter covers AIO and ECPG workflows with documented API coverage and separation docs

Considerations

  • Some adapters are incomplete: PAYUNi create/refund is WIP and NewebPay is only a scaffold
  • ECPay offers two APIs (AIO and ECPG); you must read the docs and pick the right factory for your integration
  • Merchant onboarding, KYC, and CLI/table output are out of scope and belong to other paid.tw projects

README quick start

使用方式

Description

台灣金流 SDK:一致的 PaymentProvider 介面,方便串接。支援 PAYUNi、藍新 NewebPay、綠界 ECPay(AIO + 站內付 2.0)。

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859