모든 문서(일반 문서, 분류 문서, 파일(이미지, 사운드 등) 문서) 분류가 달려 있어야 합니다.

--Administrator (토론)

InApp Purchase 모듈 적용 가이드 (iOS)

컴투스위키
이동: 둘러보기, 찾기
Com2uS 공통모듈 >> InApp Purchase >> InApp Purchase 모듈 적용 가이드 (iOS)

InApp Purchase 모듈 적용 가이드 (Android)

InApp Purchase 모듈 적용 가이드 (Unity3d)

>> InApp Purchase 모듈 레퍼런스 가이드 >> InApp Purchase 샘플 가이드 (Android) >> InApp Purchase FAQ


목차

역사

<작성법 참고>
Version Date SVN Revision 담당자 변경 사항
2.13.6 2020-06-16 정다운
  • 인앱 결제 부정행위를 방지할 목적으로 가이드라인에 맞게 해시값을 변경 전송
2.13.5 2020-03-12 정다운
  • Finish API 호출시 크래시 발생하는 이슈 수정
2.13.4 2020-01-23 정다운
  • Common Module v1.6.0 이상 필수 적용
  • 네트워크 통신 로직 개선
2.13.3 2019-10-16 최보경
  • Common Module v1.5.0 이상 필수 적용
    • 주의 : 모든 개별모듈 동시 업데이트 필요
  • iOS 13을 대상으로 한 앱에서의 정상적인 동작을 보장
    • 클라이언트에 저장되는 모든 프로퍼티를 iCloud 백업 대상에서 제외
  • restore_fail 시 stateValue에서 nil 값 전달하지 않고 error string 전달하도록 수정
2.13.2 2018-11-15 2850 최보경
2.13.1 2018-10-01 2846 최보경
  • InApp v1.0 상품 구매 로그에 price_number 데이터를 전달하도록 추가
2.13.0 2017-09-20 2819 최보경
  • 앱스토어 구매 요청 시 앱으로 전달되는 scheme 값 내부의 pid를 저장하는 로직 추가
  • CheckPromotePurchase API 추가 (클라이언트에 저장된 앱스토어 구매 요청 pid를 전달해주는 API) (CS_IapCheckPromotePurchase 레퍼런스)
  • Observer 를 StoreStart가 아니라 Initialize 시에 붙이고 StoreStart 때에는 아직 처리되지 못한 구매 데이터나 기존 Transaction을 탐색하도록 수정
  • StoreEnd API deprecated
2.12.5 2017-08-11 2814 최보경
  • 모듈 내부 서버통신 데이터에 통합 식별자 추가
  • 언어 설정은 게임 언어를 우선시하며 게임 언어를 설정하지 않을 경우 단말 언어를 따르도록 수정
    • ActiveUser SetGameLanguage API 를 통해 게임 언어 설정 가능 (ActiveUser v2.7.3 이상)
  • UI 관련 텍스트 국가별 추가 번역 및 오탈자 수정
  • 가격 표시 정보가 단말 언어를 기준으로 표시되던 부분을 계정 국가 기준으로 표시되도록 수정
2.12.4 2017-07-11 2809 최보경
  • 모듈 내부 아랍어 텍스트 추가
2.12.3 2016-11-21 2794 정다운
  • ATS(App Transport Security) 관련 대응 (모듈 내부에서 호출하는 http 도메인을 https로 변경)
2.12.2 2016-07-27 2782 정다운
  • DNS 변경
    • 변경전 : pubbilling.com2us.net
    • 변경후 : s.qpyou.cn
2.12.1 2016-02-01 2751 김규진
  • 개별 서버 설정값이 반영되도록 수정
2.12.0 2016-01-04 2737 김규진
  • 샌드박스 환경 지원
  • 버전 코드 변경 (안드로이드 매칭)
1.5.3 2015-09-02 2722 김규진
  • 중국어 언어 코드 변경
1.5.2 2015-04-06 2656 김규진
  • Restore 시도 시, Module 자체적으로 PopUp 띄워 사용자에게 알림.
(Module 자체에서 팝업 띄움)
1.5.1 2015-02-06 2639 김규진
  • 최소 빌드 버젼 iOS 6.0 으로 변경
  • Common Module에서 디바이스 정보를 가져옴
