원인

• API 호출시 SignData 필드 값으로 생성된 값에 문제가 있는경우 발생하는 오류입니다.

해결

• SignData 필드 값 생성 규칙을 확인하고, 암호화 규칙을 확인합니다.

원인

• MID(가맹점ID) 생성 후 지불수단에 대한 사용 등록이 되지 않았을 때 발생합니다.

해결

• 운영 부서를 통해 가맹점 ID의 기본정보 변경 과정이 필요 합니다.

원인

• 가맹점 분담 무이자를 설정하지 않은 상태로 ShopInterest, QuotaInterest 파라미터를 잘못 세팅한 경우 발생하는 오류입니다.

해결

• 영업담당자를 통해 가맹점 분담 무이자 설정이 가능한 MID인지 확인이 필요합니다.
• 가맹점관리자페이지에 설정한 가맹점 분담 무이자 정보를 확인한 후 ShopInterest 파라미터를 1로,
  QuotaInterest 파라미터를 설정한 카드사, 할부개월 수에 맞게 세팅합니다.

원인

• 결제 요청한 MID에 카드사 정보가 정상적으로 등록되지 않은 경우 발생합니다.

해결

• 운영 부서를 통해 가맹점 ID의 카드사 정보 등록 과정이 필요합니다.

원인

• 부분취소가 불가능한 결제수단에서 부분취소 요청 시 발생하는 오류입니다.

해결

• 고객께서 결제하신 카드가 선불카드, 포인트카드, 클린카드 등 부분취소가 불가능한 카드일 수 있습니다.
• 기타 부분취소가 불가능한 결제수단일 수 있으며 이는 고객께서 직접 결제한 수단의 발급사로 문의하여 부분취소가 가능한지 확인하여야 합니다.

원인

• 요청 값 중 공급가액, 부가세, 봉사료, 면세금액 필드 값이 없거나 누락 된 경우 발생 할 수 있습니다.

해결

• 요청 페이지에 지정금액 필드 값을 알맞게 설정하세요

파라미터

<!-- EX) 상품가격이 1,004 원인 경우 -->
<!-- Amt = SupplyAmt + GoodsVat + ServiceAmt + TaxFreeAmt -->

<!-- 필드명:Amt / 사이즈:12 / 설명:결제 총액 -->
<input type="hidden" name="Amt" value="1004">

<!-- 필드명:SupplyAmt / 사이즈:12 / 설명:공급가 액 -->
<input type="hidden" name="SupplyAmt" value="900">

<!-- 필드명:GoodsVat / 사이즈:12 / 설명:부가가 치세 -->
<input type="hidden" name="GoodsVat" value="104">

<!-- 필드명:ServiceAmt / 사이즈:12 / 설명:봉사료 -->
<input type="hidden" name="ServiceAmt" value="0">

<!-- 필드명:TaxFreeAmt / 사이즈:12 / 설명:면세 금액 -->
<input type="hidden" name="TaxFreeAmt" value="0">

원인

• TID 길이가 규칙에 맞지 않은 경우 발생 할 수 있습니다.

해결

• TID 길이(Byte)가 규칙에 맞는지 확인 합니다.

파라미터

TID = 가맹점ID(MID) + 지불수단(2byte) + 매체구분(2byte) + 시간정보(yyMMddHHmmss) + 랜덤(4byte)

ex)
MID     = nicepay00m
지불수단 = 01            // CARD–01 (신용카드), BANK–02(계좌이체), VBANK–03(가상계좌), CELLPHONE–05(휴대폰결제)
매체구분 = 01            // 고정
시간정보 = 170511000000  //yyMMddHHmmss
랜덤     = 0123

TID = nicepay00m01011705110000000123

원인

• 이미 취소된 거래를 다시 취소하는 경우 발생하는 오류입니다.

해결

• 환불 요청 시 계좌번호와 예금주명을 다시 한 번 확인하세요.
• 정확한 확인 필요 시 영업담당자를 통해 예금주 성명조회 API 서비스를 협의하세요.
• 예금주명 데이터의 인코딩 깨짐 여부를 확인하세요.
• utf-8 인코딩 설정하여 환불 요청 시 예금주명 한글 데이터가 깨져 비정상적인 데이터가 송신됩니다.

원인

• 나이스의 취소 프로세스는 취소 요청 시 해당 MID의 정산 예정 금액에서 취소 요청된 금액을 차감하는 프로세스입니다.
• 해당 오류는 취소 요청된 금액이 정산 예정인 금액보다 큰 경우 발생합니다.

