PAYCO Developer

1-2. 버튼 이미지 삽입을 위한 자바스크립트

					
<script>
	Payco.Button.register({
		SELLER_KEY :   ‘111’,		// 가맹점 코드
		ORDER_METHOD : "CHECKOUT",	// 주문유형 : CHECKOUT / EASYPAY
		BUTTON_TYPE : "A1",		// 버튼타입 선택 (A1,A2)
		BUTTON_HANDLER : order,		// 구매하기 버튼이벤트 Handler 함수등록
		BUTTON_HANDLER_ARG : ['param1', 'param2'],// handler 함수 argument
		DISPLAY_PROMOTION : "Y",		// 이벤트 문구 출력 여부
		DISPLAY_ELEMENT_ID : "payco_type1",	// 노출될 element id
		"" : ""
	});
</script>
					
					

주문 상품 상태 변경 API > INPUT

					
{
	"orderNo": "201608312002168187",
	"sellerKey": "S0FSJE",
	"sellerOrderProductReferenceKey": "ITEM_100001",
	"orderProductStatus": "DELIVERY_READY"
}
					
					

주문 상품 상태 변경 API > OUTPUT

					
{
	"code": 0,
	"message": "success"
}
					
					

주문 결제 취소 가능여부 조회 API > INPUT

					
{
     "sellerKey" : "S0FSJE", 
     "orderNo" : "201503302000162863", 
     "cancelTotalAmt" : 40000, 
     "cancelTotalFeeAmt" : 0, 
     "orderProducts" : [ 
         { 
             "sellerOrderProductReferenceKey" : "1171997", 
             "cpId" : "PARTNERTEST", 
             "productId" : "PROD_EASY", 
             "productAmt" : 40000 
         } 
     ] 
} 
					
					

주문 결제 취소 가능여부 조회 API > OUTPUT

					
{ 
     "result": { 
         "cancelPossibleYn": "N", 
         "partCancelPossibleYn": "N", 
         "pgCancelPossibleAmt": 500, 
         "cancelImpossibleReason": "PAYCO 포인트 잔액 부족으로 주문을 취소할 수 없습니다. PAYCO 고객센터 : 1544-6891",
         "cancelImpossibleReasonCode": 1303 
     }, 
     "message":"success", 
     "code": 0 
}
					
					

마일리지 적립 취소 > INPUT

					
{
     "sellerKey" : "S0FSJE", 
     "sellerOrderReferenceKey" : "TESTORDERKEY00000003", 
     "cancelPaymentAmount" : "1" 
 }
					
					

마일리지 적립 취소 > OUTPUT

					
{ 
     "result":{ 
         "canceledMileageAcmAmount":1.0, 
         "remainingMileageAcmAmount":23988.0 
     }, 
     "message":"success", 
     "code":0 
 }
					
					

가맹점 별 코드 값 사용가능 여부 > INPUT

					
{ 
     "sellerKey" : "S0FSJE", 
     "codes" : [ 
         { 
             "codeKind" : "CP_ID", 
             "codeValue" : "2" 
         }, 
         {
             "codeKind" : "CP_ID", 
             "codeValue" : "PARTNERTEST" 
         }, 
         { 
             "codeKind" : "PRODUCT_ID", 
             "codeValue" : "PROD_EASY", 
             "upperCodeValue" : "PARTNERTEST" 
         }, 
         { 
             "codeKind" : "MILEAGE_ACCUMULATION_POLICY_SEQ", 
             "codeValue" : 2000000003 
         } 
     ] 
 }
					
					

가맹점 별 코드 값 사용가능 여부 > OUTPUT

					
{ 
     "result": [ 
         { 
             "codeKind": "CP_ID", 
             "codeValue": "2", 
             "usabilityYn": "N", 
             "useImpossibleReason": "The cpId is invalid." 
         }, 
         { 
             "codeKind": "CP_ID", 
             "codeValue": "PARTNERTEST", 
             "usabilityYn": "Y" 
         }, 
         { 
             "codeKind":"PRODUCT_ID", 
             "codeValue": "PROD_EASY", 
             "usabilityYn": "Y" 
         }, 
         { 
             "codeKind":"MILEAGE_ACCUMULATION_POLICY_SEQ", 
             "codeValue": 2000000003,
             "usabilityYn": "Y" 
         } 
     ], 
     "message":"success", 
     "code": 0 
 }
					
					

