consumePurchase API

서버 측 구매 소비에 사용되는 consumePurchase API의 세부 사항입니다.

구매를 인증한 후에는 소비됨으로 표시해야 합니다.

구매 소비에는 다음이 포함됩니다.

구매한 제품을 유저에게 할당합니다.
제품이 소비되었음을 now.gg에 알립니다.

중요 정보

이 API는 앱 백엔드 서버에서 호출되어야 합니다.

기본 URL

 https://payments-api.now.gg/

요청 경로

 v2/order/consumePurchase

요청 메서드

 POST

요청 헤더

 'Authorization': '<payment_api_key_here>',
  'Content-Type': 'application/x-www-form-urlencoded'

요청 본문

consumePurchase API와 함께 요청 본문에 다음 매개변수를 포함해야 합니다:

 "purchaseToken": "<purchase_token_here>",
  "productId": "<product_id_here>", // 멀티 스토어에만 필요
  "currency": "<currency>", // 멀티 스토어에만 필요
  "type": "<store>"  // xiaomi | onestore 존재하지 않을 경우 기본값은 nowgg로 설정됩니다.

참고: type이 없는 경우 기본값은 nowgg로 설정됩니다.

중요 정보

Amazon 및 Huawei 스토어는 서버 측 소비를 지원하지 않습니다. 클라이언트 측 소비를 참조하세요:
- 네이티브 안드로이드
- Unity

샘플 코드

다음 샘플 코드는 consumePurchase API를 통한 관련 요청 방법을 보여드립니다.

import requests

 url = "https://payments-api.now.gg/v2/order/consumePurchase"

 headers = {
     "Authorization": "<payment_api_key_here>",
     "Content-Type": "application/x-www-form-urlencoded"
 }

 data = {
     "purchaseToken": "<purchase_token_here>",
     "productId": "<product_id_here>", // 멀티 스토어에만 필요
     "developerPayload": "developerPayload",  // 선택 사항 멀티 스토어에만 필요
     "currency": "<currency>", // 멀티 스토어에만 필요
     "type": "<store>"  // xiaomi, onestore. 존재하지 않을 경우 기본값은 nowgg로 설정됩니다.
 }

 response = requests.post(url, headers=headers, data=data)

 print("응답 상태 코드:", response.status_code)
 print("응답 본문:", response.text)

curl --location --request POST 'https://payments-api.now.gg/v2/order/consumePurchase' \
 --header 'Authorization: <payment_api_key_here>' \
 --header 'Content-Type': 'application/x-www-form-urlencoded' \
 --data '{
     "purchaseToken": "<purchase_token_here>",
     "productId": "<product_id_here>", //멀티 스토어에만 필요
     "developerPayload" : developerPayload, // 선택 사항, 멀티 스토어에만 필요
     "currency": "<currency>", // 멀티 스토어에만 필요
     "type": "<store>"  // xiaomi | onestore 존재하지 않을 경우 기본값은 nowgg로 설정됩니다.
 }'

중요 정보

API 키 – Payments API Key는 nowStudio의 자격 증명에 있습니다. (자세히)
구매가 성공적으로 완료되면 purchaseToken 가 반환됩니다. 더 자세한 내용은 다음 문서를 참조하시기 바랍니다.
- PurchasedProduct(Unity)
- PurchasesUpdatedListener 및Purchase (Android)

예상 응답

다음은 consumePurchase API의 샘플 응답 메시지입니다.

 {  
   "success": true,
   "code": 0,
   "codeMsg": "success",
   "data": {}
 }

응답

변수	형	설명
success	boolean	성공 여부를 true 또는 false로 반환합니다.
code	int	성공하면 0을 반환하고 실패하면 0이 아닌 값을 반환합니다.
codeMsg	string	오류 코드와 관련된 메시지를 반환합니다.
data	object	응답 메시지로 반환된 데이터입니다.

에러 코드 매핑

코드	메시지	설명
3800	ERROR_CONSUMING_PRODUCT	제품을 소비하는 중에 오류가 발생했습니다.
3900	INVALID_AUTHORIZATION_KEY	승인을 위해 제공된 API 키가 잘못되었습니다.
3901	INVALID_PURCHASE_TOKEN	제공된 구매 토큰이 잘못되었습니다.
5014	MULTISTORE_UNKNOWN_ERROR	Multistore API에서 발생한 일반적인 오류를 나타냅니다.
5015	MULTISTORE_AUTH_ERROR	Multistore API의 인증/자격 증명 생성 중 발생한 오류를 나타냅니다.