Guide > 제휴간편결제

제휴간편결제

제휴간편결제 서비스

NHN KCP에서는 페이코 간편결제와 각 간편결제사들과 제휴된 간편결제 서비스를 제공합니다.
간편결제 서비스마다 포인트와 머니 사용 여부가 상이하니 참고하여 연동 바랍니다.

제휴간편결제 서비스 제공 정보

서비스명	신용카드 제공 여부	포인트 제공 여부	머니 제공 여부
페이코	O	O	X
삼성월렛	O	O	O
SSG페이	O	X	O
카카오페이	O	O	O
네이버페이	O	O	O
L.pay	O	O	X
애플페이	O	X	X
토스페이	O	O	O

제휴 간편결제 서비스는 서비스별로 추가서비스 신청 및 계약이 필요합니다.
계약된 제휴 간편결제 서비스는 표준결제창에 노출되며, 간편결제창 단독호출은 파라미터로 제어합니다.
응답데이터는 서비스별 수단(카드/포인트/머니)에 따라 차이가 있으니 구분하여 처리가 필요합니다.
L.PAY(L.POINT)는 별도 서비스 연동이 필요합니다.
T0000 사이트코드로 카카오페이 머니, 네이버페이 포인트만 테스트가 가능합니다.
　 카카오페이 머니는 테스트 사이트코드이지만 실결제처리되니 반드시 취소해주셔야 합니다.

제휴간편결제 호출 파라미터

간편결제 단독 호출 파라미터

제휴간편결제창 호출 시 PC는 pay_method = "100000000000", Mobile의 경우 pay_method = "CARD" 로 진행해 주세요.

string1

payco_dircet

페이코 사용 여부
ex) "payco_direct" : "Y"

string1

sspay_direct

삼성월렛 사용 여부
ex) "sspay_direct" : "Y"

string1

ssgpay_direct

SSG페이 사용 여부
ex) "ssgpay_direct" : "Y"

string1

lpay_direct

LPAY 사용 여부
ex) "lpay_direct" : "Y"

string1

kakaopay_direct

카카오페이 사용 여부
ex) "kakaopay_direct" : "Y"

string1

naverpay_direct

네이버페이 사용 여부
ex) "naverpay_direct" : "B"

string1

applepay_direct

애플페이 사용 여부
ex) "applepay_direct" : "Y"

string1

tosspay_direct

토스페이 사용 여부
ex) "tosspay_direct" : "Y"

간편결제 결제응답 파라미터

제휴간편결제 신용카드 결제응답 파라미터

제휴 간편결제 신용카드 결제수단은 기존 신용카드 응답과 동일하며, KCP-API 연동하기 > 표준결제 서비스 참고 바랍니다.
응답 전문 중 제휴 간편결제 유형을 구분할 수 있는 card_other_pay_type 파라미터가 리턴됩니다.
페이코 포인트는 신용카드 응답전문으로 리턴되며 포인트 사용금액이 추가로 리턴됩니다. 아래 파라미터는 정상결제의 경우에만 응답됩니다.

string4

res_cd

결과코드
정상 처리된 경우 '0000'값 리턴
ex) "res_cd" : "0000"

string100

res_msg

결과 메세지
ex) "res_msg" : "정상처리"

string100

res_en_msg

영문 결과 메세지
ex) "res_en_msg" : "processing completed"

string4

card_other_pay_type

제휴간편결제 유형
거래건에서 사용된 간편결제 구분코드입니다.
OT12 - 페이코
OT01 – 삼성월렛
OT03 – SSG페이
OT11 – L.PAY
OT13 – 카카오페이
OT16 – 네이버페이
OT21 – 애플페이
OT23 – 토스페이
ex) "card_other_pay_type" : "OT12"

number9

payco_point_mny

페이코 포인트 사용 금액
페이코 포인트 결제시 사용된 페이코 포인트 금액입니다.
ex) "payco_point_mny" : "1004"

제휴간편결제 머니 결제응답 파라미터

