home / skills / paid-tw / skills / payuni

payuni skill

safe

This skill helps you integrate PAYUNi unified payment by guiding gateway setup and API configuration for Taiwan merchants.

npx playbooks add skill paid-tw/skills --skill payuni

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

954 B

---
name: payuni
description: >
  Provides PAYUNi (統一金流) integration guide including payment gateway setup
  and API configuration. Use when integrating PAYUNi payment services or
  unified payment solutions.
user-invocable: true
---

# PAYUNi 統一金流整合指南

> 🚧 開發中

## 快速開始

### 環境設定

**測試環境:**
- 測試 URL: `https://sandbox-api.payuni.com.tw/`
- 測試卡號:
  - VISA: `4147-6310-0000-0001`
  - JCB: `3560-5110-0000-0001`
  - 到期日: 任意未來日期
  - CVV: 任意三碼

**正式環境:**
- 正式 URL: `https://api.payuni.com.tw/`

### 支援的支付方式

- 信用卡
- ATM 轉帳
- 超商代碼
- 行動支付

## 參考資源

- [PAYUNi 官方文件](https://docs.payuni.com.tw/)
- 詳細 API 說明與錯誤碼對照將於後續版本提供

## 相關 Skills

- `/payment-help` - 查看所有可用的支付 skills
- `/newebpay` - 藍新金流串接
- `/ecpay` - 綠界科技串接

Overview

This skill provides a practical integration guide for PAYUNi (統一金流), focusing on payment gateway setup and API configuration for PHP-based applications. It includes sandbox and production endpoints, test card details, and supported payment methods to accelerate implementation. Use it to configure environments, validate flows, and map payment options into your checkout system.

How this skill works

The skill documents the endpoints and configuration steps needed to connect to PAYUNi, including sandbox and production URLs, example test card data, and the list of payment channels supported. It explains how to set up API calls for authorization and notifications, how to switch between environments, and what payment types to enable for your store. The guide is aimed at developers integrating PAYUNi into a web or backend service and highlights key test artifacts to verify integration.

When to use it

Integrating PAYUNi as a payment provider for an online store or service in Taiwan
Setting up sandbox tests before going live with credit card and alternative payments
Mapping multiple payment methods (card, ATM, convenience store, mobile pay) in a single checkout
Configuring environment-specific endpoints and validating webhook or callback flows
Onboarding merchants who require unified payment solutions with standard API calls

Best practices

Start with the sandbox URL to complete end-to-end testing before switching to production
Use the provided test card numbers and arbitrary future expiry/CVV to validate card flows
Implement idempotency and transaction logging to handle retries and avoid duplicate charges
Securely store and rotate API credentials; never expose production keys in client code
Validate server-to-server callbacks and verify signatures or hashes to prevent tampering

Example use cases

A PHP e-commerce site adding credit card and convenience store payment options via PAYUNi
A subscription service configuring recurring billing and testing card authorization in sandbox
A marketplace implementing multiple payment channels and consolidating settlement with PAYUNi
A backend team building webhook handlers to process asynchronous payment notifications
A QA team running end-to-end scenarios using sandbox endpoints and test card data

FAQ

What endpoints should I use for testing and production?

Use https://sandbox-api.payuni.com.tw/ for testing and https://api.payuni.com.tw/ for production.

Are there test card numbers available?

Yes. Example test cards include VISA 4147-6310-0000-0001 and JCB 3560-5110-0000-0001 with any future expiry and any three-digit CVV.