Skip to content

Latest commit

 

History

History
89 lines (72 loc) · 3.47 KB

kicc.md

File metadata and controls

89 lines (72 loc) · 3.47 KB
Raw

KICC 일반결제 연동 가이드

🌐 EN

본 문서는 KICC 관련 내용만 기술하므로 README 파일에서 다음 일반결제 연동 정보를 확인하세요.

1. PG 설정하기

KICC 일반결제 테스트 모드 설정 페이지의 내용를 참고하여 PG 설정을 합니다.

2. 결제 요청하기

IMP.request_pay(param, callback)을 호출하여 KICC 결제창을 호출합니다.

PC의 경우 IMP.request_pay(param, callback) 호출 후 callback으로 실행되고, 모바일의 경우 m_redirect_url로 리디렉션됩니다.

  • pg : 등록된 PG사가 하나일 경우에는 미 설정시 기본 PG사가 자동으로 적용되며, 여러개인 경우에는 kicc로 지정합니다.
  • buyer_tel: 필수 입력 (미설정 시 KICC 결제창에서 오류 발생 가능)
IMP.request_pay({
    pg : 'kicc',
    pay_method : 'card',
    merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
    name : '주문명:결제테스트',
    amount : 14000,
    buyer_email : '[email protected]',
    buyer_name : '구매자이름',
    buyer_tel : '010-1234-5678',
    buyer_addr : '서울특별시 강남구 삼성동',
    buyer_postcode : '123-456',
    m_redirect_url : '{모바일에서 결제 완료 후 리디렉션 될 URL}' // 예: https://www.my-service.com/payments/complete/mobile
}, function(rsp) { // callback 로직
	//* ...중략 (README 파일에서 상세 샘플코드를 확인하세요)... *//
});

Escrow 결제

KICC는 현금성 결제수단(실시간계좌이체, 가상계좌)에 한하여 에스크로 결제수단을 지원합니다.

에스크로 결제 시 다음 필수 파라미터를 입력해야 합니다.

  • buyer_name : 구매자 이름
  • buyer_email : 구매자 이메일
  • buyer_tel : 구매자 전화번호
  • kiccProducts : 상품별 부분배송을 위한 상품 관련 정보 (4개의 필수 속성으로 구성된 객체배열). 해당 amount 값은 결제 금액(param.amount) 값과 관계가 없으며 비교검증되지 않습니다.
    • orderNumber : 상품주문번호
    • name : 상품명
    • quantity : 수량
    • amount : 상품 가격
IMP.request_pay({
    pg : 'kicc',
    escrow : true, //에스크로 결제인 경우 필요
    pay_method : 'vbank', //trans(실시간계좌이체), vbank(가상계좌)
    merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
    name : '주문명:결제테스트',
    amount : 14000,
    buyer_email : '[email protected]',
    buyer_name : '구매자이름',
    buyer_tel : '010-1234-5678',
    buyer_addr : '서울특별시 강남구 삼성동',
    buyer_postcode : '123-456',
    kiccProducts : [
    	{
			"orderNumber" : "xxxx",
			"name" : "상품A",
			"quantity" : 3,
			"amount" : 1000
		},
		{
			"orderNumber" : "yyyy",
			"name" : "상품B",
			"quantity" : 2,
			"amount" : 3000
		}
	],
    m_redirect_url : '{모바일에서 결제 완료 후 리디렉션 될 URL}' // 예: https://www.my-service.com/payments/complete/mobile
}, function(rsp) { // callback 로직
	//* ...중략 (README 파일에서 상세 샘플코드를 확인하세요)... *//
});