해결

• 요청 MID의 정산 내역 확인하여 취소 가능 금액이 충분한지 확인이 필요합니다.
• 자세한 내용은 정산팀 혹은 영업담당자를 통해 정산 내역을 확인하시기 바랍니다.
• 정산팀 : 1661-7335 -> 2

원인

• 가상계좌 발급 후 해당 가상계좌에 입금이 완료된 거래에 대하여 환불계좌정보 없이 취소를 진행하는 경우 발생합니다.
• 환불계좌정보는 아래 세가지 파라미터를 참고 바랍니다.

해결

• 입금이 완료된 가상계좌 거래건은 취소 요청 시 RefundAcctNm, RefundAcctNo, RefundBankCd 파라미터를 필수로 입력합니다.

원인

• 모바일 결제창을 PC브라우저로 접근하는 경우 혹은 반대로 PC 결제창을 모바일 브라우저로 접근하는 경우 발생합니다.

해결

• 문제 기기 요청 헤더를 확인하세요.
• 모바일 결제창을 PC로 접근하지 않는지 혹은 반대의 경우 인지 확인하세요.
• 타 기기를 통해 다시 Test 하여 재현 여부를 파악합니다.

원인

• 환불 요청 시 계좌번호(RefundAcctNo), 예금주명(RefundAcctNm)이 은행에 등록된 계좌-예금주명과 다른 경우 발생합니다.
• 은행에 등록된 계좌번호의 예금주가 맞는지 확인하세요.

해결

• 환불 요청 시 계좌번호와 예금주명을 다시 한번 확인하세요.
• 정확한 확인 필요 시 영업담당자를 통해 예금주 성명조회 API 서비스를 협의하세요.
• 예금주명 데이터의 인코딩 깨짐 여부를 확인하세요.
• utf-8 인코딩 설정하여 환불 요청 시 예금주명 한글 데이터가 깨져 비정상적인 데이터가 송신됩니다.

원인

• 가맹점 ID에 설정된 기본 정보와 결제 요청 방법이 상이 한 경우

해결

• 사용 하려는 서비스에 대한 기본 정보 설정을 운영팀을 통해 확인 하세요.

원인

• [현대카드] M포인트 를 사용할 수 없는 카드

해결

• 카드사로 문의 하세요.

원인

• 일반 결제시 PG하위몰 사업자번호 오류

해결

• 가맹점 서브몰 등록 여부를 확인 하세요.
• 하위몰이 사용 중지 가맹점이 아닌지 확인 하세요.

원인

• 결제 요청 중 장애가 원인 일 수 있습니다.

해결

• 기술 지원 팀 으로 개별 문의 해주세요.
• 문의 요청시 TID를 확인 해 주세요.

원인

• 할부가 불가능한 카드를 이용하여 할부 결제를 요청 한 경우 발생 할 수 있습니다.

해결

• 카드사로 문의 해 주세요.

원인

• [현대카드]M포인트 결제시 거절에 의해 발생 할 수 있습니다.

해결

• 법인카드는 M포인트 결제가 불가 합니다.
• 상세한 사유는 카드사로 문의 하세요.

원인

• 잔액이 부족한 경우 발생 할 수 있습니다.

해결

• 상세한 사유는 카드사로 문의 하세요.

원인

• 고객이 결제중 하나의 인증창으로 여러건의 인증을 진행 했을때 발생 할 수 있습니다.

해결

• 고객의 모든 브라우저 종료 후 재결제 진행이 필요 합니다.

원인

• MID 생성 후 카드사 서브몰 심사가 마무리되지 않아 발생하는 오류 입니다.
• 카드사 심사가 끝나면 자연스럽게 해결되는 오류입니다.

해결

• 카드사 심사가 마무리 된 후 결제 요청이 가능 합니다.
• 심사 일정은 영업 팀을 통해 확인 하세요.

원인

• MID에 설정된 가맹점의 하위몰 (서브몰) 심사가 끝나지 않은 경우 발생 할 수 있습니다.
• 카드사 심사가 끝나면 자연스럽게 해결되는 오류입니다.

해결

• 카드사 심사가 마무리 된 후 결제 요청을 진행 하세요.

원인

• http로 카드사 앱 접근 시 발생 할 수 있습니다.
• ios 쿠키 차단 시 발생 할 수 있습니다.

해결

• 가맹점 홈페이지에서 ssl 통신이 가능 한지 확인 하세요.
• ReturnUrl을 https로 변경 하세요.

