payuni

Original：🇨🇳 Chinese

Translated

Provides an overview of PAYUNi integration and guides users to relevant skills. This is applicable when starting PAYUNi integration, setting up the environment, or requiring general guidance on PAYUNi (unified payment service).

1installs

Sourcepaid-tw/skills

Added on2026-02-10

NPX Install

npx skill4agent add paid-tw/skills payuni

SKILL.md Content (Chinese)

View Translation Comparison →

PAYUNi Unified Payment Integration Guide

Your task is to help users set up their PAYUNi environment and guide them to the appropriate integration features.

User Demand Analysis

User input:

$ARGUMENTS

Based on user requirements, determine the next steps:

If it includes "integration", "checkout", "create transaction", "UPP" → Guide to use
```
/payuni-checkout
```
If it includes "query", "order status" → Guide to use
```
/payuni-query
```
If it includes "webhook", "callback", "notification" → Guide to use
```
/payuni-webhook
```
If no specific designation → Provide the following environment setup guidance

Environment Setup Check

Ask users the following questions:

Project Framework: What framework are you using?
- PHP (Laravel / Native PHP / Others)
- Node.js (Express / Next.js / NestJS / Others)
- Python (Django / Flask / FastAPI / Others)
- Others
Environment Status: Do you already have a PAYUNi merchant account?
- Yes, already have a test environment account
- Yes, already have a production environment account
- No, need to apply

Environment Variable Setup

Guide users to create environment variables:

bash

PAYUNI_MERCHANT_ID=Your Merchant ID
PAYUNI_HASH_KEY=Your HashKey
PAYUNI_HASH_IV=Your HashIV
PAYUNI_TEST_MODE=true  # Test mode, set to false for production environment

Guidance for users:

Create or edit the
```
.env
```
file in the project root directory
Add the above environment variables
Ensure
```
.env
```
is added to
```
.gitignore
```

Next Steps

After completing the environment setup, guide users based on their needs:

Requirement	Skill	Description
Create payment page	`/payuni-checkout`	UPP front-end payment integration
Query transaction status	`/payuni-query`	Transaction query API
Process Webhook	`/payuni-webhook`	Receive payment notifications

Environment Information

Environment	API Base URL
Test	`https://sandbox-api.payuni.com.tw`
Production	`https://api.payuni.com.tw`

Supported Payment Methods

Credit Card: One-time payment, installment payment
Mobile Payment: LINE Pay, Apple Pay, Google Pay
ATM: WebATM, ATM transfer
Convenience Store: Code payment, barcode payment

Important Notes

HashKey and HashIV must be kept confidential and must not be exposed to the front-end
PAYUNi uses AES-256-CBC encryption
Order numbers cannot be duplicated
NotifyURL/ReturnURL must use HTTPS (production environment)
Webhook signatures need to be verified to prevent forgery

Comparison with Other Payment Gateways

Feature	PAYUNi	NewebPay	Ecpay
Encryption Method	AES-256-CBC	AES-256-CBC	AES-128-CBC
Signature Method	SHA256 (HashInfo)	SHA256 (TradeSha)	SHA256 (CheckMacValue)
API Version	Unified version	Version parameter	Version parameter