간편결제 개요 API
간편결제는 사용자가 미리 등록해 둔 결제 수단을 통해 간편하게 결제할 수 있는 서비스입니다. 헥토파이낸셜 PG에서는 페이코, 카카오페이, 네이버페이, 토스페이를 지원합니다.
지원 간편결제사
| 간편결제사 | 코드 | 설명 |
|---|---|---|
| 삼성페이 | SSP | 삼성페이 간편결제 (갤럭시 기기/QR결제) |
| 페이코 | PAC | NHN 페이코 간편결제 |
| 카카오페이 | KKP | 카카오페이 간편결제 |
| 네이버페이 | NVP | 네이버페이 간편결제 |
| 토스페이 | TOS | 토스페이 간편결제 (카드/토스머니) |
공통 특징
- 모든 간편결제는 결제창 방식으로 연동됩니다.
- API 엔드포인트:
/corp/main.do - 결제수단 코드:
corp(고정값) corpPayCode파라미터로 간편결제사를 구분합니다.
테스트용 키 정보
API 정보
POST/corp/main.do
Content-Type
application/x-www-form-urlencoded테스트
https://tbnpg.settlebank.co.kr/corp/main.do운영
https://npg.settlebank.co.kr/corp/main.do간편결제별 특이사항
삼성페이 (SSP)
NOTE
삼성페이 이용 환경
삼성페이는 삼성 갤럭시 기기에서만 이용 가능합니다. PC 환경에서는 QR코드 결제를 지원합니다.
- API 엔드포인트:
/card/cardDirect.do(다른 간편결제와 상이) cardGb파라미터에SSP값을 설정합니다.
페이코 (PAC)
- 인증/승인 분리형(하이브리드) 방식 지원
- 거래상태코드
0061로 인증 완료 상태 구분 가능
카카오페이 (KKP)
카카오페이 테스트 안내
테스트 환경에서도 실제 결제가 이루어집니다. 테스트 환경에서 결제된 거래는 자동 취소됩니다.
- 과세 유형별 결제수단 제한:
- 과세/비과세: 신용카드, 머니, 머니+포인트 복합결제
- 복합과세: 신용카드 단독만 가능
네이버페이 (NVP)
NOTE
네이버페이 테스트 안내
네이버페이 테스트는 네이버 계정이 필요합니다.
- 현금영수증 발급 금액은 결제 금액과 상이할 수 있습니다.
- 적립성 포인트가 아닌 충전결제 포인트 금액만 현금영수증 발급됩니다.
토스페이 (TOS)
NOTE
토스페이 결제 타입
토스페이는 카드결제(CARD)와 토스머니(MONEY) 두 가지 결제 타입을 지원합니다.
corpPayType파라미터로 결제 타입을 선택합니다.- 카드결제: 토스에 등록된 카드로 결제
- 토스머니: 토스머니 잔액으로 결제
연동 순서
- 결제 요청: 상점에서 헥토파이낸셜 PG로 결제 요청 전송
- 결제창 표시: 고객이 해당 간편결제사 결제창에서 결제 진행
- 결제 완료: 결제 완료 후
nextUrl로 화면 전환 - 노티 수신:
notiUrl로 결제 결과 통보 수신 (Server to Server)
