IOSOR 가이드
대기 중 vs 전송됨: IOSOR의 단일 메시지 경로
IOSOR에서 프로덕트 및 재무 팀이 SMS 및 OTP 라이프사이클 단계를 위한 단일 상태 머신을 공유하고 사전 홀드와 DLR 상태를 조화시키는 방법을 알아봅니다.
대기 중 vs 전송됨: IOSOR의 단일 메시지 경로。
대기 중과 전송됨을 위한 단일 상태 머신
API 요청이 E.164 목적지로 SMS 또는 OTP 페이로드를 전송하기 위해 플랫폼에 도달하면, 프로덕트 및 재무 팀은 정확히 동일한 라이프사이클 상태를 참조해야 합니다. 기존의 화이트 라벨 환경에서는 프로덕트 팀이 '대기 중'(queued)을 단순한 엔지니어링 상태로 처리하는 동안 재무 팀은 월말 정산서를 기다렸습니다. IOSOR는 단일 확정적 상태 머신을 운영하여 이러한 단절을 제거합니다. HTTP 요청이 검증되면 메시지는 즉시 queued 상태로 진입합니다. 이 상태는 거래 장부에 명시적 항목을 생성하고 라우트 요금을 고정하며 고객의 선불 월렛에 승인 홀드를 적용합니다.
대기 시 자금 보관 및 최종 정산
queued 상태에 들어가면 엔진은 즉시 잔액 점검을 수행합니다. 플랫폼의 재무 건전성을 유지하기 위해 계정은 발신 트래픽이 파이프라인에 진입하기 전에 USD 20 선불 최소 잔액을 유지해야 합니다. 대기 상태일 때 발신 SMS 세그먼트의 예상 비용이 홀드 처리됩니다. 메시지가 queued에서 sent로 전환되면 이 홀드가 최종 차금으로 전환됩니다. 메시지 검증에 실패하면 홀드가 즉시 해제됩니다. 월간 트래픽이 USD 1,000/월 검토 시점에 가까워짐에 따라 원장 동시 처리 기능이 높은 트래픽 처리 중에도 잔액 이탈을 방지합니다.
상태 전환 트리거: API 수신에서 핸드오프까지
queued와 sent 사이의 경계는 엄격합니다. Queued는 페이로드가 검증되고 요금이 계산되었으며 자금이 예약된 상태로 발송 큐에 할당되었음을 의미합니다. Sent는 에지 게이트웨이가 PDU를 네트워크 인터페이스로 전송하고 중간 응답을 수신했음을 나타냅니다. 이 찰나의 순간에 시스템은 상태를 queued에서 sent로 업데이트하고 비동기 웹훅 이벤트를 전송합니다. 번호는 JIT 할당을 사용하여 프로비저닝되므로 추측성 예약 없이 E.164 라우팅 및 월 정기 비용 회계가 이루어집니다.
장부 감사와 전송 보고서의 조화
DLR 지연이 발생하면 재무 감사와 엔지니어링 로그 사이에 마찰이 생길 수 있습니다. IOSOR에서 sent 상태는 최종 차금 확정의 회계 기준점입니다. DELIVERED 또는 UNDELIVERED와 같은 DLR 상태는 운영 지표만 업데이트하며 초기 거래 장부를 변경하지 않습니다. 수신 STOP 명령이 수신되면 해당 E.164 주소에 대한 후속 요청은 재무 홀드가 발생하기 전에 API 경계에서 Verify OK 상태로 거부됩니다.
운영 플레이북 및 관련 아키텍처
엔지니어링과 재무 운영 간의 정렬을 유지하려면 큐 처리, 웹훅 멱등성 및 월렛 메커니즘에 대한 다음 핵심 참조 가이드를 참조하세요:
IOSOR로 시작하기
IOSOR 콘솔을 열고 라이프사이클 상태 머신 설정으로 이동하여 아웃바운드 훅을 단일 대기열-전송 파이프라인에 맞추십시오. 하위 통신사의 배달 확인을 기다리는 대신, 전송 상태를 최종 출금 확정의 공식 시점으로 인식하도록 원장 연동을 구성하십시오. 테스트 발송을 실행하고 엔지니어링 웹훅과 재무 로그 전반에서 통합 거래 상태 ID를 감토하여 설정을 검증하십시오.
IOSOR 핵심 요약
본 가이드는 제품 텔레메트리와 과금을 단일 상태 머신 중심으로 통합하면 엔지니어링 부서와 재무 부서 간의 운영 마찰이 사라진다는 것을 입증했습니다. 대기열 진입 시 자금을 예치하고 게이트웨이가 전송 이벤트를 발생시킬 때 최종 출금을 확정하면, 지연되거나 누락된 배달 확인의 영향을 받지 않는 결정론적 회계 모델이 만들어집니다.
회계 정산 트리거는 전송 전환에만 매핑하고 배달 확인은 운영 품질 측정 지표로만 활용하십시오. 원장 조정이나 출금 확정을 비동기식 배달 확인에 연동하면 회계 오차와 감사 대조 갈등이 유발되므로 삼가십시오.
이 가이드가 도움이 되었나요?
관련 가이드
- 대기 열의 메시지는 즉시 차감되지 않고 자금을 임시 보류해야 합니다
IOSOR가 원장에서 메시지 대기 열 상태를 관리하는 방법을 알아보세요. 대기 중인 SMS 요청은 라우팅 확인 전까지 임시 승인 보류를 생성합니다.
- 메시지 수명 주기 상태 대 낮은 전달률 대응 플레이북
요청 제출부터 대기열, 전송, DLR 수신까지의 SMS 상태 머신과 원장 보류, Webhook 연동 규칙을 완벽히 이해합니다.