NonBankbookDepositInformUrl 로 전달되는 정보

					
{ 
    "reserveOrderNo":"201408211000000720", 
    "orderNo":"201408211000000721", 
    "sellerOrderReferenceKey":"201408212212505952", 
    "orderChannel":"PC", 
    "totalOrderAmt":116500.0, 
    "totalDeliveryFeeAmt":2500.0, 
    "totalRemoteAreaDeliveryFeeAmt":0.0, 
    "totalPaymentAmt" : 119000.0, 
    "paymentCompletionYn" : "N", 
    "memberName" : "홍*동", 
    "memberEmail" : "ho*@nhnent.com", 
    "deliveryPlace":{ 
         "recipient":"이진희", 
         "address1":"경기도 성남시 분당구 삼평구", 
         "address2":"629", 
         "zipcode":"123123", 
         "telephone":"02-0111-2222", 
         "deliveryMemo" : "경비실에 맡겨주세요" 
     }, 
    "paymentDetails": [{ 
         "paymentTradeNo" : "20140821100000022", 
         "paymentMethodName":"무통장입금", 
         "paymentMethodCode":"02", 
         "paymentAmt":109000.0, 
         "tradeYmdt":"20140821221250", 
         "pgAdmissionNo":"12980185", 
         "pgAdmissionYmdt":"20140821221255", 
         "easyPaymentYn":"N", 
         "nonBankbookSettleInfo":{ 
             "accountHolderName":"(주)지누스포츠 (팝슈즈)", 
             "bankName":"국민", 
             "accountNo":"465101-01-217098", 
             "expirationYmd":"20140901" 
             } 
     },{ 
         "paymentTradeNo" : "20140821100000022", 
         "paymentMethodName":"PAYCO포인트", 
         "paymentMethodCode":"98", 
         "paymentAmt":10000.0, 
         "tradeYmdt":"20140821221250", 
         "pgAdmissionNo":"20140821100000023", 
         "pgAdmissionYmdt":"20140821221255", 
         "easyPaymentYn":"N" 
    }], 
    "orderProducts" : [{ 
         "productId" : "PS_TOASTCOMC1", 
         "cpId" : "PS_TOASTCO", 
         "orderProductNo" : "20140821100000022", 
         "sellerOrderProductReferenceKey" : "1", 
         "orderProductStatusCode" : "PAYED", 
         "orderProductStatusName" : "결제완료" 
         }, 
         { 
         "productId" : "PS_TOASTCOMC2", 
         "cpId" : "PS_TOASTCO", 
         "orderProductNo" : "20140821100000023", 
         "sellerOrderProductReferenceKey" : "2", 
         "orderProductStatusCode" : "PAYED", 
         "orderProductStatusName" : "결제완료" 
    }] 
}
					
					

결제수단 및 코드조회 API > INPUT

					
{
     "sellerKey" : "S0FSJE", 
     "cpId" : "PARTNERTEST"
 }
					
					

