POPBill Developers
가이드

통신

모든 팝빌 API는 REST API로 제공되며, HTTP 요청을 보낼 수 있는 환경이라면 OS, DB 제한없이 이용 가능합니다. SSL(Secure Sockets Layer)이 적용된 HTTPS 프로토콜로만 호출이 가능하며, API 요청에 대해 JSON 형태로 응답결과를 제공합니다. 팝빌 API 요청을 처리하는 과정에서 오류가 발생하는 경우, HTTP Status 코드와 함께 오류코드와 메시지로 구성된 응답을 반환합니다.

1. 통신 정책

HTTPS 통신 / TLS 1.2, 1.1 지원

2. 망 구성

  • 인터넷망(공중망) – Elastic IP
  • 인터넷망(공중망) – Static IP
  • 전용선

3. 서버 정보

Elastic IP (Default)

AWS Cloud의 ALB 서비스를 이용하여 탄력적인 가변(Dynamic) IP를 반환하는 Domain 입니다. 팝빌 SDK의 UseStaticIP를 false(Default)로 설정하는 경우 Elastic IP가 적용됩니다.

환경 URL Port
링크허브 인증서버(공통) https://auth.LinkHub.co.kr 443
팝빌 API 운영서버(Production) https://popbill.linkhub.co.kr
팝빌 API 테스트서버(Sandbox) https://popbill-test.linkhub.co.kr
Static IP

① 보안정책 또는 방화벽으로 인해 Outbound Traffic(고객사→팝빌)의 고정 IP 설정이 필요한 경우, 아래의 Outbound 정보를 등록이 필요합니다.

환경 URL IP Port
링크허브 인증서버(공통) https://static-auth.linkhub.co.kr 52.78.164.186
13.124.222.90
443
팝빌 API 운영서버(Production) https://static-popbill.linkhub.co.kr
팝빌 API 테스트서버(Sandbox) https://static-popbill-test.linkhub.co.kr

② 팝빌 SDK의 UseStaticIP를 True로 설정하는 경우 Static IP가 적용됩니다. [SDK 환경설정]

4. IP Whitelisting

팝빌은 고객사 Source IP에 대해 Whitelisting 기능을 제공합니다. 아래의 신청양식을 작성하여 유선(1600-8536) 또는 파트너센터 메일(info@linkhubcorp.com)로 접수하여 지원됩니다.

Whitelisting 신청양식
  • 프로그램 공급사 사업자번호, LinkID
  • 등록 IP Address
  • 신청자 정보(이름/연락처/이메일)

5. 웹훅(Webhook) 통신 (팝빌→프로그램 공급사)

팝빌 웹훅 서비스를 이용하는 경우만 등록하며, Port는 보안정책에 의해 80, 443, 9854만 이용 가능합니다. [Webhook]

Source IP Destination Port
54.180.62.221
13.124.72.158
프로그램 공급사 수신용 IP/Domain 80, 443, 9854

6 . 전용선 가이드

전용선 회선 청약 관련 비용은 프로그램 공급사 부담을 원칙으로 하며, 아래 신청양식을 작성하여 파트너센터 메일(info@linkhubcorp.com)로 접수하여 지원됩니다. 회선 개통은 신청일로부터 평균 2주가 소요되므로 희망 개통일자는 라우팅 및 방화벽 작업까지 포함한 일정으로 산정하여 주시기 바랍니다.

전용선 신청양식
  • 프로그램 공급사 상호 및 사업자번호
  • 신청자 정보(이름/휴대전화/이메일)
  • IDC 소재지
  • 서버 IP Address(공인 IP만 가능, 사설 IP 불가)
  • 대역폭(Bandwidth)
  • 청약예정 ISP
  • 희망 개통일자