[iOS - swift] 2. 인앱 결제 StoreKit 개념 - 상품 구매 (SKPaymentQueue, SKPaymentTransactionObserver, transaction 추적)

* 인앱 결제 포스팅 글 목차

UI에 상품정보 표출과 결제 정보

• productID를 가지고 앱스토어에 상품 정보 요청하여 SKProduct 획득
  • 1편에서 알아본대로 productID는 로컬이나 서버에 저장된 형태
• 유저가 특성 상품을 선택하면, SKProduct를 인수로하는 SKMutablePayment로 결제에 관한 정보 입력

let payment = SKMutablePayment(product: product)
payment.quantity = 3

• StoreKit에서 제공하는 queue에 위 payment를 추가하여, 앱스토어에 결제 요청을 제출

SKPaymentQueue.default().add(payment)

• 앱스토어와 통신하기 (Transaction Observer)
  • 앱에서 transaction observer라는 것을 옵저빙하여 transaction 상태를 추적이 가능
  • 앱 런치 직후에 SKPaymentQueue를 이용하여 transaction observer를 옵저빙

func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
	SKPaymentQueue.default().add(observer)
	return true
}

• Transaction Observer 구현 방법
  • SKPaymentTransactionObserver를 준수하는 class 형태로 구현하고, delegate를 사용하여 사용하는쪽에 transaction 상태 추적이 가능하도록 제공
    • (transaction 처리 관련)
      • transaction 변경 이벤트: paymentQueue(_:updatedTransactions:)
      • 하나 이상의 transaction이 큐에서 제거 이벤트: paymentQueue(_:removedTransactions:)
    • (transaction restore 관련)
      • transaction을 restroing 하다가 에러 이벤트: paymentQueue(_:restoreCompletedTransactionsFailedWithError:)
      • restored된 transaction 전송을 완료했다는 이벤트: paymentQueueRestoreCompletedTransactionsFinished(_:)
    • (기타)
      • 사용자가 앱스토어에서 인앱 결제를 시작했다는 이벤트: paymentQueue(_:shouldAddStorePayment:for:)
      • (권한 취소) 사용자는 더 이상 가족 공유 구매에 관한 자격이 없음을 알림: paymentQueue(_:didRevokeEntitlementsForProductIdentifiers:)
      • storefront가 queue에서 변경되었음을 알리는 이벤트: paymentQueueDidChangeStorefront(_:)
  • SwiftStoreKit 라이브러리를 사용하면 내부에 구현되어 있어 있는 상태 (코드)
  • 이 TransactionObserver를 SKPaymentQueue에 등록

  func application(
      _ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
  		// some thing code
  
      SKPaymentQueue.default().add(observer)
  		return treu
  	}
  

Transaction Observer 주요 처리

• paymentQueue(_:updatedTransactions:) 메소드가 핵심
  • 유저가 앱에서 상품을 구매한 직후 인터넷이 끊긴다면, 구매한 상품을 전달해주지 못하는 상태
  • 다시 앱을 실행할 때, 친절하게도 StoreKit은 PaymentQueue(_:updatedTransactions:) 메소드를 호출해주기 때문에 이 상태를 처리
• 인수로 얻을 수 있는 updatedTransaction 인스턴스 내부에 transactionState에서 정보 획득이 가능
  • SKPaymentTransactionState 5가지 상태에 따라 적절한 처리가 필요
  • .purchasing: 서버 큐에 트랜잭션이 추가된 형태 (진행 중이라는 UI 표출)
  • .deferred: 지연되고 있다는 UI 표출
  • .failed: error 프로퍼티를 통해 유저에게 실패 메시지 UI 표출
  • .restored: 같은 앱을 다른 기기에서 사용하거나 앱을 지웠다가 재설치하여 이전에 구매한 프로덕트를 사용하고자 할때 사용
  • .purchased: 구매한 제품 UI 표출
• updatedTransaction 인스턴스의 메소드를 사용하여 최신 트랜잭션의 상태를 얻어올수 있음

앱에서 제공하는 부가 기능에 대한 결제 요청 SKPayment

• SKPayment
  • 추가적인 부가 가능에 대한 요청

init(product: SKProduct)

var productIdentifier: String
var quantity: Int // 수량
var requestData: Data?  // (개발단에서 Reserved for future use.) nil로 보내지 않으면 리젝
var applicationUsername: String?

var simulatesAskToBuyInSandbox: Bool // true이면 sandbox에서 수행

var paymentDiscount: SKPaymentDiscount? // payment에 관한 할인 정보

• SKPaymentDiscount

/// 
init(identifier: String, keyIdentifier: String, nonce: UUID, signature: String, timestamp: NSNumber)

var identifier: String
var keyIdentifier: String // 시그니처를 generate하기 위한 key 식별자

var nonce: UUID
var signature: String // 암호로 서명된 특정 할인 혜택의 속성을 나타냄 (utf-8 string)
var timestamp: NSNumber // unix epoch time 포맷된 시그니처의 생성 시간

SKPaymentTransaction

• 결제 SKPayment 인스턴스가 결제 대기열에 추가될 때 자동으로 생성
• 앱 스토어가 결제 처리를 완료했을 때 이 transaction이 앱으로 전송
  • 완료된 트랜잭션은 영수증, 트랜잭션 id 제공
  • 이를 통해 앱에서 처리된 결제에 대한 영구적인 기록 가능

var payment: SKPayment // 트랜잭션에 관한 결제 정보
var transactionIdentifier: String? // 성공적인 결제 트랜잭션을 고유하게 식별
var transactionDate: Data? // 트랜잭션이 앱스토어의 결제 대기열에 추가된 일자
var original: SKPaymentTransaction? // 앱스토어에 의해 복원된 트랜잭션
var error: Error? // 트랜잭션 처리 중 발생한 에러 객체

var downloads: [SKDownload] // 트랜잭션에 엮인 downloadable content

var transactionState: SKPaymentTransactionState // 트랜잭션의 현재 상태

*참고

https://developer.apple.com/documentation/storekit/skpayment

https://developer.apple.com/documentation/storekit/skpaymenttransaction

https://developer.apple.com/documentation/storekit/skpaymenttransactionobserver