결제수단 및 코드조회 API > OUTPUT

					
{ 
 "result":{ 
     "usePaymentMethodList":[ 
		{"paymentMethodCode": "98", "paymentMethodName": "PAYCO포인트"}, 
		{"paymentMethodCode": "75", "paymentMethodName": "페이코 (자유이용쿠폰)"}, 
		{"paymentMethodCode": "33", "paymentMethodName": "신용카드(터치)"}, 
		{"paymentMethodCode": "02", "paymentMethodName": "무통장입금 ", 
		sableBankList":[
    		{"bankCode": "03", "bankName": "기업은행"}, 
		{"bankCode": "04", "bankName": "국민은행"}, 
          	{"bankCode": "05", "bankName": "외환은행"}, 
          	{"bankCode": "11", "bankName": "농협"}, 
          	{"bankCode": "20", "bankName": "우리은행"}, 
          	{"bankCode": "23", "bankName": "SC제일은행"}, 
          	{"bankCode": "27", "bankName": "시티은행"}, 
          	{"bankCode": "31", "bankName": "대구은행"}, 
          	{"bankCode": "32", "bankName": "부산은행"}, 
          	{"bankCode": "34", "bankName": "광주은행"}, 
          	{"bankCode": "39", "bankName": "경남은행"}, 
          	{"bankCode": "71", "bankName": "우체국"}, 
          	{"bankCode": "88", "bankName": "신한은행"} 
		]}, 
         {"paymentMethodCode": "04", "paymentMethodName": "계좌이체"}, 
         {"paymentMethodCode": "31", "paymentMethodName": "신용카드 ", 
             sableCardList":[ 
                 {"cardCompanyCode": "CCBC", "cardCompanyName": "BC카드"}, 
                 {"cardCompanyCode": "CCDI", "cardCompanyName": "현대카드"}, 
                 {"cardCompanyCode": "CCHN", "cardCompanyName": "하나카드"}, 
                 {"cardCompanyCode": "CCKE", "cardCompanyName": "하나(외환)카드"},                      
                 {"cardCompanyCode": "CCKM", "cardCompanyName": "KB국민카드"}, 
                 {"cardCompanyCode": "CCLG", "cardCompanyName": "신한카드"}, 
                 {"cardCompanyCode": "CCLO", "cardCompanyName": "롯데카드"}, 
                 {"cardCompanyCode": "CCNH", "cardCompanyName": "NH농협카드"}, 
                 {"cardCompanyCode": "CCSS", "cardCompanyName": "삼성카드"} 
         ]}, 
         {"paymentMethodCode": "60", "paymentMethodName": "휴대폰 "} 
     ], 
     "wholeCardList":[ 
         {"cardCompanyCode": "CCBC", "cardCompanyName": "BC카드"}, 
         {"cardCompanyCode": "CCKM", "cardCompanyName": "KB국민카드"}, 
         {"cardCompanyCode": "CCNH", "cardCompanyName": "NH농협카드"}, 
         {"cardCompanyCode": "CCKJ", "cardCompanyName": "광주카드"}, 
         {"cardCompanyCode": "CCAM", "cardCompanyName": "롯데아멕스카드"}, 
         {"cardCompanyCode": "CCLO", "cardCompanyName": "롯데카드"}, 
         {"cardCompanyCode": "CCKD", "cardCompanyName": "산업카드"}, 
         {"cardCompanyCode": "CCSS", "cardCompanyName": "삼성카드"}, 
         {"cardCompanyCode": "CCSU", "cardCompanyName": "수협카드"}, 
         {"cardCompanyCode": "CCSG", "cardCompanyName": "신세계한미"}, 
         {"cardCompanyCode": "CCLG", "cardCompanyName": "신한카드"}, 
         {"cardCompanyCode": "CCSH", "cardCompanyName": "신한카드"}, 
         {"cardCompanyCode": "CCCU", "cardCompanyName": "신협카드"}, 
         {"cardCompanyCode": "CCCT", "cardCompanyName": "씨티카드"}, 
         {"cardCompanyCode": "CCKE", "cardCompanyName": "외환카드"}, 
         {"cardCompanyCode": "CCPH", "cardCompanyName": "우리카드"}, 
         {"cardCompanyCode": "CCUF", "cardCompanyName": "은련카드"}, 
         {"cardCompanyCode": "CCSB", "cardCompanyName": "저축카드"}, 
         {"cardCompanyCode": "CCJB", "cardCompanyName": "전북카드"}, 
         {"cardCompanyCode": "CCCJ", "cardCompanyName": "제주카드"}, 
         {"cardCompanyCode": "CCHN", "cardCompanyName": "하나SK카드"}, 
         {"cardCompanyCode": "CCHM", "cardCompanyName": "한미카드"}, 
         {"cardCompanyCode": "CJCF", "cardCompanyName": "해외JCB"}, 
         {"cardCompanyCode": "CMCF", "cardCompanyName": "해외마스터"}, 
         {"cardCompanyCode": "CVSF", "cardCompanyName": "해외비자"}, 
         {"cardCompanyCode": "CCDI", "cardCompanyName": "현대카드"} 
     ], 
     "wholeBankList":[ 
         {"bankCode": "02", "bankName": "산업은행"}, 
         {"bankCode": "03", "bankName": "기업은행"}, 
         {"bankCode": "04", "bankName": "국민은행"}, 
         {"bankCode": "05", "bankName": "외환은행"}, 
         {"bankCode": "07", "bankName": "수협"}, 
         {"bankCode": "11", "bankName": "농협"}, 
         {"bankCode": "20", "bankName": "우리은행"}, 
         {"bankCode": "209", "bankName": "동양종합금융증권"}, 
         {"bankCode": "218", "bankName": "현대증권"}, 
         {"bankCode": "23", "bankName": "SC제일은행"}, 
         {"bankCode": "230", "bankName": "미래에셋증권"}, 
         {"bankCode": "238", "bankName": "대우증권"}, 
         {"bankCode": "240", "bankName": "삼성증권"}, 
         {"bankCode": "243", "bankName": "한국투자증권"}, 
         {"bankCode": "247", "bankName": "우리투자증권"}, 
         {"bankCode": "26", "bankName": "신한은행"}, 
         {"bankCode": "261", "bankName": "교보증권"}, 
         {"bankCode": "262", "bankName": "하이투자증권"}, 
         {"bankCode": "263", "bankName": "HMC투자증권"}, 
         {"bankCode": "264", "bankName": "키움증권"}, 
         {"bankCode": "265", "bankName": "이트레이드증권"}, 
         {"bankCode": "266", "bankName": "SK증권"}, 
         {"bankCode": "267", "bankName": "대신증권"}, 
         {"bankCode": "268", "bankName": "솔로몬투자증권"}, 
         {"bankCode": "269", "bankName": "한화증권"}, 
         {"bankCode": "27", "bankName": "씨티은행"}, 
         {"bankCode": "270", "bankName": "하나대투증권"}, 
         {"bankCode": "278", "bankName": "신한금융투자"}, 
         {"bankCode": "279", "bankName": "동부증권"}, 
         {"bankCode": "280", "bankName": "유진투자증권"}, 
         {"bankCode": "287", "bankName": "메리츠종합금융증권"}, 
         {"bankCode": "289", "bankName": "NH투자증권"}, 
         {"bankCode": "290", "bankName": "부국증권"}, 
         {"bankCode": "291", "bankName": "신영증권"}, 
         {"bankCode": "292", "bankName": "LIG투자증권"}, 
         {"bankCode": "31", "bankName": "대구은행"}, 
         {"bankCode": "32", "bankName": "부산은행"}, 
         {"bankCode": "34", "bankName": "광주은행"}, 
         {"bankCode": "35", "bankName": "제주은행"}, 
         {"bankCode": "37", "bankName": "전북은행"}, 
         {"bankCode": "39", "bankName": "경남은행"}, 
         {"bankCode": "45", "bankName": "새마을금고"}, 
         {"bankCode": "48", "bankName": "신용협동조합"}, 
         {"bankCode": "50", "bankName": "상호신용금고"}, 
         {"bankCode": "54", "bankName": "HSBC은행"}, 
         {"bankCode": "55", "bankName": "도이치은행"}, 
         {"bankCode": "71", "bankName": "우체국"}, 
         {"bankCode": "81", "bankName": "하나은행"}, 
         {"bankCode": "88", "bankName": "신한은행"} 
     ], 
     "interestFreeUrl": "http://www.payco.com", 
     "introduceContents": "" 
 }, 
 "message": "success", 
 "code": 0 
 } 
					
					

