나이스 페이 API - naiseu pei API

- Wechat Pay 선거래 API

• 1) 아래의 요청 필드들을 HTML Form 필드에 설정 한 후 tenpayProcess.jsp 로 POST 로 Submit 합니다.

  목차 Show

  • - Wechat Pay 선거래 API
  • - 결제 결과(Back-end) 응답 전문
  • - 결제 취소

• 2) NICE 에서는 가맹점 정보를 검증한 후 가맹점 요청 데이터에 따라 WeChat Pay 결제 URL 정보를 생성 후 가맹점의 ReturnURL 로 Submit 합니다.

• 3) 응답 받은 가맹점은 응답 결과가 ‘0000’ 정상 인 경우 WXPayPayURL 필드 내의 URL 을 Submit 하거나 QRCode 로 표현 합니다.

요청URL：

• https://web.nicepay.co.kr/lite/tenpay/tenpayProcess.jsp

연동방식：

• <span style="color:red;">Form Submit</span>

파라미터：

사용방식：

• java

  try {
          Document doc = Jsoup.connect(url).data(params).post();
          String resCd = doc.select("input[name=ResultCode]").first().val();
          String resMsg = doc.select("input[name=ResultMsg]").first().val();
          if(!StringUtils.equals("0000" , resCd )){
              //error
          }
  
          String appId = doc.select("input[name=appId]").first().val();
          String timeStamp = doc.select("input[name=timeStamp]").first().val();
          String nonceStr = doc.select("input[name=nonceStr]").first().val();
          String packageStr = doc.select("input[name=packageStr]").first().val();
          String signType = doc.select("input[name=signType]").first().val();
          String paySign = doc.select("input[name=paySign]").first().val();
  
          Map<String, Object> info = new HashMap<>();
  
          info.put("appId" , appId);
          info.put("timeStamp" , timeStamp);
          info.put("nonceStr" , nonceStr);
          info.put("packageStr" , packageStr);
          info.put("signType" , signType);
          info.put("paySign" , paySign);
  
      } catch (Exception e) {
          //error
      }

• 미니 프로그램

wx.requestPayment({
                timeStamp: info.timeStamp,
                nonceStr: info.nonceStr,
                package: info.packageStr,
                signType: info.signType,
                paySign: info.paySign
                , success: function (res) {
                        //결제 성공
                }, fail: function (e) {
                        //결제 실패
                }
            }

요청 응답 설명

- 결제 결과(Back-end) 응답 전문

• 지불 성공 시만 결제 인증 URL 요청 시 설정한 RetryURL 로 응답됩니다. </br>(응답 실패 시 1-2분 주기로 재 전송. 최대 10번 재 전송.)

• 응답 시 DB 처리를 포함 가맹점 주문 프로세서 가 모두 완료 된 경우 “OK” (대문자) 문자열을 리턴 하는 경우 처리가 완료 된 것으로 인지하여</br>더 이상 URL 을 호출 하지 않습니다.

• 예) ASP/ PHP/JSP 경우 Response.write(“OK”);

• 그 외 실패 인 경우 OK 제외한 문자열을 리턴 합니다.

파라미터：

- 결제 취소

• 결제 취소의 경우 API 형태로 요청 ASP/PHP/JSP 등의 HTTP CLIENT 등을 이용한 서버 간 통신 방식 입니다.

• 취소 요청 시 POST 방식으로 요청 하고 응답으로 NAME=VALUE 형태의 TEXT를 리턴 합니다.

• 이때 연결자로 파이프(“|”) 사용합니다.

• 예) 취소 응답결과 </br>TID=nictest20m20011603071513133542| MID=nictest20m|CancelDate=20160312| CancelTime=165712

요청URL：

• https://web.nicepay.co.kr/lite/cancelProcess.jsp

연동방식：

• Server TO Sever (API)

파라미터：

요청 응답 설명

응답 parse

String str = "TID=nictest20m20011603071513133542| MID=nictest20m|CancelDate=20160312| CancelTime=165712";

String[] split = StringUtils.split( str.toString().trim() , "|");

        StringBuilder sb = new StringBuilder();

        sb.append("{");

        int len = 0;

        for(String item : split ){

            String[] s = StringUtils.split( item , "=" );

            if(len > 0){
                sb.append(",");
            }

            if(s.length <= 1){

                sb.append( String.format( "\"%s\":\"%s\"" , s[0] , "" ) );

            }else{

                if(StringUtils.equals("null" , s[1] )){

                    sb.append( String.format( "\"%s\":\"%s\"" , s[0] , "" ) );

                }else{

                    sb.append( String.format( "\"%s\":\"%s\"" , s[0] , s[1] ) );

                }
            }

            len += 1;
        }

        sb.append("}");

        JSONObject json = JSONObject.fromObject(sb.toString());