# 페이플 개발자센터

> 페이플 결제 연동 문서의 목차입니다. 연동할 결제 방식을 고른 뒤 해당 문서 원문(.md)을 읽어 주세요.
>
> 정기결제와 빌링(빌링키 결제)은 같은 말입니다.
> 간편페이는 네이버페이, 카카오페이 같은 간편결제 서비스입니다. 페이플에 카드나 계좌를 등록해 비밀번호로 결제하는 비밀번호 간편결제와는 다른 상품입니다.
> 정산지급대행은 정산금 이체(플랫폼정산자동화)와 계좌조회로 나뉩니다.

- 국내, 해외, 정산지급대행은 인증 방식, 키, 성공 응답 코드, 승인 절차가 서로 다릅니다. 고른 문서 하나를 기준으로 구현하고, 다른 서비스의 키나 응답 코드를 섞지 마세요.
- custKey, service_key, PCD_REFUND_KEY 처럼 외부에 노출되면 안 되는 키는 서버에서만 사용하세요. clientKey는 결제창을 호출하는 JavaScript에서 쓰는 클라이언트키이며, 등록한 도메인에서만 동작합니다. 테스트와 라이브 키는 환경별로 분리하세요.
- 문서에 없는 파라미터나 값은 만들어 넣지 말고, 확인이 필요하다고 알려 주세요.

## 결제창 스크립트

결제창을 띄우는 연동은 아래 순서로 스크립트를 페이지에 넣습니다. 정산지급대행과 대사는 서버 API 만 있어 스크립트가 없습니다.

1. 사전 로드 (jQuery): 결제창 스크립트보다 먼저 넣습니다.

   <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>

2. 결제창 스크립트

| 서비스 | 테스트 | 라이브 | 호출 함수 |
| --- | --- | --- | --- |
| 국내 카드/계좌 | https://democpay.payple.kr/js/v1/payment.js | https://cpay.payple.kr/js/v1/payment.js | PaypleCpayAuthCheck(obj) |
| 해외 카드 | https://demo-gpay.payple.kr/common/js/gpay-1.0.1.js | https://gpay.payple.kr/common/js/gpay-1.0.1.js | paypleGpayPaymentRequest(obj) |

## 시작하기

- [테스트 환경과 확인사항](https://docs.payple.kr/v2/md/ref/keys.md): 서비스별 테스트 키(clientKey, cst_id, custKey, service_id, service_key, PCD_REFUND_KEY)와 접속 도메인, 테스트와 라이브 차이, 연동 전 확인사항(화이트 IP 등록 등)
- [웹훅](https://docs.payple.kr/v2/md/ref/webhook.md): 결제 완료, 취소 완료, 결제수단 등록, 해지, 이체실행 완료 결과를 받는 이벤트와 필드, 예시

## 국내 일반 결제: 구매자가 결제창에서 직접 결제합니다

- [국내 카드 앱카드(간편페이) 결제](https://docs.payple.kr/v2/md/card-app.md): 네이버페이, 카카오페이, 카드사 앱카드 결제. 인증 결과의 PCD_PAY_COFURL 로 승인
- [국내 카드 비밀번호 간편결제](https://docs.payple.kr/v2/md/card-pwd.md): 카드 등록 후 비밀번호로 결제. 재결제는 저장한 빌링키(PCD_PAYER_ID)로
- [국내 계좌 비밀번호 간편결제](https://docs.payple.kr/v2/md/bank-pwd.md): 계좌 등록 후 비밀번호로 출금. 재결제는 저장한 빌링키(PCD_PAYER_ID)로

## 국내 정기(빌링) 결제: 빌링키로 서버에서 결제창 없이 승인합니다

- [국내 카드 정기(빌링) 결제](https://docs.payple.kr/v2/md/card-bill.md): 등록만(AUTH) 또는 등록과 첫 결제(CERT) 후 빌링키로 서버 승인
- [국내 카드 간편페이 정기(빌링) 결제](https://docs.payple.kr/v2/md/card-easy-bill.md): 네이버페이, 카카오페이 카드로 빌링키 발급(PCD_EASYBILL_FLAG, CERT 만) 후 재결제
- [국내 계좌 정기(빌링) 결제](https://docs.payple.kr/v2/md/bank-bill.md): 계좌 빌링키 발급 후 서버에서 정기 출금

## 국내 링크 결제: 결제창을 띄울 화면이 없을 때 씁니다

- [링크결제](https://docs.payple.kr/v2/md/link.md): 결제 링크 생성(LINKREG) 후 구매자에게 전달. 필요 시 만료(LINKEXPIRE), 결제상태 조회(LINKSTATUS)

## 국내 정산지급대행: 결제 이후 정산금을 지급하고 계좌를 인증합니다

- [정산지급대행 플랫폼정산자동화](https://docs.payple.kr/v2/md/hub-payout.md): 계좌조회 후 이체 대기(group_key), 이체 실행, 웹훅으로 건별 결과 수신
- [정산지급대행 계좌조회](https://docs.payple.kr/v2/md/hub-verify.md): 예금주명과 계좌번호 확인. 송금 전에 씁니다

## 해외 일반 결제: 구매자가 결제창에서 직접 결제합니다

- [해외 카드 키인 결제](https://docs.payple.kr/v2/md/intl-key.md): 카드 정보를 직접 입력받는 해외 카드 결제. 결과는 resultUrl 로 수신

## 해외 정기(빌링) 결제: 빌링키로 서버에서 결제창 없이 승인합니다

- [해외 카드 정기(빌링) 결제](https://docs.payple.kr/v2/md/intl-bill.md): 첫 결제로 billing_key 발급, 재결제마다 새 토큰으로 서버 승인

## 대사

- [대사 국내 거래](https://docs.payple.kr/v2/md/recon-tx.md): 기간 내 승인, 취소 거래를 내려받아 자체 장부와 맞춰봅니다.
- [대사 국내 정산](https://docs.payple.kr/v2/md/recon-settle.md): 정산 대상 거래를 조회해 입금액과 맞춰봅니다.

## 참고 문서

- [응답 코드](https://docs.payple.kr/v2/md/ref/response-code.md): 영역별 응답 코드(INDEX, AUTH, PCCF, SPCD, PCHK, LINK, PSTL, 해외 T, R, A 등)와 원인. 같은 숫자라도 영역마다 뜻이 다릅니다
- [코드표](https://docs.payple.kr/v2/md/ref/codes.md): 국내 카드사, 금융기관, 해외 국가, 미국/캐나다 행정구역, 해외 위험국가 코드
- [웹뷰 연동 주의사항](https://docs.payple.kr/v2/md/ref/webview.md): 앱 웹뷰에서 결제창을 띄울 때 외부 앱 호출과 앱 스킴(PCD_APP_SCHEME)
- [간편페이 추가 연동](https://docs.payple.kr/v2/md/ref/easypay.md): 기존 국내 카드 연동에 네이버페이, 카카오페이를 추가할 때 체크포인트

## Optional

- [자주 묻는 질문](https://docs.payple.kr/v2/md/ref/faq.md): 해외 카드, 국내 카드/계좌, 링크결제, 정산지급대행 문의 모음
- [업데이트 노트](https://docs.payple.kr/v2/md/ref/update-notes.md): 문서와 연동 스펙의 변경 이력