<!-- 필드명:ReturnURL / 사이즈:500 / 설명:인증 완료 결과 처리 URL-->
<input type="hidden" name="ReturnURL" value="https://가맹점 URL">

원인

• 가맹점에서 결제시 MID값을 설정하지 않았거나 10자리 이하로 입력한 경우 발생 할 수 있습니다.

해결

• MID 필드 값이 누락되지 않았는지 확인 하세요.
• MID가 10자리가 맞는지 확인 하세요.
• MID 끝에 "m" 자가 누락되지 않았는지 확인 하세요.

<!-- 필드명:MID / 사이즈:10 / 설명:가맹점 MID-->
<input type="hidden" name="MID" value="nicepay00m"> //test MID : nicepay00m

원인

• MID(가맹점ID)에 적용된 결제수단에 해당되지 않는 payMethod 값이 전달 되었을 경우 발생 할 수 있습니다.
• payMethod 값이 누락 혹은 불일치 하는 경우 발생 할 수 있습니다.
• 가맹점 개시전 인 경우 발생 할 수 있습니다.

해결

• 운영부서를 통해서 가맹점 결제 가능 여부와 사용 가능한 결제수단을 확인해야 합니다.
• PayMethod 값이 누락되었거나 일치하지 않는지 확인합니다.

<!-------결제 수단------->
<!-- CARD: 신용카드 -->
<!-- BANK: 계좌이체 -->
<!-- VBANK: 가상계좌  -->
<!-- CELLPHONE: 휴대폰결제  -->

<!-- 필드명:PayMethod / 사이즈:10 / 설명:결제 수단-->
<input type="hidden" name="PayMethod" value="CARD"> //ex) CARD: 신용카드

원인

• 페이지 호출 후 요청 값(결제요청일시(EdiDate), 결제금액(Amt), 가맹점ID(MID), 가맹점키)이 변경 되는 경우 위변조 오류가 발생합니다.

해결

• 금액, 가맹점 ID 등이 변경되는 경우 해쉬 함수를 재호출 해야 합니다.

상세 설명

• SignData 값은 yyyyMMddHHmmss + merchantID + price + merchantKey 를 합친 String을 SHA-256 암호화 + Hex 형태로 해싱한 값 입니다.
• nicepayStart() 함수 실행시 goPay() 함수에 form 값을 담아 결제창 스크립트 혹은 결제창을 호출하며 이때 SignData plainText 일부가 변경 되었다면 W007 오류가 발생합니다.
• hash 함수가 포함된 페이지를 호출 후 값이 변경되거나 혹은 ajax 처리 등으로 SignData plainText값이 변경 되는 경우 SignData 생성 함수 재 호출과정이 필요 합니다.

DataEncrypt sha256Enc = new DataEncrypt();
String ediDate = getyyyyMMddHHmmss();	
String encryptData = sha256Enc.encrypt(ediDate + merchantID + price + merchantKey);

<input type="hidden" name="SignData" value="<%=encryptData%>"/>	

$ediDate = date("YmdHis");
$encryptData = bin2hex(hash('sha256', $ediDate.$MID.$price.$merchantKey, true));

<input type="hidden" name="SignData" value="<?php echo($encryptData)?>"/>	

encryptData = stringToSHA256(ediDate + merchantID + price + merchantKey);
public String stringToSHA256(String plain){
    SHA256Managed SHA256 = new SHA256Managed();
    String getHashString = BitConverter.ToString(SHA256.ComputeHash(Encoding.UTF8.GetBytes(plain))).ToLower();
    return getHashString.Replace("-", "");
}

<input type="hidden" name="SignData" value="<%=encryptData%>"/>	

const format = require('date-format')
const CryptoJS = require("crypto-js")

var ediDate = format.asString('yyyyMMddhhmmss', new Date())
var signData = getEncryptData(ediDate + merchantID + amt + merchantKey)

function getEncryptData(str) {
    var encrypted = CryptoJS.SHA256(str);
    return encrypted;
}

from datetime import datetime
import hashlib

def getEdiDate():
    YYYYmmddHHMMSS = datetime.today().strftime("%Y%m%d%H%M%S")
    return str(YYYYmmddHHMMSS)

def getEncrypt(str):
    encoded_str = str.encode()
    EncryptData = hashlib.sha256(encoded_str).hexdigest()
    return EncryptData
    
EdiDate = getEdiDate()
plainText = EdiDate + MID + Amt + MerchantKey
SignData = getEncrypt(plainText)