POPBill Developers
가이드

팝빌 연동환경

팝빌은 테스트(Sandbox) 환경과 운영(Production) 환경을 독립적으로 운영하고, 운영환경과 모든 기능이 동일하게 작동하는 테스트 환경을 제공하여 실제 서비스와 동일한 조건에서 연동개발이 가능하도록 지원하고 있습니다.

  • 독립적인 개발환경
  • 동일 인증코드(LinkID, SecretKey) 사용
  • 테스트포인트 무료 지원 (일부 제한)

연동절차

  1. 연동신청 : 프로그램 공급사 사업자정보로 연동신청 합니다. [연동신청]

    개발 테스트를 위하여 연동신청에 필요한 입력정보는 아래와 같습니다.

    1. 1) 회사정보 – 사업자번호, 회사명, 대표자, 업태, 종목, 주소
    2. 2) 계정정보 – ID, PW
      • 입력하신 정보로 관리자와 팝빌(테스트(Sandbox), 운영(Production)) 사이트 계정이 생성됩니다.
      • 승인이 완료된 ID는 변경이 불가하므로 개인이 아닌 회사를 대표하는 계정정보로 신청하여 주시기 바랍니다.
    3. 3) 담당자정보 – 이름, 이메일, 연락처
  2. 인증코드 설정 : 팝빌에서 발급한 인증코드를 수신하여 SDK에 설정합니다. [SDK 환경설정]

    팝빌은 연동신청 접수 후 20분(영업일 기준) 이내에 프로그램 공급사 고유 인증코드를 발급합니다. 팝빌 카카오톡 API 사용을 위해 수신한 인증코드를 SDK에 설정합니다.

    • 링크아이디(LinkID) : 프로그램 공급사를 식별할 수 있는 고유정보로 회원가입 등 고객사 관리에 사용됩니다.
    • 비밀키(SecretKey) : API 통신전문 변조를 방지하기 위해 사용됩니다.

    인증코드는 프로그램 공급사를 식별할 수 있는 고유정보로 외부에 유출되지 않도록 주의합니다.

  3. 카카오톡 채널 및 발신번호 사전등록 : 채널과 발신번호를 등록하여 카카오톡을 전송합니다.

    카카오톡 전송 테스트를 위해 팝빌 테스트(Sandbox) 계정에 카카오톡 채널과 발신자의 발신번호 등록이 필요합니다. 사전등록은 아래 2가지 방법을 지원합니다.

    • 팝빌 사이트 등록

      1) 카카오톡 채널 : 팝빌 테스트 환경 로그인 (https://test.popbill.com) > 문자ㆍ팩스 > 카카오톡 > 카카오톡 관리 > 카카오톡 채널 관리
      2) 발신번호 : 팝빌 테스트(Sandbox) 환경 로그인 (https://test.popbill.com)> 문자ㆍ팩스 > 카카오톡 > 발신번호 사전등록

    • API 등록

      1) 카카오톡 채널 : 카카오톡 채널 등록 API를 호출하여 등록
      [GetPlusFriendMgtURL - 카카오톡 채널 관리 팝업 URL]
      2) 발신번호 : 발신번호 사전등록 API를 호출하여 등록
      [GetSenderNumberMgtURL - 발신번호 관리 팝업 URL]

    유의사항
    • 카카오톡 채널은 카카오 비즈니스 사이트에서 생성 가능하며, 사업자 인증을 통해 비즈니스 채널로 전환합니다. [카카오톡 채널 만들기]
    • 알림톡은 카카오의 승인이 완료된 템플릿 내용으로만 메시지 전송이 가능합니다. [알림톡 템플릿 신청]
  4. 개발 테스트 : 개발에 필요한 테스트포인트를 무료 제공합니다.

    인증코드를 설정한 SDK와 연동 문서를 참고하여 모든 API 테스트가 가능합니다. 팝빌은 테스트포인트를 무료(일부 제한)로 제공하며, 포인트를 모두 소진한 경우 추가 요청도 가능합니다. [포인트 요청]

  5. 운영(Production) 서비스 전환 : 계약 체결이 완료된 이후 서비스 이용이 가능합니다.
    1. 1) 테스트가 완료된 후 운영(Production) 환경으로 서비스 전환을 신청합니다. [운영(Production) 전환] 신청하기
    2. 2) 운영 서비스 전환을 위한 협의사항을 팝빌 담당자와 유선으로 확인합니다.
    3. 3) 팝빌로부터 전환 완료 메일 수신한 후 SDK 환경설정 변수값을 변경합니다.

      - API 인증코드는 테스트와 운영 환경에서 동일하게 적용되어 별도 상업용 인증코드 발급이 필요하지 않습니다.

      - 전환 후에도 SDK 환경설정 변수로 테스트와 운영 환경을 모두 이용할 수 있습니다.

      SDK 환경설정 변경

      SDK의 서비스 객체를 생성하는 config의 IsTest값을 "true"(개발)에서 "false"(운영)로 변경합니다. [SDK 환경설정]

    4. 4) 팝빌 운영 환경 회원가입 및 서비스 이용을 위한 사전 준비사항(카카오톡 채널/발신번호 등록, 포인트 충전 등)을 처리합니다.