나이스페이 일반인증결제 및 비인증(정기)결제 방식 PG설정 및 연동 방법 안내 드립니다.
[나이스페이 일반인증방식결제 PG설정 방법 - 실운영모드]
해당 상점정보를 가맹점에서 직접 아임포트 관리페이지에 셋팅하여 결제모듈 연동이 필요합니다.
1. 아임포트 관리자콘솔( https://admin.iamport.kr ) 로그인 → 결제연동→ 실 연동관리 →나이스페이먼츠 → 나이스페이먼츠 → 추가 후 상점정보 입력
- PG상점아이디 (MID) , Key, 결제취소 비밀번호, 가상계좌 입금통보설정 부탁 드립니다.
- PG상점아이디 : 10자리로 상점아이디 뒤 영문소문자m까지 붙여서 설정
- PG상점 Secret : 연동 KEY
- 결제취소 비밀번호 : 나이스페이 어드민에 설정한 거래취소비밀번호
2. PG 실 운영 상점정보 조회 방법
1) MID , key : 나이스페이 상점관리페이지(https://pg.nicepay.co.kr) → 가맹점정보→ KEY 관리 에서 확인 가능합니다.
2) 결제취소 비밀번호 : 나이스페이 상점관리페이지(https://pg.nicepay.co.kr) → 가맹점정보 → 비밀번호관리 → 거래취소비밀번호 에서 설정 및 확인 가능합니다.
[가상계좌를 이용하는 경우 필수설정]
구매자가 가상계좌로 입금을 하게되면, PG사로부터 '입금완료' 통지가 전달되고 있습니다.
(PG사 → 아임포트 → 가맹점 순)
이에 따라 아래와 같이 입금통지를 받을 수 있는 두가지의 URL설정이 필요합니다.
1) 가상계좌 입금통보URL : PG사로부터 통지받을 “아임포트의 서버 URL” (PG사에 설정필요)
2) 웹훅URL : 아임포트로부터 통지받을 “가맹점의 웹서버URL” (아임포트 관리자페이지에 설정필요)
ⓐ 가상계좌 입금통보URL 설정
(PG사 → 아임포트 서버 입금완료 통지)
- 설정 방법 :
나이스페이 상점관리페이지(https://pg.nicepay.co.kr) > 가맹점 정보 > 기본정보 메뉴에서, "결제데이터통보" 의 가상계좌 부분에https://service.iamport.kr/nice_payments/notice_vbank
입력, 재전송간격 1분 , 재전송 횟수 1회혹은 그 이상으로 설정, OK체크, 가맹점 이메일 입력 후 [저장] 버튼 클릭 합니다.
ⓑ 웹훅 URL(Notification url) 설정
-설정 방법 : 아임포트관리자페이지( https://admin.iamport.kr ) >결제연동 → 실 연동 관리 → 실 결제 전용 결제알림 (Webhook) 에서 결제 직후 아임포트웹훅(Notification URL) 을 통해 통지를 받습니다.
- 참고 : PG사에서 통지 받는대로 아임포트 서버가 일종의 클라이언트 역할을 하여 지정된 URL로 POST요청을 보내는 개념으로 해당 URL을 통해 가상계좌 입금 여부 확인 가능합니다.
- 웹훅 연동매뉴얼 : https://portone.gitbook.io/docs/result/webhook
- 워드프레스 우커머스 이용시 설정 방법 : 웹훅URL 자동설정(버전 2.1.11 이상 지원)
- 워드프레스 아임포트 결제버튼생성플러그인 이용시 설정 방법 : https://portone.gitbook.io/docs/wordpress/wordpress/button 의 STEP2 가맹점 정보 입력하기에서 "0. 가상계좌 입금통보 설정"의 가상계좌 입금통보 URL을 그대로 복사하여 아임포트관리자페이지 > 시스템설정 > 웹훅(Notification 설정) 에 설정 해 줍니다.
4. 결제 연동
- 일반인증결제방식 연동매뉴얼(통합) : https://portone.gitbook.io/docs/auth/guide
- 참고 : 워드프레스 이용하시는 경우 연동 방식이 상이하므로,
워드프레스 플러그인별 결제연동 셋팅 방법은 해당 링크내용 참고하시어 진행 부탁 드립니다.
[나이스페이 비인증결제(정기(빌링)결제) PG설정 방법-실운영모드]
1. 아임포트 관리자콘솔( https://admin.iamport.kr ) 로그인 → 결제연동→ 실 연동관리 →나이스페이먼츠 → 나이스페이먼츠API → 추가 후 상점정보 입력
- PG상점아이디 : 10자리로 상점아이디 뒤 영문소문자m까지 붙여서 설정
- PG상점 Secret : 연동 KEY
- 결제취소 비밀번호 : 나이스페이에 설정한 거래취소비밀번호
2. PG상점정보 확인은 나이스페이 상점관리페이지(https://npg.nicepay.co.kr/) 비인증결제용 MID로 로그인
- KEY : 가맹점정보> KEY관리 에서 확인 가능합니다.
- 결제취소 비밀번호 : 가맹점정보 > 비밀번호관리 > 거래취소비밀번호 에서 설정 가능합니다.
위 설정이 모두 끝나시면 아임포트관리자페이지 > 시스템설정 > PG설정(정기결제/비인증방식)에서 [저장] 클릭 부탁 드립니다.
3. 나이스페이 REST API 비인증결제 연동 방법
1) API를 이용한 방식(신용카드) : 나이스페이먼츠(나이스정보통신) 비인증결제
- 나이스페이먼츠는PG사에서 제공하는 결제창 없이 API 통신으로 결제가 이루어지기 때문에 결제창을 직접 만드셔야하고, 직접 개발하시기 때문에 결제창 커스터마이징이 가능합니다.
결제 과정에서의 암호화를 필수로 하여 보안에 신경써주셔야한다는 차이가 있습니다.
- 나이스페이먼츠 비인증결제 보안 적용 기준 : PG사에서 보안관련해서 규정하고 있는 내용은 별도로 없습니다만,
브라우저 - 운영하시는 서버 - 아임포트 - PG사 의 순으로 데이터가 전달될텐데요
브라우저 - 운영하시는 서버로 전송되는 구간에 SSL적용을 해주셔야 합니다.
카드데이터가 전송되는 구간은 https를 적용해 암호화된 통신을 제공하시는 것을 권장드리고 있습니다.
[참고]
- 사용자 동의 : 가맹점에서 직접 결제창 개발을 진행하는 방식이어서 해당 부분도 포함하여 개발 진행 부탁 드립니다.
2) 결제 연동관련
- 기술적인 동작 원리는, 카드번호 + 유효기간 + 생년월일 + 비밀번호 앞2자리정보를 등록해 카드사로부터 빌링키를 발급받고 원하시는 때에 해당 빌링키로 언제든지 재 결제할 수 있는 방식입니다.
아임포트 REST API를 통해 이 모든 과정을 진행하실 수 있으며, 빌링키는 아임포트내 안전하게 보관하기 위해 직접 응답해드리지는 않으며
빌링키 발급 당시에 임의로 "카드당 고유한 Unique ID"인 customer_uid를 보내주시면 아임포트 내부적으로 1:1로 매칭해놓고 처리하게 됩니다.
보다 자세한 내용은 아래 매뉴얼 및 API테스트 페이지 내용 참고해주시고, 관련사항으로 기술지원이 필요하신 경우 support@iamport.kr 로 문의 부탁 드립니다.
-비인증결제 연동 매뉴얼(REST API)
-나이스페이 비인증결제 연동 샘플페이지
3) API 테스트 페이지: https://api.iamport.kr/
- 비인증결제 API
아임포트에서 스케쥴러를 돌려주길 원하시면
- schedule방식은 이미 최초에 사용자로부터 카드정보를 받아 빌링키를 발급해놓고(이것을 customer_uid에 매칭시켜놓고) 결제가 필요할 때 마다 customer_uid만 활용하는 방식으로,
최초에 /subscribe/customers/{customer_uid} POST로 한 번 등록해두시면 schedule unschedule을
사용자 액션없이 자유롭게 처리하실 수 있습니다.
- 최초 카드정보등록으로 빌링키발급 및 발급된 빌링키에 customer_uid로 1:1대응 후 아임포트내 저장
- 결제일자가 확정되는 시점에 schedule API로 일정 / 금액 / 결제할 customer_uid 등 지정
- 해당 시각에 처리가 완료되면 성공/실패 여부를 webhook(Notification URL로 보내드립니다.) 으로 POST요청
- 결제 성공이면 webhook에서 크레딧 증가 후 다음 schedule등록 API추가(실패면 다음날로 다시 등록) 날짜는 서비스 특성에 따라 다소 달라질 수 있지만 날짜 문제를 없애기 위해 +N day 식으로 처리를 하고 있습니다.
- 워드프레스 우커머스 서브스크립션 플러그인으로 정기결제 이용시 링크 내용 참고바랍니다.
