환불될 계좌 번호와 예금주가 일치하지 않는 경우 발생 합니다.
입력 정보를 확인하고 문제가 동일하게 반복되는 경우 API로그 정보를 포함하여 1:1문의를 진행해 주세요.

가맹점으로 정산이 가능한 금액보가 큰 취소금액요청이 오는 경우 발생 됩니다.
미정산 금액의 체크를 위해 1:1 문의를 진행해 주세요.

간편결제의 경우 포인트가 포함된 복합결제가 발생 될 수 있습니다.
복합결제의 경우 분취소가 불가능할 수 있어 전체 취소 후 재결제 진행이 필요 할 수 있습니다.

상세한 사유 확인이 필요한 경우 주문번호, 결제일자 및 시간을 포함하여 1:1문의를 이용해 주세요.

이미 취소된 거래건에 중복된 취소요청을 하는경우 발생되는 오류 입니다.

API 연동을 통한 취소/환불

- 각 결제 수단별 취소/환불 API를 통해 전체/부분 취소 및 환불 처리가 가능합니다.

가맹점관리자를 통한 취소/환불

- 가맹점관리자에 접속하여 취소/환불이 필요한 거래를 조회 합니다.

- 전체/부분 취소 기능을 활용하여 처리 합니다.

취소/환불이 원할하지 않은 경우 1:1문의를 이용해 주세요.

가맹점 체크사항

현금영수증 발급 API의 인코딩은 UTF-8로 처리 됩니다. 현금영수증 API 호출시 인코딩을 확인해 주세요.

사용자 체크사항

사용자의 브라우저 인코딩 설정이 유니코드(UTF-)8로 되어 있는지 체크 합니다.

빌키 발급 API를 호출하는 경우 카드번호와 유효기간의 검증을 진행하지 않습니다.
실제 결제(승인)을 통해 카드번호 및 유효기간의 검증을 진행 할 수 있습니다.

예시 URL을 참고하여 에스크로 가입사실 확인증을 확인하시기 바랍니다.

호출방식
https://npg.nicepay.co.kr/issue/issueEscrow.do?CoNo=사업자번호

예시
https://npg.nicepay.co.kr/issue/issueEscrow.do?CoNo=8158100527 

PAYYAP은 API를 통해 서비스가 제공되어 HTTP Client 구성이 가능한 모든 개발언어에서 사용이 가능합니다.

샘플코드가 필요한 경우 Github을 이용 해주세요.
https://github.com/nicepayments 

PAYYAP Java-script SDK는 PC/Mobile 환경을 자동 분류하여 결제창을 호출합니다. 

샌드박스에서 테스트 하는경우 실제카드를 통해 결제 테스트를 하여도 결제(승인)이 발생되지 않아 편리하게 이용이 가능합니다.

샌드박스(테스트상점)과 운영상점은 ClientId와 SecretKey를 통해 구분되기 때문에 주의해주세요.

*회원가입후 테스트상점을 생성하면 샌드박스 개발환경을 이용할 수 있습니다.

결제API응답 전문중 payMethod 값을 통해 결제수단 정보 확인이 가능합니다.

 

결제 승인 API응답을 통해 결제 영수증 확인이 가능한 URL이 응답 됩니다.
응답된 URL링크를 결제고객에게 제공 하여 결제영수증(매출전표)을 서비스 할 수 있습니다.

고객입금 직후부터 통신상태에 따라 최대 2분정도 소요됩니다.

가상계좌 입금시 은행 네트워크 상황에 따라 입금완료 상태 변경 까지 최대 2분이 소요 될 수 있습니다.
지속적으로 입금 확인이 되지 않는 경우 계좌정보와 입금내역증을 첨부하여 1:1 문의를 진행 해주세요.

설정된 웹훅 End-point로 웹훅을 전송하여 응답전문 body에 'ok' 문자열이 확인되지 않은 경우 웹훅 오류가 발생 합니다.

가맹점관리자 -> 개발정보 에서 웹훅 Test를 통해 응답전문 body에 'ok'문자열이 표기되는지 확인 해주세요.

구매자명과 입금자명이 상이해도 결제 가능합니다.

한번 생성된 가상계좌의 속성은 변경 할 수 없습니다.
취소 요청을 통해 채번된 가상계좌를 만료 처리 후 신규 가상계좌 채번을 진행 해주세요.

발급된 가상계좌의 채번 취소취소 API를 이용하여 취소가 가능합니다.

홈페이지 개발가이드에서 취소API 매뉴얼을 확인 해주세요.

가상계좌 발급 요청 파라미터 중 가상계좌 유효시간 설정을 통해 입급시간 제한 설정이 가능 합니다.

가상계좌 채번시 vbankValidHours 필드 값으로 10 을 입력하면,