머니결제 시 제휴간편결제사 별로 응답데이터 차이가 있으니 아래 내용을 확인하시어 DB 처리시 활용하시기 바랍니다.
아래 파라미터는 정상결제의 경우에만 응답됩니다. 토스포인트 단독결제는 불가하며, 토스머니인 경우에만 복합결제 가능합니다.
(토스포인트를 사용한 거래도 응답값은 제휴간편결제 머니 응답값(SCTO)으로 리턴됩니다.)

string4

res_cd

결과코드
정상 처리된 경우 '0000'값 리턴
ex) "res_cd" : "0000"

string100

res_msg

결과 메세지
ex) "res_msg" : "정상처리"

string100

res_en_msg

영문 결과 메세지
ex) "res_en_msg" : "processing completed"

number12

amount

총 결제금액
결제된 총 결제금액입니다.
ex) "amount" : "1004"

number9

easypoint_mny

머니 결제금액
총 결제금액 중 머니 금액을 리턴합니다.
ex) "easypoint_mny" : "1004"

string14

app_easypoint_time

머니 승인시간
머니 승인된 시간이 리턴됩니다.
ex) "app_easypoint_time" : "20251231000000"

string4

service_corp_id

제휴간편결제 기관 코드
결제된 제휴 간편결제사 기관 코드입니다.
카카오머니 - SCKA
토스머니 - SCTO
SSG머니 - SCSM
삼성월렛 =- SCSA
ex) "service_corp_id" : "SCKA"

string4

pay_method

제휴 간편결제 결제수단 코드
결제된 제휴 간편결제수단 코드입니다. 머니 제휴 간편결제사 구분시 활용하시기 바랍니다.
카카오머니 - PAKM
토스머니 - PATO
SSG 머니 - PASG
삼성월렛 - SCSA
ex) "pay_method" : "PAKM"

string1

app_cash_receipt_yn

현금영수증 발급여부
머니/포인트 결제 시 현금영수증 발급 여부를 리턴합니다.
Y - 현금영수증 발급
N - 현금영수증 미발급
ex) "app_cash_receipt_yn" : "Y"

string9

app_cash_receipt_mny

현금영수증 발급대상 금액
현금영수증 발급대상 금액을 리턴합니다.
ex) "app_cash_receipt_mny" : "1004"

제휴간편결제 포인트 결제응답 파라미터

포인트 결제 시 제휴 간편결제사 별로 응답데이터 차이가 있으니 아래 내용을 확인하시어 DB 처리 시 활용하시기 바랍니다.
아래 파라미터는 정상결제의 경우에만 응답됩니다.

string4

res_cd

결과코드
정상 처리된 경우 '0000'값 리턴
ex) "res_cd" : "0000"

string100

res_msg

결과 메세지
ex) "res_msg" : "정상처리"

string100

res_en_msg

영문 결과 메세지
ex) "res_en_msg" : "processing completed"

number12

amount

총 결제금액
결제된 총 결제금액입니다.
ex) "amount" : "1004"

number12

easypoint_mny

포인트 결제금액
총 결제금액 중 포인트 금액을 리턴합니다.
ex) "easypoint_mny" : "1004"

string14

app_easypoint_time

포인트 승인시간
포인트 승인된 시간이 리턴됩니다.
ex) "app_easypoint_time" : "20251231000000"

string14

service_corp_id

제휴 간편결제사 기관 코드
결제된 제휴 간편결제사 기관 코드입니다.
네이버페이포인트 - SCNA
ex) "service_corp_id" : "SCNA"

string4

pay_method

제휴 간편결제 결제수단 코드
결제된 제휴 간편결제수단 코드입니다. 포인트/머니 제휴 간편결제사 구분시 활용하시기 바랍니다.
네이버페이포인트 - PANP
ex) "pay_method" : "PANP"

string1

app_cash_receipt_yn

