원스토어 인앱결제 릴리즈 노트
원스토어 인앱결제 라이브러리 SDK 19.00.02 업데이트
원스토어 인앱결제 라이브러리 SDK 19.00.02가 업데이트 되었습니다.
주요 변경 사항은 다음과 같습니다.
Pending intents mutability 선언 (https://developer.android.com/about/versions/12/behavior-changes-12#pending-intent-mutability)
SDK내에 Android 12 대응을 위해 Pending intents mutability를 선언하였습니다.
Android 12 (TargetSDK 31)를 타겟팅하는 앱은 반드시 19.00.02로 업데이트 하셔야 합니다.
원스토어 인앱결제 라이브러리 API V6(SDK V19) 출시
원스토어 인앱결제 라이브러리 API V6(SDK V19.00)가 출시 되었습니다. 주요한 변경 사항은 다음과 같습니다.
새로운 상품은 원스토어 인앱결제 라이브러리 API V6(SDK V19)를 적용해야 합니다.
원스토어 인앱결제 API V5(SDK V17)을 적용한 앱은 API V6(SDK V19)로 마이그레이션이 가능합니다.
원스토어 인앱결제 API V4(SDK V16)은 이후 버전과 전혀 다른 구조로 설계 되었기 때문에, 원스토어 인앱결제 API V6(SDK V19)로 마이그레이션 할 수 없습니다.
원스토어 인앱결제 API 버전 삭제
이제 앱의 매니페스트에서 인앱 API 버전을 추가할 필요가 없습니다.
인앱결제 SDK V19에 API Version meta-data가 추가됩니다.
구매 확인
원스토어 인앱결제 라이브러리 API V6(SDK V19) 이상을 사용하는 앱에서는 3일 이내에, 구매 확인을 해야합니다.
3일 이내에 구매 확인이 되지 않으면, 아이템이 정상적으로 지급이 되지 않은 것으로 판단하고 구매를 취소 합니다.
다음 메서드 중 하나를 사용하여 구매를 확인할 수 있습니다.
소모성 제품인 경우 PurchaseClient.consumeAsync()를 사용합니다.
소모성 제품이 아니라면 PurchaseClient.acknowledgeAsync()를 사용합니다.
월정액 상품의 경우에는 최초의 결제에 대해서만 구매를 확인하면 됩니다.
원스토어 인앱결제 API V6(SDK V19)를 적용한 경우, 반드시 3일 이내에 구매 확인을 해야합니다.
3일 이내에 구매 확인이 되지 않은 경우 구매가 취소되니 주의해야 합니다.
마켓 구분 코드 얻기
IAP 라이브러리 V6부터 Server to Server API를 사용하기 위해서는 마켓 구분 코드가 필요합니다.
getStoreInfoAsync()를 통해서 마켓 구분 코드를 획득 할 수 있습니다.
PurchaseClient API 변경
| V5 (SDK V17) | V6(SDK V19) |
결제모듈과의 연결 | connect | startConnection |
결제모듈과의 연결해제 | terminate | endConnection |
지원여부 확인 | isBillingSupportedAsync | X |
인앱 상품 구매 | launchPurchaseFlowAsync | launchPurchaseFlow |
인앱 상품 소비 | consumeAsync | consumeAsync |
인앱 상품 구매 확인 | X | acknowledgeAsync |
소비되지 않은 상품의 구매내역(월 자동결제 포함) | queryPurchasesAsync | queryPurchasesAsync |
인앱 상품 상세정보 | queryProductsAsync | queryProductDetailsAsync |
월 자동결제 상태 변경 | manageRecurringProductAsync | manageRecurringProductAsync |
결제 모듈 업데이트 또는 설치 | launchUpdateOrInstallFlow | launchUpdateOrInstallFlow |
원스토어 로그인 호출 | launchLoginFlowAsync | launchLoginFlowAsync |
마켓 구분 코드 확인 | X | getStoreInfoAsync |
Server API 변경
| 구분 | API 목록 | API URI | 변경사항 | |
|---|---|---|---|---|
V5 (SDK V17) | V6 (SDK V19) | |||
변경 | OAuth 토큰발급 | /v2/oauth/token | /v6/oauth/token | 응답규격 중 status 필드 삭제 Http response code로 정상(200) 여부 확인 |
삭제 | 구매상품 상세조회 | /v2/purchase/details/{purchaseId}/{packageName} | N/A | 보안 강화를 위하여 구매상품 상세조회 API는 삭제 구매상품 상세조회 By 인앱상품ID로 통합 |
변경 | 구매상품 상세조회 By 인앱상품ID | /v2/purchase/details-by-productid /{purchaseId}/{packageName}/{productId} | /v6/apps/{packageName}/purchases/inapp/products /{productId}/{purchaseToken} | 응답 규격에 purchaseId, acknowledgeState 필드 추가 |
변경 | 월정액 상품 구매 상세조회 | /v2/purchase/recurring-details/{purchaseId}/{packageName} | /v6/apps/{packageName}/purchases/auto/products /{productId}/{purchaseToken} | 응답규격에 acknowledgeState, lastPurchaseId, lastPurchaseState 추가 응답규격에 price, developerPayload, purchaseState 삭제 |
삭제 | 월정액 상품 마지막 구매 상세조회 | /v2/purchase/last-recurring-details/{purchaseId}/{packageName} | N/A | 월정액 상품 구매 상세조회 API 로 통합 |
변경 | 자동결제 해지 | /v2/purchase/manage-payment-status/{purchaseId}/{packageName}/cancel | /v6/apps/{packageName}/purchases/auto/products /{productId}/{purchaseToken}/cancel | 성공처리 응답규격변경 |
변경 | 자동결제 해지취소 | /v2/purchase/manage-payment-status/{purchaseId}/{packageName}/reactivate | /v6/apps/{packageName}/purchases/auto/products /{productId}/{purchaseToken}/reactivate | 성공처리 응답규격변경 |
변경 | 구매취소 내역조회 | /v2/purchase/voided-purchases/{packageName} | /v6/apps/{packageName}/voided-purchases | API 사용성 향상을 위하여 구매취소내역 조회기준(startTime, endTime)을 구매일시에서 구매취소일시로 변경 응답규격에 purchaseToken, marketCode 추가 |
변경 | 구매상품 소비 | /v2/purchase/consume/{purchaseId}/{packageName} | /v6/apps/{packageName}/purchases/all/products/ {productId}/{purchaseToken}/consume | 성공처리 응답규격변경 |
추가 | 구매 확인 | N/A | /v6/apps/{packageName}/purchases/all/products/ {productId}/{purchaseToken}/acknowledge | 구매 확인 API 신규 추가 |
PNS 메시지 규격 변경
원화 외의 통화를 지원하기 위하여 결제금액(price)의 데이터 타입이 Number에서 String으로 변경하였습니다.
원화 외의 통화를 지원하기 위하여 결제금액의 통화코드(priceCurrencyCode)를 추가하였습니다.
원화 외의 통화를 지원하기 위하여 결제수단별금액(amount)의 데이터 타입이 Number에서 String으로 변경하였습니다.
응답 규격에 purchaseToken, environment, marketCode 필드가 추가되었습니다.
상세한 규격은 PNS 메시지 상세 변경 내역에서 확인 할 수 있습니다.
원스토어 인앱결제 라이브러리 API V5(SDK V17)
API 버전은 개발사 애플리케이션의 'AndroidManifest.xml' 파일에 아래와 같이 명시되어야 합니다.
자세한 내용은 인앱결제 적용을 위한 사전준비 페이지의 'Android Manifest 파일 설정' 부분을 참고하시기 바랍니다.
API V5 (SDK V17)에서 개선된 사항은 다음과 같습니다.
항목 세부 개선 항목 설 명 API
Consume 개념 도입
아이템 미지급 상황 발생 시 앱에서 복구할 수 있는 로직을 제공합니다.
Custom PID 지원
인앱상품 ID(PID)를 개발자가 직접 입력할 수 있어, 직관적인 PID로 생성하여 운영할 수 있습니다.
보편적인 인앱결제 인터페이스 제공
타 마켓향으로 개발한 앱을 코딩상의 큰 개발공수 없이 원스토어향으로 런칭할 수 있습니다.
결제 테스트 환경
개발/상용 테스트 환경 분리 제공
개발사의 검증 환경과 동일 수준의 원스토어 결제환경을 제공합니다.
개발사의 개발환경에서는 원스토어 Sandbox와 연동하여 개발/테스트 할 수 있고, 개발사의 상용환경에서는 원스토어 상용환경에서 실결제를 해볼 수 있습니다.
원스토어 개발자센터에서 테스트 ID로 등록한 ID로 원스토어 로그인 후, 실결제한 경우, 개발자가 자유롭게 구매취소 가능합니다.
구분
개발자
개발환경
상용환경
원스토어 결제환경
Sandbox
O
-
상용환경 (실 결제)
-
O
결제창 UI
전면/팝업 결제화면 선택 가능
전체 결제화면 또는 팝업 결제화면을 선택할 수 있습니다. 결제화면 설정은 원스토어 인앱결제 적용을 위한 사전준비 페이지의 'Android Manifest 파일 설정' 부분을 참고하시기 바랍니다.
연동 방식
IAP SDK, AIDL 선택 가능
기존의 SDK 방식 뿐만 아니라, AIDL를 이용하여 직접 OSS와 연동할 수 있습니다. 단, 원스토어 서비스(ONE store service, OSS) 앱이 설치되어 있지 않은 단말에서는 인앱결제가 정상적으로 동작하지 않습니다. 원스토어 서비스 앱 설치에 대한 내용은 원스토어 인앱결제 적용을 위한 사전준비 페이지의 '원스토어 앱 설치' 부분을 참고하시기 바랍니다.
개발자센터
타 마켓 앱 상품 정보 크롤링 기능 개선
기 등록된 타 마켓 앱 상품을 원스토어에 간편하게 등록할 수 있습니다.
타 마켓 인앱상품 정보 import 기능 제공
인증센터
OAuth 발급/인증/관리
개발자의 서버와 원스토어 인앱결제 서버 연동 시 데이터 보안을 강화하였습니다.
Last updated