ezPay 전자 인보이스는 대만 NewebPay 그룹에서 제공하는 전자 인보이스 부가 가치 서비스 플랫폼입니다(대만에 "사업장"이 있고 "스토어 통화"가 대만 달러(TWD)인 스토어에 적용됩니다).
Kanorio에서 ezPay 전자 인보이스 연동은 결제 게이트웨이와 독립적으로 작동합니다. 고객이 PAYUNi, SHOPLINE Payments, LINE Pay, JKO Pay 중 어떤 방식으로 결제하든, 결제나 환불이 성공하면 시스템이 자동으로 ezPay 인터페이스를 호출하여 인보이스 발행, 취소 또는 매출 반환(Allowance)을 완료합니다.
많은 가맹점이 ezPay를 연동할 때 "인증 정보 연결 테스트는 통과하지만 첫 번째 인보이스 발행에 실패하는" 문제를 겪습니다. Kanorio에 키를 입력하기 전에 ezPay 전자 인보이스 플랫폼에서 다음 3단계를 완료했는지 확인하십시오.
연결 테스트는 통과하는데 왜 발행에 실패하나요(오류 코드
INV90005)? ezPay의 "조회 API(연결 테스트용)"는 계약 상태를 확인하지 않지만, "발행 API"는 요금제 신청 여부를 엄격하게 검증합니다. 이 단계를 완료하지 않으면 실제 발행 시 시스템이INV90005(계약이 유효하지 않거나 만료됨)오류를 반환합니다.
HashKey / 16자 HashIV 복사하기cinv.ezpay.com.tw와 운영 환경 inv.ezpay.com.tw는 독립적인 두 시스템입니다. 키는 상호 호환되지 않으므로 반드시 운영 환경 inv.ezpay.com.tw의 키를 사용하십시오).
MerchantIDHashKey(AES-256용 32자 영문/숫자)HashIV(16자 영문/숫자)MerchantID, 32자 HashKey, 16자 HashIV를 입력합니다.우측 상단의 "인보이스 관리" 버튼을 클릭하고 ezPay 전자 인보이스를 "활성화됨" 섹션으로 드래그한 후 저장합니다. 즉시 공개 체크아웃 페이지에 적용됩니다.
PrintFlag=Y인 법인 인보이스 발행 시 구매자 주소를 요구합니다).Status=1 즉시 확인 모드를 사용하므로 구매자의 수동 확인이 필요하지 않습니다. 참조).| 일반적인 문제 | ezPay 오류 코드 및 사유 | 해결 방법 |
|---|---|---|
| 자격 증명 저장 시 "Invalid Key" 오류 발생 | KEY10002: HashKey(32자여야 함) 또는 HashIV(16자여야 함)가 올바르지 않거나, NewebPay "결제" 키 또는 테스트용 cinv 키를 잘못 입력했을 수 있습니다. | ezPay 전자 세금계산서 공식 대시보드(inv.ezpay.com.tw)에 로그인한 후 "매장 관리 > 상세 정보"에서 키를 다시 복사하십시오. |
| 연결 테스트는 통과했으나 세금계산서 발행 실패 | INV90005(요금제 미적용/계약 미활성화), KEY10006(API 연동 미활성화), 또는 INV90006(세금계산서 할당량/일련번호 부족). | ezPay 대시보드에 로그인하여 "요금제 신청"을 완료하고, 현재 일련번호와 세금계산서 할당량이 충분한지 확인한 후 Kanorio 고객 지원팀에 문의하여 재전송을 요청하십시오. |
| 동일한 세금계산서에 대해 24시간 이내 작업 제한 초과 | LIB10014: ezPay 측의 빈도 보호 제한. | 시스템이 백그라운드에서 단계적으로 자동 재시도를 수행하므로 별도의 수동 작업은 필요하지 않습니다. |
ezPay 전자 인보이스는 AES-256-CBC 암호화 표준을 사용하므로 HashKey는 32자, HashIV는 16자로 고정되어 있습니다. 시스템에서 길이 불일치 오류가 발생하면 누락된 문자가 있는지, 또는 다른 서비스의 키를 잘못 사용하지 않았는지 확인하십시오.
네. 인보이스가 성공적으로 발행되면 ezPay 전자 인보이스 플랫폼이 체크아웃 시 고객이 입력한 이메일 주소로 알림 이메일을 자동으로 발송합니다.