가상계좌 발급후 10시간동안 해당 가상계좌를 이용할 수 있습니다.

자세한 사항은 홈페이지 개발가이드->결제창 매뉴얼을 참조 해주세요.

채번된 가상계좌 입금 여부는 다양한 방식으로 확인 할 수 있습니다.

1) 웹훅을 통한 확인

로그인->개발정보 이동 후 가상계좌 웹훅을 등록하여 입금 이벤트 확인

2) 거래조회 API 호출

가상계좌 승인키(tid)를 통해 거래조회 API 호출

3) 가맹점 관리자를 통한 확인

가맹점관리자를 통해 거래조회 후 입금 여부 확인

가상계좌의 경우 채번(가상계좌 생성)시점과 입금여부에 따라 가상계좌의 상태 차이가 발생합니다.
가상계좌 상태에 따라 API호출 방식의 차이가 발생하기 때문에 주의 해주세요.

입금전

- 승인키(tid)값을 통해 취소 요청 하는 경우 채번(가상계좌 생성) 취소상태로 변경되며 채번(가상계좌 생성)된 계좌로 입금이 불가 합니다.

입금후

- 입금 완료된 가상계좌 거래는 채번(가상계좌 생성) 취소가 불가 합니다.

- 환불을 원하는 경우 환불계좌 정보 입력하여 취소 API를 호출 해주세요.

네 가능합니다. 카드 하나에 빌키 발급 갯수의 제한은 없습니다.

카드사 정책에 따라 발급사와 매입사가 다를 수 있습니다.
매입사와 카드사 코드 확인을 원하는 경우 개발자 매뉴얼을 확인해주세요.

https://github.com/nicepayments/nicepay-manual/blob/main/common/code.md 

결제금액은 Integer type으로 숫자만 입력할 수 있습니다.
다른 문자열이 포함되지 않았는지 지원 type으로 값이 설정되었는지 확인 해주세요.

결제 API 호출시 결제금액과 면세금액만 설정하면 복합과세 정보가 자동으로 적용됩니다.

https://github.com/nicepayments/nicepay-manual/blob/main/api/payment-window-server.md 

APP연동시 URL 스키마 설정이 필요 합니다. 상세 내용은 매뉴얼을 확인 해주세요.

https://github.com/nicepayments/nicepay-manual/blob/main/api/app.md 

원활한 통신을 위해 서버의 HTTP 클라이언트는 TLS 1.2에 대응되는지 확인해주세요.

서버에서 결제 API호출을 위해 필요한 서비스의 IP를 방화벽에서 허용해주세요.

결제창 JS SDK
- IP : 210.108.219.205/27
 

API

- 프로토콜 : HTTPS

- 포트 : 443

- IP : 210.108.219.202/27

웹훅

- 프로토콜 : HTTPS

- 포트 : 443

- IP : 210.108.219.200

요청지 서버에서 SSL 지원이 되지 않는 경우 오류가 발생합니다.

서버 설정을 통해 SSL이 지원 되도록 설정 해주세요.

해외카드 결제 시 발생하는 카드사 오류입니다.

개인정보보호법에 따라 카드 소유주가 직접 카드사에 문의하시는 것을 권장 드립니다.

잔액 부족으로 인한 카드사 오류입니다.
결제 진행중인 카드의 잔액이 충분한지 확인 해주세요.

별도의 유효기간 없이 사용 가능합니다.

하지만 빌키에 종속된 카드의 유효기간이 만료되거나 빌키-삭제API를 통해 빌키를 삭제한 경우 활용이 불가 합니다.

PAYYAP에서 제공하는 현금영수증 API와 현연금영수증 호출 url link를 통해 연동이 가능합니다.
 

제공되는 현금영수증 관련 인터페이스

- 현금영수증 발급 API

- 현금영수증 조회 API

- 현금영수증 노출 URL

- 현금영수증 삭제 API

https://github.com/nicepayments/nicepay-manual/blob/main/api/payment-receipt.md 

가맹점관리자 로그인 화면에서 비밀번호 재설정 기능을 제공합니다.

① "비밀번호를 잊으셨나요?" 버튼 클릭하여 가입 이메일로 비밀번호 재설정 링크 발송

② 수신 이메일을 통해 새로운 비밀번호 설정 (8~16자리, 영문, 숫자, 특수문자 포함)

정보통신망 이용촉진 및 정보보호 등에 관한 법률 제28조 1항 제2호에 의거하여 개인 정보 보호 및 안정적인 서비스 제공을 위하여 가맹점관리자 로그인 2차 인증 기능을 적용합니다.

따라서, 개인정보에 대한 불법적인 접근을 차단하기 위한 침입차단 시스템으로 제외처리 불가한 점 양해 부탁드립니다.

