유효하지 않은 MSISDN은 차감되지 않아야 합니다

유효하지 않은 MSISDN은 차감되지 않아야 합니다.

인그레스 검증 대 다운스트림 실패

대량의 SMS 또는 OTP 트래픽을 라우팅할 때, 인그레스(진입) 지점에서의 유효하지 않은 수신처 주소와 다운스트림 배송 실패를 구분하는 것은 재무적 무결성을 유지하는 데 매우 중요합니다. 유효하지 않은 MSISDN은 원장 거래가 발생하기 전에 API 게이트웨이에서 즉시 거부되어야 합니다. 유효하지 않은 번호가 인그레스 검증을 우회하면 알 수 없는 상태의 다운스트림 DLR이 생성되어, 실제 배송은 되지 않으면서 비용만 청구되는 것처럼 보일 수 있습니다. IOSOR은 이를 방지하기 위해 엄격한 검증 규칙을 적용하여 잘못된 수신처 형식으로부터 귀하의 잔액을 보호합니다.

E.164 파싱 엔진

모바일 번호를 대상으로 하는 모든 API 요청은 글로벌 E.164 표준에 따라 실시간으로 파싱됩니다. 플랫폼은 국가 코드, 국내 목적지 코드 및 가입자 번호 길이를 확인합니다. 형식이 유효하지 않은 경우 게이트웨이는 즉시 HTTP 400 Bad Request를 반환합니다. 이러한 실시간(JIT) 검증은 리소스가 할당되거나 선불 홀드가 적용되기 전에 존재하지 않는 라우팅 경로를 차단합니다. 이 메커니즘은 유효하지 않은 번호가 숨겨진 비용을 초래하는 다운스트림 통신사 조회를 트리거하는 것을 방지합니다.

원장 규칙 및 선불 홀드

건전한 잔액을 유지하기 위해 IOSOR은 실시간 원장을 사용합니다. 유효한 SMS 요청이 수락되면 귀하의 잔액에 임시 선불 홀드가 적용됩니다. 메시지가 성공적으로 라우팅되면 홀드가 실제 차감으로 전환됩니다. 그러나 번호가 인그레스 지점에서 유효하지 않은 것으로 판명되면 홀드가 생성되지 않으며 잔액은 전혀 차감되지 않습니다. 이를 통해 잘못된 형식의 수신처 문자열로 인해 귀하의 USD 20 선불 하한선이 잠식되는 것을 방지합니다. 계정 규모가 확장되는 경우, 월 USD 1,000 부근에서 진행되는 소프트 리뷰를 통해 라우팅 테이블을 최적화하고 전용 리소스에 대한 MRC 한도를 조정할 수 있습니다.

웹훅 페이로드 및 에러 코드

메시지가 인그레스 지점에서 거부되면 API 응답에 특정 에러 페이로드가 포함됩니다. 비동기 DLR 웹훅을 기다리는 대신 애플리케이션은 즉각적인 동기식 에러를 수신합니다. 이 페이로드에는 유효하지 않은 매개변수와 명확한 거부 코드가 포함됩니다. 유효한 번호의 경우 시스템은 라우팅 경로를 할당하고 STOP 및 Verify OK 이벤트를 포함한 상태 업데이트를 웹훅을 통해 전송하여 API 주기를 낭비하지 않고 메시징 파이프라인에 대한 완전한 투명성을 보장합니다.

개발자 리소스 및 연동

불필요한 지출을 방지하는 견고한 연동을 구축하려면 개발자는 API를 호출하기 전에 클라이언트 측 검증을 구현해야 합니다. 구현을 최적화하기 위해 다음 필수 가이드를 검토하십시오:

• API 인그레스 지점에서 E.164 전화번호 형식 검증
• 월렛 파일럿 주간: 라이브 트래픽에서의 홀드 및 차감 진실
• SMS API 구매 체크리스트

IOSOR로 시작하기

샌드박스에서 국가번호 없는 목적지와 불가능한 길이의 목적지를 POST 한다. HTTP 400 과 변하지 않은 ledger 를 기대한다. hold 도 debit 도 없다. 그다음 유효한 E.164 를 보내고 hold 는 accept 뒤에만 나타나는지 확인한다. 잘못된 쌍에서 돈이 움직였다면 입구 파싱이 깨진 것이다.

IOSOR 핵심 요약

입구의 형식 거부는 배달 실패가 아니다. 잘못된 MSISDN 은 hold 를 열면 안 된다. 할 일: 돈이 움직이기 전에 E.164 를 파싱한다. 하지 말 일: 없어야 할 차감을 unknown DLR 이 설명하길 기다린다. 번호가 갖춰지기 전까지 ledger 는 조용하다.