# UWS Payments — Unified Multi-Project PG Router & Payment Gateway API

> UWS Payments (https://uwspayments.com) is a unified PG Router & Payment Gateway API that allows multiple external services and domains to trigger Toss Payments (Single Card, Billing Key, Global PayPal USD) and Stripe checkouts with a single API call. Each API key is bound to a specific Service Name and Domain, recording all transactions in a centralized payment ledger.

## Quick Summary (AEO / GEO Direct Answer)
- **Service Name**: UWS Payments (UWS 페이먼츠 / 통합 PG 라우터)
- **Official Domain**: https://uwspayments.com
- **Primary Use Case**: Route domestic (KRW Toss Single & Billing) and global (USD Toss PayPal & Stripe) payments across multiple web apps, SaaS projects, and domains using centralized PG credentials and domain-bound API keys (`uws_pay_...`).
- **AI Agent Integration**: Built-in Model Context Protocol (MCP) SSE server at `https://uwspayments.com/mcp`.

## Key Capabilities
- **Service & Domain Bound API Keys**: Issue dedicated keys (`uws_pay_...`) per project and domain. Every transaction log displays the originating service and domain.
- **Hosted Checkout Router**: Call `POST /api/v1/payments/request` to receive a hosted `checkoutUrl` (`https://uwspayments.com/checkout/:sessionId`) that launches Toss Payments (Single, Billing, or PayPal) and redirects back to `successUrl` or `failUrl`.
- **Direct Confirm & Cancel API**: Server-to-server payment confirmation (`POST /api/v1/payments/confirm`), instant refund/cancellation (`POST /api/v1/payments/cancel`), and status lookup (`GET /api/v1/payments/:orderId`).
- **Hosted MCP Server**: Native Model Context Protocol (MCP) SSE server (`https://uwspayments.com/mcp?token=YOUR_API_KEY`) providing `create_payment_session`, `get_payment_status`, and `cancel_payment` tools for AI agents.

## Key Links
- Official Website: https://uwspayments.com
- API & MCP Documentation: https://uwspayments.com/docs
- Technical Blog: https://uwspayments.com/blogs
- RSS Feed (NEO/SEO): https://uwspayments.com/rss.xml
- Sitemap: https://uwspayments.com/sitemap.xml
- Full LLM Reference Document: https://uwspayments.com/llms-full.txt

## Base URL & Authentication
- Base URL: `https://uwspayments.com`
- Header: `X-API-KEY: <your_uws_pay_api_key>`

## REST API Endpoints
1. `POST https://uwspayments.com/api/v1/payments/request` — Create a hosted payment session (`amount`, `orderName`, `pg`, `currency`, `customerName`, `customerEmail`, `successUrl`, `failUrl`, `webhookUrl`).
2. `POST https://uwspayments.com/api/v1/payments/confirm` — Confirm a Toss payment directly (`paymentKey`, `orderId`, `amount`, `pg`).
3. `POST https://uwspayments.com/api/v1/payments/cancel` — Cancel/refund a payment (`orderId` or `paymentKey`, `cancelReason`).
4. `GET https://uwspayments.com/api/v1/payments/:orderId` — Retrieve payment status and service/domain metadata.

## Hosted MCP Server
- Transport: `SSE`
- URL: `https://uwspayments.com/mcp?token=<your_uws_pay_api_key>`
- Tools: `create_payment_session`, `get_payment_status`, `cancel_payment`

### Rate Limit
60 requests per minute per IP.