제휴간편결제

NHN KCP 제휴간편결제는 페이코, 삼성월렛, SSG페이, 카카오페이, 네이버페이, L.pay, 애플페이, 토스페이와 같은 간편결제 서비스를 표준결제창에서 사용할 수 있도록 제공하는 서비스입니다. 간편결제 서비스별로 신용카드, 포인트, 머니 제공 여부가 다르므로 연동 전 제공 범위를 확인하세요.

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

서비스명	신용카드 제공 여부	포인트 제공 여부	머니 제공 여부
페이코	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" 값을 사용합니다. 호출하려는 간편결제 서비스에 맞는 단독 호출 파라미터를 함께 전달하세요.

payco_direct string1

페이코 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "payco_direct" : "Y"

sspay_direct string1

삼성월렛 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "sspay_direct" : "Y"

ssgpay_direct string1

SSG페이 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "ssgpay_direct" : "Y"

lpay_direct string1

L.pay 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "lpay_direct" : "Y"

kakaopay_direct string1

카카오페이 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "kakaopay_direct" : "Y"

naverpay_direct string1

네이버페이 결제창을 단독으로 호출할 때 사용하는 값입니다. B는 네이버페이 단독 호출을 의미합니다.ex) "naverpay_direct" : "B"

applepay_direct string1

애플페이 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "applepay_direct" : "Y"

tosspay_direct string1

토스페이 결제창을 단독으로 호출할 때 사용하는 값입니다.ex) "tosspay_direct" : "Y"

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

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

제휴간편결제의 신용카드 결제 응답은 기존 신용카드 응답과 동일합니다. 표준결제 가이드를 참고하세요.
응답 전문에는 제휴간편결제 유형을 구분할 수 있는 card_other_pay_type 값이 함께 리턴됩니다.
페이코 포인트는 신용카드 응답 전문으로 리턴되며, 포인트 사용 금액이 추가로 리턴됩니다. 아래 파라미터는 정상 결제된 경우에만 응답됩니다.

res_cd string4

결과 코드입니다. 정상 처리되면 '0000'이 리턴됩니다.ex) "res_cd" : "0000"

res_msg string100

결과 메시지입니다.ex) "res_msg" : "정상처리"

res_en_msg string100

영문 결과 메시지입니다.ex) "res_en_msg" : "processing completed"

card_other_pay_type string4

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

payco_point_mny number12

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

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

머니 결제는 제휴간편결제사별로 응답 데이터가 다릅니다. 아래 내용을 확인하여 가맹점 DB 처리 시 활용하세요.
아래 파라미터는 정상 결제된 경우에만 응답됩니다. 토스포인트 단독 결제는 지원하지 않으며, 토스머니와 함께 사용하는 복합 결제만 가능합니다. 토스포인트를 사용한 거래도 응답값은 제휴간편결제 머니 응답값(SCTO)으로 리턴됩니다.

res_cd string4

결과 코드입니다. 정상 처리되면 '0000'이 리턴됩니다.ex) "res_cd" : "0000"

res_msg string100

결과 메시지입니다.ex) "res_msg" : "정상처리"

res_en_msg string100

영문 결과 메시지입니다.ex) "res_en_msg" : "processing completed"

amount number12

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

easypoint_mny number12

총 결제금액 중 머니로 결제된 금액입니다.ex) "easypoint_mny" : "1004"

app_easypoint_time string14

머니 승인이 완료된 시간입니다.ex) "app_easypoint_time" : "20251231000000"

service_corp_id string4

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

pay_method string4

거래에 사용된 제휴간편결제 결제수단 코드입니다. 머니 제휴간편결제사를 구분할 때 사용합니다.
카카오머니 – PAKM입니다.
토스머니 – PATO입니다.
SSG머니 – PASG입니다.
삼성월렛 – SCSA입니다.ex) "pay_method" : "PAKM"

app_cash_receipt_yn string1

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

app_cash_receipt_mny string9

현금영수증 발급 대상 금액입니다.ex) "app_cash_receipt_mny" : "1004"

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

포인트 결제는 제휴간편결제사별로 응답 데이터가 다릅니다. 아래 내용을 확인하여 가맹점 DB 처리 시 활용하세요.
아래 파라미터는 정상 결제된 경우에만 응답됩니다.

res_cd string4

결과 코드입니다. 정상 처리되면 '0000'이 리턴됩니다.ex) "res_cd" : "0000"

res_msg string100

결과 메시지입니다.ex) "res_msg" : "정상처리"

res_en_msg string100

영문 결과 메시지입니다.ex) "res_en_msg" : "processing completed"

amount number12

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

easypoint_mny number12

총 결제금액 중 포인트로 결제된 금액입니다.ex) "easypoint_mny" : "1004"

app_easypoint_time string14

포인트 승인이 완료된 시간입니다.ex) "app_easypoint_time" : "20251231000000"

service_corp_id string14

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

pay_method string4

거래에 사용된 제휴간편결제 결제수단 코드입니다. 포인트 또는 머니 제휴간편결제사를 구분할 때 사용합니다.
네이버페이포인트 – PANP입니다.ex) "pay_method" : "PANP"

app_cash_receipt_yn string1

app_cash_receipt_no string14

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

app_cash_receipt_mny number12

현금영수증 발급 대상 금액입니다.ex) "app_cash_receipt_mny" : "1004"

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

머니/포인트 결제를 취소하면 현금영수증 취소 대상 금액이 함께 리턴됩니다. 현금영수증 발급과 취소를 가맹점에서 직접 관리하는 경우,
취소 응답의 app_cash_receipt_mny 값을 확인하여 현금영수증 취소 처리하세요. 아래 파라미터는 결제 취소에 성공한 경우에만 응답됩니다.

res_cd string4

결과 코드입니다. 정상 처리되면 '0000'이 리턴됩니다.ex) "res_cd" : "0000"

res_msg string100

결과 메시지입니다.ex) "res_msg" : "정상처리"

res_en_msg string100

영문 결과 메시지입니다.ex) "res_en_msg" : "processing completed"

app_cash_receipt_mny number12

현금영수증 취소 대상 금액입니다.ex) "app_cash_receipt_mny" : "1004"