토스페이 연동가이드
준비하기

페이스페이

페이스페이를 위해 사전에 확인이 필요한 사항은 다음과 같아요.

1. 토스페이 연동 여부

토스페이를 연동한 뒤에 페이스페이를 사용할 수 있어요.

2. 페이스페이 연동 Agent(POS/KIOSK) 확인

POS

  • 프론트뷰와 연동해요. 페이스페이용 추가 개발이 가능한지 확인해야 해요.
  • Windows, 안드로이드 환경 모두 가능해요.

키오스크

  • 프론트캠(전면 카메라)과 연동해요.
  • Windows 환경 여부와 DLL 연동 개발 가능 여부를 확인해야 해요.
  • 안드로이드 기반 키오스크의 경우, 별도의 AAR 파일을 통해 미러링이 지원돼요.
  • 프론트캠 호출은 소켓 전문을 통한 연동이 필요해요.

결제 전용 단말기가 없다면, 토스플레이스의 프론트 디바이스를 통해 모든 결제를 처리할 수 있어요.

3. 네트워크 환경 확인

인터넷망, 전용선, VPN, 폐쇄망 등

  • 사업장 내부 Agent가 폐쇄망 환경이라면, 토스 단말기에서 토스 서버로의 외부 통신이 가능하도록 네트워크 whitelist 설정이 필요해요.
    • 키 다운로드, 단말기 App/OS 업데이트, 로그 전송 등 모두 인터넷 연결이 필요해요.
  • 외부망 통신이 불가능한 경우에는 토스에서 제공하는 LTE 모듈을 사용해 외부와 통신할 수 있어요.
    • 단, LTE 통신에는 별도의 요금이 발생할 수 있어요.

4. 개발환경(dev) 테스트

얼굴 인증만으로는 결제가 이뤄지지 않아요.

개발 환경에서는 실제 결제 흐름과 다르게 동작할 수 있기 때문에, 실제 운영 환경에서 테스트하는 것을 권장해요.