토스페이 연동

연동 개요

• 토스페이 오프라인 결제서버와 VAN 서버간의 연동 구성이에요.
• 결제를 위한 실시간 전문 통신(TCP/IP) 방식과 정산을 위한 파일송수신(SFTP) 방식으로 구성돼있어요.
• 오프라인 토스페이 연동은 VAN 서버와 토스페이 서버간 전용선통신으로 이루어져요.
• 사용자 ↔ POS ↔ VAN 구간은 토스페이와 무관한 별도의 연동절차가 필요해요.

머니/계좌 거래

• 토스페이 결제수단 중, 머니/계좌 거래는 위와 같은 프로세스로 결제가 처리돼요.
• POS/단말기는 VAN으로 일반 거래처럼 승인요청을 전송하지만, 실제 머니/계좌수단의 승인을 내는 주체는 토스페이예요.

카드 거래

• 토스페이 결제수단 중, 카드 거래는 위와 같은 프로세스로 결제가 처리돼요.
• 페이스페이/QR/바코드 모두 "② 조회 요청" 단계 전까지는 토스페이 토큰만 가지고 있다가, 토스페이 내부 처리를 통해서 OTC(One Time Cardnumber)를 받아요.
  • 이 OTC가 실물 IC카드번호를 대신할 일회성 카드번호예요.
• VAN사는 이제 OTC를 가지고 일반 IC거래처럼 카드사에 승인요청을 보내고 응답을 받아요.
• 카드사로부터 정상 응답을 받으면 그대로 POS/단말기까지 결과를 전송해주고 결제가 완료돼요.

실시간 전문 통신 방식

• 실시간 전문 통신 방식은 토스페이와 VAN사간 TCP/IP 프로토콜을 사용하여 실시간으로 메세지를 주고 받는 방식이에요.
• 전용선만 사용 가능하지만, VPN 구성이 필요하신 경우 상호 협의 하에 변경이 가능해요.
• '조회', '승인', '통지' 전문으로 이루어져 있어요.

인프라 정보

• 오프라인 결제 연동의 경우 전용회선으로 구성하고 있어요.
• VPN 환경도 제공해드릴 수 있지만, 가급적 지양하고 있어요.
• 회선은 총 3개로 구성되고, 결제 트래픽 정도에 따라 대역폭 협의 후 구성하고 있어요.
• IP 정보의 경우 다음과 같고, PORT 정보의 경우 연동 별 신규로 할당 및 안내해 드려요.
  • 개발환경: 211.233.9.160
  • 운영환경: 211.233.6.161
• VAN사 Inbound
  • SFTP 통신방식의 경우 토스가 VAN사로 접속하여 파일을 전달드리는 형식이에요.
  • VAN사 Inbound 방화벽 설정이 필요해요.
    • 개발: 15.165.30.215 (포트는 VAN사별 상이)
    • 운영 DC1: 117.52.3.80 ~ 87
    • 운영 DC2: 211.115.96.80 ~ 87

SFTP 통신 방식

• SFTP 통신 방식은 정산 등 배치성 대용량 파일을 주고 받는 용도로 사용돼요.
• 일정 시간 단위로 협의된 디렉토리 경로에 생성되는 파일을 SFTP 서버에 접속해서 가져가는 방식이에요.
• '정산내역', '가맹점 등록내역'으로 구성되어있어요.

데이터 포맷

• 송수신데이터는 ASCII 코드를 사용하며, 한글은 KSC-5601 2Bytes 완성형 코드를 사용해요.
• KSC-5601 코드 범위: 0xA1A1 ~ 0xFEFE
• 전문 및 일괄 전송 파일의 각 항목 별 표현(MODE)에 한글 수록 가능으로 표시된 경우('H'가 포함된 경우) 한글 이외에 문자도 모두 전각 처리(2Bytes Encoding)해요.
• 상호 협의 하에 UTF-8 등의 다른 Charset도 사용 가능해요.