개발자센터
상태정보는 단말기가 머신기로부터 주기적으로 수집하는 머신기의 현재 상태 데이터를 의미해요. 머신기의 운영 상태를 전산에서 참고하기 위한 정보예요.
상태정보는 결제나 매출을 판단하는 기준이 아니라, 운영을 보조하기 위한 참고 정보예요.
상태정보는 단말기와 머신기 간 통신을 통해 수집돼요.
단말기는 머신기의 상태를 직접 판단하지 않고, 머신기가 전달한 응답값을 그대로 전달해요.
상태정보에는 머신기의 운영 상태를 나타내는 값들이 포함돼요.
머신기 종류 및 제조사에 따라 제공되는 상태값의 범위와 표현 방식은 달라질 수 있어요.
상태정보를 수집할 때, 단말기가 인터넷 통신에 사용하는 매체 정보도 함께 전달돼요. 이는 통신 장애 분석 및 현장 대응을 위한 참고 정보예요.
인터넷 통신 매체는 크게 다음 두 가지로 구분돼요.
모뎀(Modem) 이동통신망을 사용하는 경우로, 상태정보에는 다음과 같은 정보가 함께 포함될 수 있어요.
이더넷(Ethernet)
유선 네트워크를 사용하는 경우로, 전산에는 ETH 값으로 구분되어 전달돼요.
이 경우 별도의 모뎀 정보는 포함되지 않아요.
이 정보는 통신 경로를 식별하기 위한 참고 데이터이며, 결제 처리 자체를 판단하는 기준은 아니에요.
상태정보는 머신기의 실제 상태를 100% 정확하게 보장하지는 않아요. 반드시 참고용 정보로만 활용해야 해요.
다음과 같은 경우에는 상태정보가 실제와 다르게 표시될 수 있어요.
이러한 경우, 전산에 표시되는 상태정보와 실제 머신기 상태가 일치하지 않을 수 있어요.
단말기는 수집한 상태정보를 **일정 주기(일반적으로 약 1시간)**마다 유비씨엔 서버로 전송해요.
이 전송은 실시간 처리가 아닌 주기적 전송 방식으로 이루어져요.
단말기가 상태정보를 유비씨엔 서버로 전송하는 동안에는 일시적으로 단말기 동작이 중단돼요.
이 시간 동안에는 결제 처리가 이루어지지 않으며, 상태정보 전송이 완료된 이후 정상적인 결제 동작이 재개돼요.
상태정보는 승인, 구매, 매입, 정산과 같은 결제 흐름에는 포함되지 않아요. 상태정보가 정상으로 표시되더라도 결제가 반드시 성공하는 것은 아니며, 반대로 상태정보에 이상이 표시되더라도 실제 결제에는 문제가 없을 수 있어요.
즉, 상태정보는 결제 가능 여부를 판단하는 기준이 아니에요.
전산에서는 상태정보를 머신기 운영 상태를 파악하기 위한 보조 수단으로 활용해요.
품절 관리, 장애 감지, 현장 점검 우선순위 판단 등에 참고 자료로 사용되며, 단독 판단 기준으로 사용해서는 안 돼요.
ETH로 구분