원인

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

해결

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

원인

• 입력하신 실명번호(주민/사업자번호)와 예금주 실명번호가 일치하지 않습니다.

해결

• 예금주 실명번호 확인 후 다시 결제를 시도해 주시기 바랍니다.
• 관련문의 : 거래 금융기관

원인

• 뱅크페이(금결원)에서 결제모듈 재설치 알람 입니다.
• 결제를 위해 뱅크페이 재설치가 필요 할 수 있습니다.

해결

• 스마트폰 이용고객 : 앱 업데이트가 필요 합니다.
• PC이용고객 : 전자지갑 삭제 후 재설치가 필요 합니다.
• 탈옥 또는 루팅한 스마트폰은 서비스를 이용 하실 수 없습니다.
• 관련문의 : 금융결제원 고객센터 (1577-5500)

원인

• 계좌이체 오류 => 금결원 응답코드 [960]
• 응답메시지:전문형식 오류로 결제 불가

해결

• 요청 전문 값을 확인 하세요.
• 인코딩을 확인 하세요.
• 특수문자 포함여부를 확인 하세요.

원인

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

해결

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

원인

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

해결

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

원인

• TrKey 필드가 누락 되는 경우 발생

해결

• TrKey 처리 로직을 검토하고 필드가 누락되지 않았는지 확인 합니다.

파라미터

<!-- value 는 공백으로 처리 -->
<input type="hidden" name="TrKey" value=""/>

원인

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

해결

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

파라미터

<!-- 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

원인

• 현금영수증 의무발행 대상 사업자가 아닌 경우 발생 할 수 있습니다.

해결

• 운영 부서를 통해 현금영수증 의무발행 대상 여부를 확인 하세요.

원인

• 요청값 중 식별값 오류시 발생 할수 있습니다

해결

• 요청값 중 식별값이 포함되어 있는지 확인 합니다.
• 식별값 정상 여부를 확인 합니다.

<!-- 필드명:ReceiptTypeNo / 사이즈:20 / 설명:현금영수증 발급번호-->
<input type="hidden" name="ReceiptTypeNo" value=""> // 사업자번호, 휴대폰 번호 입력

<!-- 필드명:ReceiptSubNum / 사이즈:10 / 설명:서브몰 사업자 번호 -->
<input type="hidden" name="ReceiptSubNum" value="">

원인

• 요청 기기 헤더정보에 대한 예외 처리를 확인 하세요.
• 모바일 결제창을 PC브라우저로 접근하는 경우 혹은 반대인지 확인 하세요.

해결

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

원인

• 사업자번호가 위장/휴폐업 상태인 경우 발생 할 수 있습니다.

해결

• 가맹점 거래 가능 여부를 운영부서를 통해 확인 하세요.

원인

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

해결

• 가맹점 에서는 이미 정상취소된것으로 반영될 수 있도록 수정개발하거나 기존 거래를 취소 된 것으로 업데이트 해야합니다.

원인

• 가맹점 관리자 페이지에 서브ID 등록이 안된 상태에서 현금영수증 수동 발행요청을 하는 경우 발생 할수 있습니다.

해결

• 서브몰 현금영수증 발급시 먼서 서브ID를 가맹점 관리자 페이지 에서 등록 하세요.

원인

• ReceiptType 값이 잘못 처리된 경우

해결

• ReceiptType 값을 1(소득 공제) 또는 2(지출증빙)로 설정 하세요.

<!-- 필드명:ReceiptType / 사이즈:1 / 설명:1: 소득 공제,  2: 지출증빙-->
<input type="hidden" name="ReceiptType" value=""> // 사업자번호, 휴대폰 번호 입력

원인

• ReceiptTypeNo 필드 값이 누락된 경우 발생 할 수 있습니다.

해결

• ReceiptTypeNo 처리 로직을 점검 하세요.

<!-- 필드명:ReceiptTypeNo / 사이즈:20 / 설명:현금영수증 발급번호-->
<input type="hidden" name="ReceiptTypeNo" value=""> // 사업자번호, 휴대폰 번호 입력

원인

• 사업자번호, 상호명, 대표자명, 전화번호 정보 중 한 개라도 누락된 경우 발생

해결

• 요청 전문 확인하여 값이 누락된 파라미터가 없는지 확인

<!-- 필드명:ReceiptSubNum / 사이즈:10 / 설명:현금영수증 서브몰 사업자번호-->
<input type="hidden" name="ReceiptSubNum" value=""> // 사업자번호, 휴대폰 번호 입력

<!-- 필드명:ReceiptSubCoNm / 사이즈:40 / 설명:현금영수증 서브몰 상호-->
<input type="hidden" name="ReceiptSubCoNm" value=""> // 사업자번호, 휴대폰 번호 입력

<!-- 필드명:ReceiptSubBossNm / 사이즈:20 / 설명:현금영수증 서브몰 대표자명-->
<input type="hidden" name="ReceiptSubBossNm" value=""> // 사업자번호, 휴대폰 번호 입력

<!-- 필드명:ReceiptSubTel / 사이즈:16 / 설명:현금영수증 서브몰 전화번호-->
<input type="hidden" name="ReceiptSubTel" value=""> // 사업자번호, 휴대폰 번호 입력

원인

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

해결

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

원인

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

해결

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

원인

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

해결

• 카드사로 문의 하세요.

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

원인

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

해결

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

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

원인

• CardNo 필드 값이 누락 되는 경우 발생 할 수 있습니다.
• 카드 유효성 검증 오류시 발생 할 수 있습니다.
• 잘못된 카드 번호를 입력 하는 경우 발생 할 수 있습니다.

해결

• CardNo 필드에 입력한 카드번호가 누락되지 않고 전달 되는지 확인 하세요.
• 사용 가능한 카드인지 확인 하세요.

<!-- 필드명:CardNo / 사이즈:20 / 설명:카드 번호-->
<input type="hidden" name="CardNo" value="">

원인

• 카드번호오류, 사용불가 가맹점 등 오류 일 수 있습니다.

해결

• 오류 거래 건 TID를 확인 하여 기술지원 팀으로 문의 하세요.

원인

• 가맹점에서 결제시 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: 휴대폰결제  -->
<!-- SSG_BANK: SSG 은행계좌  -->
<!-- GIFT_SSG: SSG머니 (모바일 Only)  -->

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

원인

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

해결

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

상세 설명

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

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

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

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

<input type="hidden" name="EncryptData" 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="EncryptData" value="<%=encryptData%>"/>	

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

var ediDate = format.asString('yyyyMMddhhmmss', new Date())
var encryptData = 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
EncryptData = getEncrypt(plainText)