1.5.0 2015-01-07 2629 조태형
  • arm64 지원
  • TouchJson lib 제거 (TouchJson lib 삭제하세요)
1.4.0 2013/08/22 2462 조태형
  • 모듈 버전 수집 기능 추가
  • 서버 프로토콜 DID 정보 추가
1.3.2 2012/10/25 김혜란
1.3.0 2012/10/25 김혜란
  • useAutoLogging -> autoVerify, RESTORE_FAIL, RESTORE_FINISHIED 추가
1.2.0 2012/06/01 김인홍
  • StoreStart 이전에 BuyItem 호출할 경우 실패 리턴
1.1.2 2012/04/04 김인홍
  • CommonModule 라이브러리 링크 추가
  • UDID 필드 제거
1.1.1 2012/03/22 김인홍
  • 라이브러리 버전 서버 전송
  • 인앱 리스트 formatted string 수정 ex) USD


모든 버전의 역사 보기


적용 유의 사항

과금 아이템 설정

  • InApp 요청 템플릿을 작성하여, 사업부 담당자에게 전달한다. (mail - 수신 : 오형근 , 참조 : tech_support)
  1. 아이템명: iTunes Connect에 보여지는 고유 명칭.
  2. Product ID: 해당 아이템의 고유 ID
  3. Type: 소모성, 비소모성, 구독(거의 안쓰임) 중 결정한다. 비소모성(영구성)인 경우 복원을 통해 다시 받을수 있다.
  4. Price: 가격
  5. Language: 해당 언어(ex) Korean, English, French...
  6. Display Name: 게임 내 인앱 결제창에 보여지는 아이템의 이름
  7. Description: 게임 내 인앱 결제창에 보여지는 아이템의 설명


과금 아이템 정보 예시

iTunesConnect inApp.png


과금 테스트

  • 과금 테스트는 샌드박스 서버(테스트 서버)에서 가능하며, Debug빌드로 테스트 해야 합니다.
  • 샌드박스 영수증은 샌드박스 서버에서 검증해야합니다.
  • 현재 과금 테스트는 상용 프로비저닝으로만 가능합니다. (예: Com2uS USA 계정) 물론 기기도 상용으로 등록되어 있어야 합니다.
  • 과금 테스트 계정과 프로비저닝은 QA파트에 문의 하시면 됩니다.


적용 방법

라이브러리 추가

  1. 위 경로에서 InApp 라이브러리와 그 외 필요한 라이브러리를 다운받습니다.
  2. 원하는 프로젝트 경로에 파일을 추가합니다.


헤더 추가

  1. 위 경로에서 InApp 헤더 파일을 다운받습니다. (C2SInApp.h)
  2. 원하는 프로젝트 경로에 파일을 추가합니다.


Other Linker Flags

  • 원하는 프로젝트 타겟을 선택 후, Other Linker Flags를 검색합니다.
  • 각 항목에 맞게 아래 내용을 입력합니다.
    • debug: -ObjC -lC2SInApp_$(PLATFORM_NAME)d -lC2SCommonModule_$(PLATFORM_NAME)d
    • release: -ObjC -lC2SInApp_$(PLATFORM_NAME) -lC2SCommonModule_$(PLATFORM_NAME)


Framework 추가

  • XCode Project 에서 StoreKit.framework 를 추가한다

Log Server Information

market        apple
appid         AppID
appversion    어플 버전 정보 (x.x.x 형식) 
device        디바이스 정보
udid          단말 고유 ID  //deprecated
osversion     OS 버전 정보
country       국가정보(ISO 3166-1 alpha-2) 
language      언어정보(ISO 639-1)
type          0:구매, 1:복구
transaction   영수증 데이터
currency      통화 단위 코드 (ISO 4217)
price         구매 가격
mac           Mac 어드레스
libver        라이브러리 버전


Com2uS 공통모듈 >> InApp Purchase >> InApp Purchase 모듈 적용 가이드 (iOS)

InApp Purchase 모듈 적용 가이드 (Android)

InApp Purchase 모듈 적용 가이드 (Unity3d)

>> InApp Purchase 모듈 레퍼런스 가이드 >> InApp Purchase 샘플 가이드 (Android) >> InApp Purchase FAQ
개인 도구
이름공간

변수
행위
둘러보기
도구모음
인쇄/내보내기