본문으로 건너뛰기

SMS API에서 문자 발송 시 -114 오류가 발생하나요?

💡 요약 정리

  • -114는 등록한 발신번호와 API 발송에 사용한 발신번호가 일치하지 않을 때 발생합니다.
  • 등록/인증된 발신번호인지, 그리고 정확히 같은 번호로 발송했는지 확인하세요. (예: 1588-3284 vs 02-1588-3284)
  • 발신번호 관리에서 상태가 [완료]인지, 차단된 발신번호가 아닌지도 함께 확인하세요.
  • API 소스에서 발신번호 고정값, 송수신 번호 뒤바꿈, 발신번호 뒤 공백 여부를 점검하세요.
  • 오류 문구가 깨져 보이면 페이지의 문자 인코딩(UTF-8/EUC-KR)을 맞추세요.

1. -114 오류의 의미

-114는 등록(인증)된 발신번호와 실제 API로 보내는 발신번호가 일치하지 않아 발생합니다.
즉, 등록한 번호와 발송에 사용한 번호가 다르면 거절됩니다.

2. 해결 방법 체크리스트

2.1 등록/인증된 발신번호로 발송했는지 확인

  • 등록/인증된 발신번호가 있는지, 그리고 그 번호로 발송을 시도했는지 확인하세요.
  • 예: 1588-3284를 발신번호로 등록했는데, API에서 02-1588-3284로 발송하면 일치하지 않아 오류가 발생합니다.

2.2 발신번호 인증/차단 상태 확인

  • 나의 서비스 관리 > 호스팅관리 > 기본관리 > 발신번호 관리에서 상태 값이 [완료]여야 합니다.
  • 인증 전 발신번호이거나 차단된 발신번호인 경우 발송이 제한됩니다. 상태를 먼저 정상으로 변경한 뒤 다시 시도하세요.

2.3 API 발송 소스 점검

  • 발신번호가 소스 내에 고정값으로 설정되어 있지 않은지 확인하세요. (개발자에게 문의 필요)
  • 나의 서비스 관리 > SMS 관리 > 소스예제를 참고하여 소스를 수정·사용해 주세요.
  • 발신번호는 반드시 등록/인증된 번호를 그대로 사용해야 합니다.

2.4 송·수신 번호 위치/공백 오류 확인

  • 간혹 발신번호로 보내야 하는데 수신번호로 보내는 등 송·수신 번호가 뒤바뀌는 경우가 있습니다. (개발자에게 확인 요청)
  • 발신번호 뒤에 공백이 들어가도 불일치로 판단될 수 있으니 공백을 제거하세요.
  • 주의: 잘못된 번호 위치나 공백은 발송 실패의 주요 원인입니다.

3. -114 오류 문구가 깨져 보일 때

  • SMS는 UTF-8과 EUC-KR을 지원합니다. 호출하는 페이지가 다른 캐릭터셋을 사용하면 오류 문구가 깨질 수 있습니다.
  • 정상적인 안내 문구는 다음과 같습니다.
    • "미인증 발신번호 사용! 발신번호를 등록하신 후 사용하세요"
  • 호출 페이지의 문자 인코딩을 점검하고, 사용 중인 문자셋과 일치하도록 설정하세요.