현금영수증 발급 여부
머니/포인트 결제 시 현금영수증 발급 여부를 리턴합니다.
Y - 현금영수증 발급
N - 현금영수증 미발급
S - 현금영수증 자진발급 (네이버페이 포인트만 해당)
ex) "app_cash_receipt_yn" : "Y"

string14

app_cash_receipt_no

현금영수증 거래번호
네이버페이 포인트 현금영수증 발급 시에만 리턴됩니다. (app_cash_receipt_yn Y,S인 경우에만 리턴)
ex) "app_cash_receipt_no" : "12345678912345"

number12

app_cash_receipt_mny

현금영수증 발급대상 금액
현금영수증 발급대상 금액을 리턴합니다.
ex) "app_cash_receipt_mny" : "1004"

제휴간편결제 머니/포인트 결제취소 응답 파라미터

머니/포인트 취소시 '현금영수증 취소 대상금액'을 리턴해드립니다.
현금영수증 발급/취소에 대해 직접 관리하는 가맹점의 경우 거래 건 취소 시 응답해드리는 현금영수증 취소 대상 금액(app_cash_receipt_mny)참고하여 현금영수증 취소 진행 바랍니다. 아래 파라미터는 결제 취소 성공시에만 응답됩니다.

string4

res_cd

결과코드
정상 처리된 경우 '0000'값 리턴
ex) "res_cd" : "0000"

string100

res_msg

결과 메세지
ex) "res_msg" : "정상처리"

string100

res_en_msg

영문 결과 메세지
ex) "res_en_msg" : "processing completed"

number12

app_cash_receipt_mny

현금영수증 취소대상 금액
현금영수증 취소대상 금액을 리턴합니다.
ex) "app_cash_receipt_mny" : "1004"

참고사항

PAYCO 포인트 - 충전포인트 사용 금액에 대해 다음 해 1월에 국세청으로 일괄 전송됩니다.

네이버페이 포인트 - NHN KCP에서 현금영수증 발급됩니다.
무상포인트(이벤트, 후기작성 등으로 인한 무상으로 지급된 포인트)는 현금영수증 금액에서 제외됩니다.
현금영수증을 직접 발급해야 한다면 app_cash_receipt_mny(현금영수증 발급 대상 금액)을 확인하여 현금영수증 발급/취소 처리합니다.
네이버페이 포인트 결제가 정상적으로 처리된 후, 충전 포인트 결제 금액에 한해 발급된 현금영수증을 결과처리 페이지에서 바로 확인할 수 있게 연동할 수 있습니다.
현금영수증 파라미터는 매출전표에서 현금영수증 URL을 참고해주세요.

SSG머니 - 현금영수증 발급 대상 금액(app_cash_receipt_mny)을 참고하여 가맹점에서 직접 현금영수증 발급/취소 처리바랍니다.

카카오머니 - 카카오페이에서 현금영수증 발급됩니다. (카카오톡 or 카카오페이 APP내 내역 확인 가능합니다.)
카카오페이 포인트(이벤트 등으로 인한 무상으로 지급된 포인트)는 현금영수증 금액에서 제외됩니다.
가맹점에서 현금영수증 직접 발급 시 당사로 반드시 사전 공유해 주셔야 하며(이중 발급 방지) app_cash_receipt_mny(현금영수증 발급 대상 금액)을 확인하여 현금영수증 발급/취소 처리합니다.

토스머니(토스포인트) - 토스페이에서 현금영수증 발급됩니다. (토스 APP 내 내역 확인 가능합니다.)
가맹점에서 현금영수증 직접 발급 시 반드시 당사로 사전 공유해 주셔야 하며(이중 발급 방지) app_cash_receipt_mny(현금영수증 발급 대상 금액)을 확인하여 현금영수증 발급/취소 처리합니다.
토스머니+토스포인트 복합결제로 진행한 경우, 토스포인트 사용금액은 현금영수증 발급대상 금액에서 제외됩니다.

삼성월렛 머니 - 충전포인트 사용 금액에 대해 다음 해 1월에 국세청으로 일괄 전송됩니다.