# NICEPAY Developer Documentation

> NICEPAY PG, PAYU, CMS 연동에 필요한 기술문서, API 연동 가이드, 결과 코드, 제휴사 코드 문서를 제공합니다.
> 기본 URL: https://developers.nicepay.co.kr
> 상태: 초안. 문서 구조와 요약은 향후 변경될 수 있습니다.

## How to Use

- 결제 연동 질문은 먼저 Quickstart와 인증/비인증 결제 소개 문서를 확인하세요.
- 결제창 인증 이후 승인 요청은 승인 API 문서를, 승인 실패 또는 통신 실패 처리는 망취소 API 문서를 함께 확인하세요.
- 결과 코드 문의는 결과 코드 문서 설명과 결제수단별 결과 코드 문서를 우선 확인하세요.
- MerchantKey, 운영 MID, 구매자 개인정보, 카드번호, 계좌번호 등 민감정보를 AI 도구에 입력하지 마세요.

## Getting Started

- [Quickstart](https://developers.nicepay.co.kr/docs/intro): 방화벽 설정, API 호출 환경, 샘플 코드 다운로드, 기술문의 등 연동 전 기본 준비사항을 안내합니다.
- [MCP 연동하기](https://developers.nicepay.co.kr/docs/mcp/intro): AI 개발 도구에서 NICEPAY 기술문서를 MCP 서버로 조회하기 위한 설정 예시와 보안 유의사항을 안내합니다.

## PG 인증 결제

- [인증 결제 서비스 소개](https://developers.nicepay.co.kr/docs/pg/intro): 인증 결제 서비스의 기본 개념과 전체 연동 흐름을 설명합니다.
- [결제창 호출하기](https://developers.nicepay.co.kr/docs/pg/auth/payment-window): PC 및 Mobile 결제창 호출 Flow, 요청 파라미터, 인증 응답 파라미터를 안내합니다.
- [제휴사 결제창 직접 호출하기](https://developers.nicepay.co.kr/docs/pg/auth/payment-window-skip): 카드사 및 간편결제 결제창 직접 호출 옵션과 요청 파라미터를 안내합니다.
- [승인 API 연동하기](https://developers.nicepay.co.kr/docs/pg/auth/authorization): 인증 응답의 TxTid, AuthToken, NextAppURL을 사용해 승인 API를 호출하는 방법과 응답 파라미터를 안내합니다.
- [망취소 API 연동하기](https://developers.nicepay.co.kr/docs/pg/auth/net-cancel): 승인 요청 또는 응답 처리 중 장애가 발생했을 때 NetCancelURL로 망취소를 요청하는 방법을 안내합니다.
- [승인 취소 API 연동하기](https://developers.nicepay.co.kr/docs/pg/auth/payment-cancel): 승인된 거래의 전체/부분 취소 요청 파라미터와 응답 파라미터를 안내합니다.

## PG 비인증 결제

- [비인증 결제 서비스 소개](https://developers.nicepay.co.kr/docs/pg/non-auth/intro): 결제창 없이 서버 간 API로 처리하는 비인증 결제 서비스 개요를 안내합니다.
- [카드키인 API 연동하기](https://developers.nicepay.co.kr/docs/pg/non-auth/card-keyin): 카드번호 기반 키인 승인 요청 파라미터와 응답 파라미터를 안내합니다.
- [빌키 발급 API 연동하기](https://developers.nicepay.co.kr/docs/pg/non-auth/billkey-create): 정기결제 또는 재결제를 위한 빌키 발급 요청 및 응답 규격을 안내합니다.
- [카드빌링 API 연동하기](https://developers.nicepay.co.kr/docs/pg/non-auth/card-billing): 발급된 빌키를 사용한 카드 빌링 승인 요청 및 응답 규격을 안내합니다.
- [빌키삭제 API 연동하기](https://developers.nicepay.co.kr/docs/pg/non-auth/billkey-remove): 빌키 삭제 요청 파라미터와 응답 파라미터를 안내합니다.
- [가상계좌 발급 API 연동하기](https://developers.nicepay.co.kr/docs/pg/non-auth/virtual-account): 일회성 가상계좌 발급 요청, 입금기한, 입금통보 연동에 필요한 정보를 안내합니다.
- [비인증 승인 취소 API 연동하기](https://developers.nicepay.co.kr/docs/pg/non-auth/payment-cancel): 비인증 결제 거래의 취소 요청 및 응답 규격을 안내합니다.

## PAYU

- [PAYU 결제 서비스 소개](https://developers.nicepay.co.kr/docs/pg/payu/intro): PAYU 자체간편결제 서비스 개요와 주요 연동 흐름을 안내합니다.
- [회원등록/결제요청 화면 호출하기](https://developers.nicepay.co.kr/docs/pg/payu/authentication): PAYU 회원 등록 및 결제 요청 화면 호출 방법을 안내합니다.
- [PAYU 승인 API 연동하기](https://developers.nicepay.co.kr/docs/pg/payu/authorization): PAYU 인증 결과를 기반으로 승인 API를 호출하는 방법을 안내합니다.
- [PAYU 승인 취소 API 연동하기](https://developers.nicepay.co.kr/docs/pg/payu/payment-cancel): PAYU 결제 거래 취소 요청 및 응답 규격을 안내합니다.
- [마이페이지 화면 호출하기](https://developers.nicepay.co.kr/docs/pg/payu/mypage): PAYU 회원이 등록 결제수단을 관리하는 마이페이지 호출 방법을 안내합니다.
- [회원(UserKey) 조회하기](https://developers.nicepay.co.kr/docs/pg/payu/userkey-inquiry): PAYU UserKey 회원 조회 API 요청 및 응답 규격을 안내합니다.
- [회원(UserKey) 삭제하기](https://developers.nicepay.co.kr/docs/pg/payu/userkey-remove): PAYU UserKey 회원 삭제 API 요청 및 응답 규격을 안내합니다.

## 조회 서비스

- [조회 서비스 소개](https://developers.nicepay.co.kr/docs/pg/inquiry/intro): 거래조회, 대사조회, 영수증 조회 등 조회 서비스의 목적과 문서 구성을 안내합니다.
- [거래조회 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/trans-inquiry): TID 기준 승인/취소/거래 없음 상태를 조회하는 API를 안내합니다.
- [영수증 조회하기](https://developers.nicepay.co.kr/docs/pg/inquiry/receipt): 매출전표 및 현금영수증 조회 연동 방법을 안내합니다.
- [거래대사 API 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/trans-reconciliation): 거래 대사 데이터를 조회하는 API 요청 및 응답 규격을 안내합니다.
- [현금영수증 대사 API 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/cash-receipt-reconciliation): 현금영수증 대사 데이터를 조회하는 API 요청 및 응답 규격을 안내합니다.
- [정산대사 API 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/settlement-reconciliation): 정산 대사 데이터를 조회하는 API 요청 및 응답 규격을 안내합니다.
- [입금대사 API 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/deposit-reconciliation): 입금 대사 데이터를 조회하는 API 요청 및 응답 규격을 안내합니다.
- [무이자정보조회 API 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/interest-free): 카드사 무이자 할부 정보를 조회하는 API를 안내합니다.
- [예금주 성명 조회 연동하기](https://developers.nicepay.co.kr/docs/pg/inquiry/check-bank-account): 은행 계좌의 예금주 성명을 조회하는 API 요청 및 응답 규격을 안내합니다.

## 부가 서비스

- [결제통보 연동하기](https://developers.nicepay.co.kr/docs/pg/add/noti): 결제 결과 또는 입금 결과를 가맹점 서버로 통보받는 방식과 검증 방법을 안내합니다.
- [APP WebView 연동하기](https://developers.nicepay.co.kr/docs/pg/add/app-webview): Android WebView, iOS WKWebView에서 결제창과 3rd 앱을 연동하는 방법을 안내합니다.
- [현금영수증 발급하기](https://developers.nicepay.co.kr/docs/pg/add/cash-receipt): 현금영수증 발급 요청, 응답, 취소 참고 정보를 안내합니다.
- [NICE링크결제 활용하기](https://developers.nicepay.co.kr/docs/pg/add/link-pay): 결제 링크 등록, 내역 조회, 비활성화 API의 요청·응답 규격과 예시를 안내합니다.
- [지급대행 처리하기](https://developers.nicepay.co.kr/docs/pg/add/payout): 서브몰 등록, 지급 요청, 지급 취소, 결과조회 등 지급대행 API 흐름을 안내합니다.

## 제휴사 코드

- [카드사 코드](https://developers.nicepay.co.kr/docs/pg/partner-code/card-code): 카드 승인 및 응답 파라미터에서 사용하는 카드사 코드를 안내합니다.
- [은행/증권사 코드](https://developers.nicepay.co.kr/docs/pg/partner-code/bank-code): 계좌이체, 가상계좌, 환불계좌 등에서 사용하는 은행/증권사 코드를 안내합니다.

## 결과 코드

- [결과 코드 문서 설명](https://developers.nicepay.co.kr/docs/pg/result-code/intro): 서비스별 결과 코드 문서 목록과 바로가기 링크를 제공합니다.
- [결제창 호출(인증) 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/payment-window-result-code): 결제창 인증 단계에서 응답될 수 있는 결과 코드를 안내합니다.
- [API 공통 오류코드](https://developers.nicepay.co.kr/docs/pg/result-code/api-common-result-code): API 공통 오류 코드와 메시지를 안내합니다.
- [승인 공통 오류 코드](https://developers.nicepay.co.kr/docs/pg/result-code/authorization-result-code): 승인 API 공통 오류 코드와 메시지를 안내합니다.
- [신용카드 승인 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/card-result-code): 신용카드 승인 시 응답될 수 있는 결과 코드를 안내합니다.
- [계좌이체 승인 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/bank-result-code): 계좌이체 승인 시 응답될 수 있는 결과 코드를 안내합니다.
- [가상계좌 승인 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/vbank-result-code): 가상계좌 발급, 통보, 과오납 체크 등에서 응답될 수 있는 결과 코드를 안내합니다.
- [휴대폰 소액결제 승인 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/cellphone-result-code): 휴대폰 소액결제 승인 결과 코드와 메시지를 안내합니다.
- [승인 취소 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/cancel-result-code): 승인 취소 API 결과 코드와 메시지를 안내합니다.
- [간편결제 승인 응답 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/easypay-result-code): 간편결제 제휴사 결과 코드와 메시지를 안내합니다.
- [빌키 발급, 삭제 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/billing-result-code): 빌키 발급 및 삭제 결과 코드와 메시지를 안내합니다.
- [페이유 서비스 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/payu-result-code): PAYU 서비스 결과 코드와 메시지를 안내합니다.
- [페이유 계좌간편결제 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/cmsbank-result-code): PAYU 계좌간편결제 결과 코드와 메시지를 안내합니다.
- [대사 조회 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/reconciliation-result-code): 대사 조회 API 결과 코드와 메시지를 안내합니다.
- [지급대행 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/payout-result-code): 지급대행 API 결과 코드와 메시지를 안내합니다.
- [현금영수증 발급 결과 코드](https://developers.nicepay.co.kr/docs/pg/result-code/cash-receipt-result-code): 현금영수증 발급 결과 코드와 메시지를 안내합니다.

## CMS

- [CMS 서비스 개요](https://developers.nicepay.co.kr/docs/cms/intro): CMS 연동 개요 문서입니다. 세부 내용은 문서 개편에 따라 변경될 수 있습니다.

## Routing Hints

- 결제창 호출 또는 인증 응답 질문: `PG 인증 결제 > 결제창 호출하기`
- 승인 요청 파라미터, AuthToken, TxTid, NextAppURL 질문: `PG 인증 결제 > 승인 API 연동하기`
- 승인 요청 실패, timeout, NetCancelURL 질문: `PG 인증 결제 > 망취소 API 연동하기`
- 취소, 부분취소, 환불계좌 질문: `승인 취소 API 연동하기` 또는 `비인증 승인 취소 API 연동하기`
- WebView, Android package, iOS scheme 질문: `부가 서비스 > APP WebView 연동하기`
- ResultCode 또는 오류 메시지 질문: `결과 코드` 섹션의 결제수단별 문서