inApp 적용가이드 > IOS > Sample

					
- (BOOL)application:(UIApplication *)application 
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 
 {
     NSHTTPCookieStorage *cookieStorage=
     [NSHTTPCookieStorage sharedHTTPCookieStorage]; 
     [cookieStorage setCookieAcceptPolicy:

     NSHTTPCookieAcceptPolicyAlways]; 
     .....
     return YES;
 }
					
					

Android > 쿠키 및 자바스크립트 처리를 위한 웹뷰 설정 > Sample

					
getSettings().setAppCacheEnabled(true);
getSettings().setDomStorageEnabled(true);
getSettings().setJavaScriptEnabled(true);
getSettings().setJavaScriptCanOpenWindowsAutomatically(true); 
  
// Android LOLIPOP 이상에서만 작동하도록함
if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) 
{  
	// https -> http 호출 허용.
	webView.getSettings().setMixedContentMode
	(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);
  
	// 서드파티 쿠키 허용.
	CookieManager cookieManager = CookieManager.getInstance();
	cookieManager.setAcceptCookie(true);
	cookieManager.setAcceptThirdPartyCookies(webView, true);
}

setWebChromeClient(new WebChromeClient());
					
					

Android > Android >가맹점 앱에서 Payco 앱이 실행될 수 있도록 intent처리 > Sample

					
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {

	ClientType type = ClientType.getClientType(url);
	if (type.equals(ClientType.BLANK) || type.equals(ClientType.JAVASCRIPT)) {
			 return true;
	}
	
	if (type.equals(ClientType.WEB)) {
			 return false;
	}
	
	// ARS 인증을 위한 전화 연결
	if (url.startsWith("tel:")) {
			 startCallPhoneIntent(url);
			 return true;
	}
	
	// 앱 실행
	return handleAppUrl(url);
}
					
					

Iframe 적용가이드 > sample

					
<iframe src="…" ……… height="600px" onload="scroll(0,0);"/>
   <script type="text/javascript"> 
   function paycoScroll(evt) { 
     if (evt.data == "payco_message") {
       scroll(0,0);
     }
     if (window.addEventListener) {
       window.addEventListener("message", paycoScroll, false);
     } else {
       window.attachEvent("onmessage", paycoScroll);
     }
   }