상점의 연간 매출액 신고 기준으로 연 2회 우대수수료가 변경 적용됩니다.

아래 안내를 참고하여 주시기 바랍니다.

① 적용 시점 : 매 반기 영중소 구분 자료에 따른 구간별 우대수수료 적용 (1/31, 7/31 연 2회)

② 사업자 속성 확인 : 로그인->상점설정->기본정보관리

③ 적용 수수료 확인 : 로그인->상점설정->이용서비스관리

담당자 정보는 직접 변경하실 수 있습니다. 담장자 정보 외에도 다음의 정보를 직접 변경하실 수 있습니다.

"변경하기" 버튼을 클릭하여 안내에 따라 변경신청해 주시면, PAYYAP 담당자가 확인 후 처리해 드립니다.

① 로그인->상점설정->기본정보관리

② 변경가능정보

 - 상점정보 : 상점명/세금계산서 수신이메일/상점URL(홈페이지URL)

 - 사업자정보 : 상호명/대표자정보/주소/업종/업태

 - 정산정보 : 정산계좌번호

에스크로 메뉴에서 최근 6개월간의 에스크로거래중 배송정보가 미등록 된 거래를 제공합니다.

"등록하기" 버튼을 통해 배송정보를 등록하실 수 있습니다.

① 로그인->결제정보->에스크로

에스크로 상태가 배송등록/배송완료인 경우에 고객에게 에스크로 메일 재발송이 가능합니다.

① 로그인->결제정보->에스크로 이동 후 거래 조회 후 메일 재발송 버튼 클릭

에스크로 거래상태를 안내드립니다.

① 결제완료: 거래에 대한 결제가 완료된 상태

② 배송등록: 가맹점에서 배송등록을 완료한 상태

③ 배송완료: 상품 배송이 완료된 상태

④ 구매확정: 고객이 에스크로 거래로 결제한 상품 수령 후, 구매확인을 완료한 상태

⑤ 구매거절: 고객이 구매를 거절한 상태

⑥ 환불처리: 환불 처리가 된 상태

⑦ 지급완료: 정산지급이 완료된 상태

현금영수증 등록이 실패되었을 경우 다음 내용을 확인하시고 수정하여 재등록해주시기 바랍니다.

① 파일 형식이 csv 또는 xls 인지 확인

② 거래금액 등 필수 입력항목이 모두 입력되었는지 확인

가상계좌/계좌이체 거래내역 취소 시 현금영수증 자동취소 됩니다.
단 가맹점관리자를 통해 추가발급하셨을 경우에는 별도 취소처리 필요합니다. (부분취소도 동일)

변경필요한 내역을 체크한 후 ‘취소’ 버튼을 클릭하면 취소가능합니다.
취소를 진행할 경우, 요청상태인 건은 요청취소, 요청완료인 건은 취소됩니다.

로그인->결제정보->현금영수증내역을 확인해주세요. 

현금영수증 상태를 '자진발급'으로 설정하는 경우 010-000-1234로 신고 되며,
결제 고객의 승인번호를 바탕으로 국세청에 고객이 재신고가 가능합니다.

홈택스(hometax.go.kr) [로그인] - [조회/발급] - [현금영수증] - [현금영수증 수정] - [자진발급분 소비자/사업자 등록]

현금영수증 내역을 조회하여 변경 필요한 내역을 체크한 후 ‘변경’ 버튼을 클릭하면 해당 현금영수증에 대한 용도(소득공제-지출증빙) 변경과 함께 발행번호 변경이 가능합니다.

로그인->결제정보->현금영수증내역을 참조해주세요. 

신용카드 거래 중 카카오머니 결제내역은 카드매출이 아닌 현금성 매출에 포함 됩니다.

로그인 패스워드는 다음의 규칙에 따라 설정해 주셔야합니다.

① 8자리 이상 20자리 이하의 영문,숫자,특수문자 조합

② 사업자번호, 대표자주민등록번호, 전화번호 사용불가

③ 최근에(4회) 사용한 비밀번호로 재설정 불가

- 신용카드 

① 승인 : 정상적으로 결제완료된 거래

② 전취소 : 결제 당일, 신용카드사로 매입되기 이전에 결제 취소 요청된 거래로 정산대상에서 제외됨

③ 후취소 : 결제 익일 이후 카드사로 매입이후에 전액 취소된 거래로 정산일 이전 취소시 정산대상에서 제외됨

④ 부분취소 : 결제거래의 일부 금액만 취소요청된 거래

- 가상계좌

① 입금 : 정상적으로 가상계좌로 입금완료된 거래

② 환불 : 입금완료 이후 취소 요청된 거래로 고객 환불계좌를 입력 후 환불요청된 거래

④ 부분환불 : 결제 금액의 일부 금액만 환불 요청된 거래 고객환불계좌를 입력 후 환불요청된 거래

⑤ 입금대기 : 가상계좌번호 채번 후 미입금 상태의 거래
⑥ 채번취소 : 가상계좌번호로 미입금상태에서 채번 취소된 거래

- 공통

① 실패 : 정상적으로 (승인)결제가 처리되지않고 실패된 거래

일부 카드사의 경우, 일정기간동안 승인이 발생하지 않으면 서브몰 등록이 자동 해지됩니다.
결제가 필요하신 경우, 다시 재심사 요청가 필요합니다. (심사 기간은 영업일 기준 D+2~10일 소요)

가맹점관리자페이지에서 빌링 결제 요청을 하시는 경우 결제요청일 오전 9시~10시 사이에 승인 되며, 결제 건이 다량일 경우 시간차가 있을 수 있습니다.

결제고객은 다음의 3가지 방법을 통해 카드전표나 현금영수증을 확인 할 수 있습니다.

① 결제 고객의 이메일로 발송된 이용내역 안내 이메일 내 거래확인서 발급

② 홈페이지 거래내역 조회 메뉴를 통한 발급 

③ 로그인->결제정보->결제내역 에서 거래 조회 후 "영수증 발송" 을 통한 발급

당사는 이용자의 개인정보를 수집하지 않기 때문에 이용자의 정보 확인은 불가합니다.

결제정보(거래일,승인번호 또는 주문번호, 거래금액)를 확인하시어 1:1 문의를 해주세요.

신용카드 결제는 취소 당일 중에 취소 원복이 가능합니다.

① 로그인->결제정보->결제내역 메뉴에서 거래 조회 후 "취소철회" 버튼 클릭

② 철회 사유 입력후 "취소 철회하기" 클릭

③ 철회 불가 거래 : 체크카드 결제, 복합결제(포인트 사용), 특화카드 결제(선불카드,기프트카드 등), 간편결제

④ 거래일과 취소일이 다르고, 취소일 당일에 한해서 취소 원복 가능

거래내역조회에서 해당 거래 조회 후 우측 취소버튼을 클릭하여 안내에 따라 취소가능 합니다.

로그인->결제정보->결제내역 정보를 참조해주세요. 

결제수단별 취소/환불 완료기간 안내드립니다.

① 신용카드 : 결제 당일 취소 시 즉시 한도 복구, 1일 이후 취소 또는 부분취소는 취소일로부터 4~5일 이후

② 체크카드 : 결제 당일 취소 시 당일 입금, 1일 이후 취소 또는 부분취소는 취소일로부터 4~5일 이후

③ 가상계좌 : 환불요청일로 부터 2일 이후

승인번호는 카드 결제 시 카드사에서 생성되는 숫자 8자리의 번호입니다.

상점의 연간 매출액 신고 기준으로 연 2회 우대수수료가 변경 적용됩니다.

아래 안내를 참고하여 주시기 바랍니다.

① 적용 시점 : 매 반기 영중소 구분 자료에 따른 구간별 우대수수료 적용 (1/31, 7/31 연 2회)

② 사업자 속성 확인 : 로그인->상점설정->기본정보관리

③ 적용 수수료 확인 : 로그인->상점설정->이용서비스관리
 

결제창 호출시 파라미터 설정을 통해 노출되는 결제수단을 설정 할 수 있습니다.
매뉴얼을 확인하여 요청값을 설정해 주세요.

결제내역 조회시 상세조회 버튼을 클릭하여 거래상태를 "입금대기"로 선택하여 조회 가능 합니다.

구매자명과 입금자명이 상이해도 결제 가능합니다.

다만, 신청한 이름과 입금자명이 상이할 경우 확인 처리가 불가능합니다.

API의 기본 인코딩은 UTF-8 입니다.
API연동시 인코딩이 UTF-8인지 확인해 주세요.

중복되지 않은 주문번호 값을 활용하여 결제창을 호출해주세요.

모든 결제의 주문번호는 유니크한 값(중복되지 않은 문자열)로 생성되어야 합니다.  

에스크로 메뉴에서 구매거절미처리 내역을 제공합니다.

"취소하기" 버튼을 통해 거래를 취소처리해 주셔야 완료되며, 부분취소는 불가합니다.

구매확정 이후에는 취소가 불가능합니다.

PAYYAP은 계약자 본인 외 타인 계좌로 정산처리가 불가능 합니다.

결제수단별 취소 가능 기간에 대해 안내드립니다.

① 신용카드: 1년 이내
② 가상계좌: 180일 이내
③ 계좌이체 : 180일 이내
④ 휴대폰 : 당월 내(1일 ~ 말일)