ระบบการชำระเงินแบบสมัครสมาชิก

การสมัครสมาชิกแบบต่ออายุอัตโนมัติ¶

Hive SDK v4.11.6 รองรับฟีเจอร์ใหม่ที่เรียกว่า การสมัครสมาชิกอัตโนมัติ ซึ่งจะทำการชำระเงินเป็นระยะๆ ประเภทของการสมัครสมาชิกมีการสมัครสมาชิกแบบรายเดือน การสมัครสมาชิกแบบรายปี และการทดลองใช้ฟรีโดยทั่วไป หากคุณต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบการสมัครสมาชิกที่ให้บริการโดย Google และ Apple โปรดดูตารางด้านล่าง การสมัครสมาชิกอัตโนมัติจะมีให้หากผู้ใช้เลือกช่วงเวลาของการชำระเงินเป็นระยะตามประเภทของระบบปฏิบัติการ

ตรวจสอบให้แน่ใจว่าผู้ใช้เกมของคุณสามารถเข้าถึงการสมัครสมาชิกอัตโนมัติได้ตลอดเวลาไม่ว่าจะเป็นประเภทอุปกรณ์ใดก็ตามหากผู้ใช้ถูกเรียกเก็บเงินเป็นประจำสำหรับการสมัครสมาชิกเฉพาะ การกู้คืนการสมัครสมาชิกเป็นฟีเจอร์ที่จำเป็นตามความต้องการของผู้ใช้

การเปลี่ยนแปลงราคา การสมัครสมาชิกแบบต่ออายุอัตโนมัติสามารถอัปเกรดหรือดาวน์เกรดระดับการสมัครสมาชิกได้ฟรี การสมัครสมาชิกไม่ใช่การใช้งานครั้งเดียว และจะมีใบเสร็จเมื่อผู้ใช้พยายามคืนสถานะ

บน Google การสมัครสมาชิกฟรีในการอัปเกรดหรือลดระดับการสมัครสมาชิกและเปลี่ยนเป็นระดับใหม่โดยไม่คำนึงถึงการสมัครสมาชิกก่อนหน้านี้ หากผู้ใช้เปลี่ยนราคา มูลค่าของการสมัครสมาชิกก่อนหน้านี้จะถูกคำนวณเป็นรายวันและจัดเตรียมหลังจากการหมดอายุของการสมัครสมาชิกใหม่

บนแพลตฟอร์มของ Apple กลุ่มการสมัครสมาชิกจะถูกกำหนดในคอนโซล iTunes ดังนั้นการเปลี่ยนไปยังประเภทการสมัครสมาชิกอื่นในกลุ่มเดียวกันจึงเป็นไปได้ หากผู้ใช้ทำการอัปเกรดการสมัครสมาชิกของเขา/เธอ มูลค่าของการสมัครสมาชิกก่อนหน้านี้จะถูกคำนวณตามรายวันและจะถูกจัดเตรียมหลังจากการหมดอายุของการสมัครสมาชิกใหม่ ในกรณีที่มีการลดระดับ จะมีการต่ออายุไปยังการสมัครสมาชิกใหม่หลังจากที่การสมัครสมาชิกที่มีอยู่หมดอายุลง

การซื้อ การกู้คืน และระยะเวลาผ่อนผัน¶

การซื้อ¶

• การทดลองใช้งานฟรี หากการสมัครสมาชิกมีระยะเวลาทดลองใช้งานฟรี จะไม่ถูกคำนวณเป็นยอดขาย หลังจากระยะเวลาทดลองใช้งานฟรีสิ้นสุดลง การสมัครสมาชิกจะถูกเรียกเก็บเงินโดยอัตโนมัติ
• ส่วนลดสำหรับผู้สมัครสมาชิกใหม่ นี่คือโปรโมชั่นสำหรับผู้สมัครสมาชิกใหม่ โปรโมชั่นนี้มีให้ในช่วงเวลาที่กำหนดพร้อมราคาที่ลดลง。

การยกเลิก¶

ผู้ใช้สามารถยกเลิกการสมัครสมาชิกก่อนช่วงการต่ออายุ วิธีการยกเลิกได้อธิบายไว้ในเมนู จัดการการสมัครสมาชิก จากแต่ละตลาด หลังจากการสมัครสมาชิกถูกยกเลิก การต่ออายุอัตโนมัติจะหมดอายุ

การคืนเงิน¶

หากผู้ใช้สมัครสมาชิกขอคืนเงินมูลค่าที่เหลือของการสมัครสมาชิกหลังจากการยกเลิก จำนวนเงินคืนจะคำนวณตามระยะเวลาที่เหลือและมูลค่าของการสมัครสมาชิก (Google console)。

การฟื้นฟู¶

ผู้ใช้สามารถคืนสถานะการสมัครสมาชิกได้หากการสมัครสมาชิกไม่สามารถใช้งานได้หลังจากการชำระเงิน การคำนวณมูลค่าสำหรับการคืนสถานะขึ้นอยู่กับนโยบายการเป็นเจ้าของหากผู้ใช้มีสิทธิ์ในการเป็นเจ้าของการสมัครสมาชิก

ระยะเวลาผ่อนผัน¶

เมื่อการต่ออายุการสมัครสมาชิกไม่สามารถเรียกเก็บเงินได้ ให้ใช้ระยะเวลาผ่อนผัน ตรวจสอบให้แน่ใจว่าค่าของสถานะในระยะเวลาผ่อนผันนั้นเหมือนกับการสมัครสมาชิก

การระงับบัญชี (Google)¶

การระงับบัญชีเป็นสถานะที่ไม่สามารถต่ออายุการสมัครสมาชิกได้เนื่องจากปัญหาที่เกิดขึ้นในขณะชำระเงิน และสิ้นสุดด้วยปัญหาที่ไม่ได้รับการแก้ไข ในกรณีนี้ให้แน่ใจว่าการสมัครสมาชิกจะไม่สามารถใช้งานได้สูงสุด 30 วัน

หยุด (Google)¶

การหยุดการสมัครสมาชิกสามารถทำได้สูงสุดสามเดือน เมื่อสิ้นสุดระยะเวลา การสมัครสมาชิกจะถูกต่ออายุโดยอัตโนมัติ

แสดงป๊อปอัปการแจ้งเตือนของ Google¶

หากสถานะการสมัครสมาชิกของ Google อยู่ใน ระยะเวลาผ่อนผัน หรืออยู่ใน สถานะการระงับบัญชี ให้แสดงป๊อปอัปการแจ้งเตือน ป๊อปอัปควรมีสถานะการสมัครสมาชิกปัจจุบัน วิธีการแก้ปัญหา และปุ่มที่เชื่อมโยงไปยังการตั้งค่าตลาด ปุ่มนี้ไม่จำเป็นในระยะเวลาผ่อนผัน แต่แนะนำให้ใช้งานเพื่อความสะดวกของผู้ใช้ ในกรณีที่ผู้ใช้เปลี่ยนข้อมูลการชำระเงินใน ระยะเวลาผ่อนผัน หรือในสถานะ ระงับ การสมัครสมาชิกจะถูกชำระเงินโดยอัตโนมัติเมื่อผู้ใช้ถูกตั้งค่าในกรณีของสถานะ ระยะเวลาผ่อนผัน ในสถานะ การระงับบัญชี ผู้ใช้ควรเริ่มต้นการสมัครสมาชิกใหม่ เมื่อสถานะการสมัครสมาชิกของผู้ใช้ถูกต่ออายุหลังจากการเริ่มต้นใหม่ ให้จัดเตรียมหน้าซื้อการสมัครสมาชิกและปุ่มการกู้คืนเพื่อให้ผู้ใช้ได้รับประโยชน์จากการสมัครสมาชิกของตน

ตัวอย่างป๊อปอัปการแจ้งเตือนมีดังนี้ ใช้ข้อความเหล่านี้หรือปรับแต่งสำหรับแต่ละเกม * ข้อความการแจ้งเตือนในช่วงกร Grace Period

• ข้อความแจ้งเตือนเมื่ออยู่ในสถานะรอดำเนินการ

กระบวนการซื้อการสมัครสมาชิก¶

แผนภาพ¶

แผนภาพกระบวนการ¶

การสนับสนุนการสมัครสมาชิก Google V2¶

Google subscription API V2 ช่วยให้คุณสร้างและจัดการผลประโยชน์หลายรายการโดยใช้วิธีการสมัครสมาชิกใหม่ ตัวอย่างของผลประโยชน์รวมถึงผลประโยชน์จากการสมัครสมาชิกครั้งแรกของคุณ และส่วนลดเมื่อสมัครผลิตภัณฑ์เพิ่มเติมเมื่อคุณมีการสมัครสมาชิกอยู่แล้ว สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการสมัครสมาชิกของ Google โปรดดูที่ นี่。

หากคุณใช้การสมัครสมาชิก Google V2 คุณสามารถมอบสิทธิประโยชน์ที่แตกต่างกันให้กับราคาการชำระเงินตามสถานะการสมัครสมาชิก เช่น ระยะเวลาการสมัครสมาชิกและจำนวนการสมัครสมาชิกในอดีต เพื่อใช้การสมัครสมาชิก Google V2 กรุณาทำตามขั้นตอนด้านล่าง

ลงทะเบียนผลิตภัณฑ์ใน Google Play Console¶

ลงทะเบียนผลิตภัณฑ์ของคุณเพื่อขายโดยใช้ Google Subscription V2 บน Google Play Console สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ Play Console Guide .

ตรวจสอบข้อมูลผลิตภัณฑ์ที่ลงทะเบียนด้วย getSubscriptionProductInfo¶

คุณสามารถตรวจสอบข้อมูลผลิตภัณฑ์ที่ลงทะเบียนใน Google Play Console ได้ที่ค่าการตอบกลับของวิธี IAPV4.getSubscriptionProductInfo ซึ่งเป็น originalMarketJson ของวัตถุ IAPV4Product。 * productId: ผลิตภัณฑ์ * basePlanId: แผนการสมัครสมาชิก * offerIdToken: สิทธิประโยชน์

ด้านล่างนี้นำเสนอผลิตภัณฑ์ตัวอย่างชื่อ "sub003" ซึ่งข้อมูลสามารถพบได้ใน originalMarketJson หลังจากลงทะเบียนการชำระเงินรายสัปดาห์และรายเดือนแต่ละรายการและกำหนดสองประโยชน์สำหรับการชำระเงินรายเดือน

{
    "productId": "sub003",
    "type": "subs",
    "title": "sub003-name (HIVE SDK)",
    "name": "sub003-name",
    "localizedIn": [
        "ko-KR"
    ],
    "skuDetailsToken": "AEuhp4KfxD0MTrwzJV_jl0exSz9NuCZzipMe8mo45lR7pi3y_bWsvXdeKNM04CMxxNY=",
    "subscriptionOfferDetails": [
        {
            "offerIdToken": "AUj\/Yhj7Zx5lt7B0G4qWDtmPFDioPkobZB7zw0xi1A8+B4iD0AbZbwQJKitQLCjR9CMLssbH+g43p4wf3tLREE8H41NgdDpOaCsla0xoTQKPkCsH6+U4XszzPUtOGNwuskbzNjEDfTJoF50j1fSd+IXCkQ==",
            "basePlanId": "baseprice-p1m",
            "offerId": "offer-freetrial",
            "pricingPhases": [
                {
                    "priceAmountMicros": 0,
                    "priceCurrencyCode": "KRW",
                    "formattedPrice": "free",
                    "billingPeriod": "P1M",
                    "recurrenceMode": 2,
                    "billingCycleCount": 1
                },
                {
                    "priceAmountMicros": 1650000000,
                    "priceCurrencyCode": "KRW",
                    "formattedPrice": "₩1,650",
                    "billingPeriod": "P1M",
                    "recurrenceMode": 2,
                    "billingCycleCount": 2
                },
                {
                    "priceAmountMicros": 3300000000,
                    "priceCurrencyCode": "KRW",
                    "formattedPrice": "₩3,300",
                    "billingPeriod": "P1M",
                    "recurrenceMode": 1
                }
            ],
            "offerTags": [
                "offer-free",
                "offer-freetrial"
            ]
        },
        {
            "offerIdToken": "AUj\/YhjUXnT6K8XbdZd5lUtCSef0HA+qikjGfNPEAXvLeLKWTZ0RqwcFIvR5GhECXTRD1SdUrn0LcaB6oquBo5QeUTEZJGTstWGzfmrwL3oSsvBs1EERERSdJ6NDq54=",
            "basePlanId": "baseprice-p1m",
            "pricingPhases": [
                {
                    "priceAmountMicros": 3300000000,
                    "priceCurrencyCode": "KRW",
                    "formattedPrice": "₩3,300",
                    "billingPeriod": "P1M",
                    "recurrenceMode": 1
                }
            ],
            "offerTags": []
        },
        {
            "offerIdToken": "AUj\/YhhlJDIsjfnvcc5TfxlBjSA+o3QcNsCAjU+DfXBJn2JF\/zLgew468AvchceNBynmB3CvnPLhqlr8be8dJlIvAEkKgdas1DGoiu3p52jSvwsxh8jQLN7QReXUdrY=",
            "basePlanId": "baseprice-p1w",
            "pricingPhases": [
                {
                    "priceAmountMicros": 500000000,
                    "priceCurrencyCode": "KRW",
                    "formattedPrice": "₩500",
                    "billingPeriod": "P1W",
                    "recurrenceMode": 1
                }
            ],
            "offerTags": []
        }
    ]
}

มีค่าประโยชน์หลักทั้งหมด 3 ค่าแสดงในตัวอย่าง offerIdToken ข้างต้น, 2 ประเภทประโยชน์สำหรับการชำระเงินรายเดือนและ 1 ประโยชน์พื้นฐานสำหรับการชำระเงินรายสัปดาห์ ประโยชน์แรกหรือประโยชน์ที่สองจะถูกนำไปใช้กับผู้ใช้เมื่อทำการชำระเงินรายเดือน

ขอสมัครสมาชิก¶

ขอสมัครสมาชิกตามที่แสดงด้านล่างโดยใช้วัตถุ IAPV4Product originalMarketJson ที่ได้รับข้างต้น คุณสามารถขอสมัครสมาชิกโดยการนำสิทธิประโยชน์ที่เกี่ยวข้องไปใช้กับผู้ใช้

using hive;    
    IAPV4PurchaseParam.Builder builder = new IAPV4.IAPV4PurchaseParam.Builder();    
    IAPV4PurchaseParam param = builder.setMarketPid("YOUR_PRODUCT_MARKET_PID")    
    .setOldMarketPid("YOUR_PRODUCT_OLD_MARKET_PID")    
    .setIapPayload("YOUR_PAYLOAD")    
    .setOfferToken("YOUR_OFFER_ID_TOKEN")    
    .build();    

    IAPV4.purchaseSubscription (param, (ResultAPI result, IAPV4Receipt receipt) => {    
        if (result.isSuccess()) {    
        // TODO: Request verification of receipt with received receipt    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4PurchaseParam Param;
Param.MarketPid = TEXT("YOUR_PRODUCT_MARKET_PID");
Param.OldMarketPid = TEXT("YOUR_PRODUCT_OLD_MARKET_PID");
Param.IapPayload = TEXT("YOUR_PAYLOAD");
Param.OfferToken = TEXT("YOUR_OFFER_ID_TOKEN");

FHiveIAPV4::PurchaseSubscription(Param, FHiveIAPV4OnPurchaseDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveIAPV4Receipt& Receipt) {
        if (Result.IsSuccess()) {
                // TODO: Request verification of receipt with received receipt
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    auto* param = new IAPV4PurchaseParam();    
    param->marketPid = "YOUR_PRODUCT_MARKET_PID";    
    param->oldMarketPid = "YOUR_PRODUCT_OLD_MARKET_PID";    
    param->iapPayload = "YOUR_PAYLOAD";    
    param->offerToken = "YOUT_OFFER_ID_TOKEN";    

    IAPV4::purchaseSubscription(*param, [=](ResultAPI const & result, IAPV4Receipt const & receipt) {    
         if (result.isSuccess()) {    
             // TODO: Request verification of receipt with received receipt    
         }    
});

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    val param = IAPV4.IAPV4PurchaseParam.Builder()    
    .setMarketPid("YOUR_PRODUCT_MARKET_PID")    
    .setOldMarketPid("YOUR_PRODUCT_OLD_MARKET_PID")    
    .setIapPayload("YOUR_PAYLOAD")    
    .setOfferToken("YOUR_OFFER_ID_TOKEN")    
    .build()    
    IAPV4.purchaseSubscription(param, object : IAPV4.IAPV4PurchaseListener {    
         override fun onIAPV4Purchase(result: ResultAPI, receipt: IAPV4.IAPV4Receipt?) {    
             if (result.isSuccess) {    
                 // TODO: Request verification of receipt with received receipt    
             }    
         }    
})

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    IAPV4.IAPV4PurchaseParam param = new IAPV4.IAPV4PurchaseParam.Builder()    
             .setMarketPid("YOUR_PRODUCT_MARKET_PID")    
             .setOldMarketPid("YOUR_PRODUCT_OLD_MARKET_PID")    
             .setIapPayload("YOUR_PAYLOAD")    
             .setOfferToken("YOUR_OFFER_ID_TOKEN")    
             .build();    
    IAPV4.INSTANCE.purchaseSubscription(param, (result, iapV4Receipt) -> {    
         if (result.isSuccess()) {    
             // TODO: Request verification of receipt with received receipt    
         }    
});

import HIVEService    
    let param = IAPV4PurchaseParam.Builder()    
    .setMarketPid("YOUR_PRODUCT_MARKET_PID")    
    .setOldMarketPid("YOUR_PRODUCT_OLD_MARKET_PID")    
    .setIapPayload("YOUR_PAYLOAD")    
    .setOfferToken("YOUR_OFFER_ID_TOKEN")    
    .build()    

    IAPV4Interface.purchaseSubscription(param) { result, receipt in    
        if result.isSuccess() {    
        // TODO: Request verification of receipt with received receipt    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    HIVEIAPV4PurchaseParamBuilder *builder = [[HIVEIAPV4PurchaseParamBuilder alloc] init];    
    HIVEIAPV4PurchaseParam *param = [[[[[builder setMarketPid: @"YOUR_PRODUCT_MARKET_PID"]    
    setIapPayload: @"YOUR_PRODUCT_OLD_MARKET_PID"]    
    setOldMarketPid: @"YOUR_PAYLOAD"]    
    setOfferToken: @"YOUR_OFFER_ID_TOKEN"]    
    build];    

    [HIVEIAPV4 purchaseSubscription: param handler: ^(HIVEResultAPI *result, HIVEIAPV4Receipt *receipt) {    
        if ([result isSuccess]) {    
        // TODO: Request verification of receipt with received receipt    
        }    
}];

Subscription API¶

รับรายการผลิตภัณฑ์การสมัครสมาชิก¶

เมื่อผู้ใช้เข้าสู่ร้านค้าผลิตภัณฑ์การสมัครสมาชิกในเกม จะต้องเรียกใช้เมธอด IAPV4.getSubscriptionProductInfo() ซึ่งจะสอบถามรายการผลิตภัณฑ์การสมัครสมาชิก เมื่อเรียกใช้ API นี้ จะส่งคืนวัตถุ IAPV4Product ซึ่งมีรายการผลิตภัณฑ์และข้อมูลผลิตภัณฑ์เป็นผลลัพธ์ วัตถุ IAPV4Product จะคล้ายกับที่ส่งคืนใน การค้นหารายการผลิตภัณฑ์

วัตถุ IAPV4Product¶

displayPrice¶

• ส่ง displayPrice พร้อมกับการรวมกันของสัญลักษณ์สกุลเงินและราคาในลำดับ (เช่น $0.99) เนื่องจาก Android หรือ iOS มีประเภทการแสดงผลของตัวเอง ลำดับของสัญลักษณ์สกุลเงินและราคาอาจแสดงผลแตกต่างกันในหลายประเทศขึ้นอยู่กับระบบปฏิบัติการ
• ตรวจสอบให้แน่ใจว่าได้แสดงสัญลักษณ์สกุลเงินของแต่ละประเทศให้ตรงกับตารางของมัน อ้างอิงจากนโยบาย Hive Identifier เพื่อยืนยันตารางของสัญลักษณ์สกุลเงิน
• ในกรณีที่มีประเทศเพิ่มเติมที่ต้องการเพิ่มหรือเปลี่ยนแปลง VAT เซิร์ฟเวอร์จะคำนวณ VAT ของสกุลเงินทั้งหมดและเพิ่มไปยัง displayPrice, price, displayOriginalPrice และ originalPrice ดังนั้นคุณจึงไม่ต้องทำงานเพิ่มเติมเกี่ยวกับ VAT

ต่อไปนี้คือตัวอย่างโค้ดในการ implement วิธีการ getSubscriptionProductInfo()

```None linenums="1"
// Request to search subscription lists
IAPV4::getSubscriptionProductInfo([=](ResultAPI const & result, std::vector const & productInfoList, unsigned int balance) {
        if (result.isSuccess()) {
                for( auto productInfo : productInfoList) {
                        // Implementation of the desired features by the game studio, such as shop UI.
                }
        }
        else {
                // Error Handling
        }
});
```

#include "HiveIAPV4.h"

FHiveIAPV4::GetSubscriptionProductInfo(FHiveIAPV4OnProductInfoDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<FHiveIAPV4Product>& ProductInfoList, uint32 Balance) {

        if (Result.IsSuccess()) {
                for (const auto& ProductInfo : ProductInfoList) {
                        // Implementation of the desired features by the game studio, such as shop UI.
                }
        } else {
                // Error Handling
        }
}));

// Request to search subscription lists    
    IAPV4.getSubscriptionProductInfo(new IAPV4.IAPV4ProductInfoListener() {    
        @Override    
        public void onIAPV4ProductInfo(ResultAPI result, final List iapV4ProductList, final int balance) {    
            if (result.isSuccess()) {    
                for (IAPV4Product productInfo : iapV4ProductList) {    
                // Implementation of the desired features by the game studio, such as shop UI.    
                }    
            } else {    
                // Error Handling    
            }    
        }    
});

// การร้องขอเพื่อค้นหารายการสมัครสมาชิก
    IAPV4.getSubscriptionProductInfo(new IAPV4.IAPV4ProductInfoListener() {
            @Override
            public void onIAPV4ProductInfo(ResultAPI result, final List iapV4ProductList, final int balance) {
                    if (result.isSuccess()) {
                            for (IAPV4Product productInfo : iapV4ProductList) {
                            // การดำเนินการฟีเจอร์ที่ต้องการโดยสตูดิโอเกม เช่น UI ร้านค้า
                            }
                    } else {
                            // การจัดการข้อผิดพลาด
                    }
            }
    });

    // Request to search subscription lists
    [HIVEIAPV4 getSubscriptionProductInfo:^(HIVEResultAPI *result, NSArray *productInfoList, NSUInteger balance) {
            if( [result isSuccess]) {
                    for( HIVEIAPV4Product* productInfo in productInfoList) {
                            // Implementation of the desired features by the game studio, such as shop UI.
                    }
            } else {
                    // Error Handling
            }

    }];

import HIVEService
IAPV4Interface.getSubscriptionProductInfo { result, productInfoList, balance in
    if result.isSuccess() {
        // Implementation of the desired features by the game studio, such as shop UI.   
        productInfoList?.forEach { .. }
    } else {
        // Error Handling
    }
}

ซื้อผลิตภัณฑ์สมาชิก¶

เรียกใช้เมธอด purchaseSubscriptionUpdate() ของคลาส IAPV4 เพื่อขอซื้อการสมัครสมาชิกโดยใช้ MarketPid ที่ลงทะเบียนใน Apple App Store และ Google Play Store เป็นพารามิเตอร์

ต่อไปนี้คือตัวอย่างการใช้งานของ purchaseSubscriptionUpdate()

```unity linenums="1"
std::string marketPid = "{YOUR_PRODUCT_MARKET_PID}";
std::string oldMarketPid = "{YOUR_PRODUCT_OLD_MARKET_PID}";
std::string iapPayload = "{YOUR_PRODUCT_IAP_PAYLOAD}";

// คำขอเพื่อซื้อผลิตภัณฑ์การสมัครสมาชิก
IAPV4::purchaseSubscriptionUpdate(marketPid, oldMarketPid, iapPayload, [=](ResultAPI const & result, IAPV4Receipt const & receipt) {
        if (result.isSuccess()) {
                                // คำขอเพื่อยืนยันใบเสร็จด้วยใบเสร็จที่ได้รับ
        }
        else {
                // การจัดการข้อผิดพลาด
        }
});
```

```c++ linenums="1"
std::string marketPid = "{YOUR_PRODUCT_MARKET_PID}";
std::string oldMarketPid = "{YOUR_PRODUCT_OLD_MARKET_PID}";
std::string iapPayload = "{YOUR_PRODUCT_IAP_PAYLOAD}";

// การขอซื้อผลิตภัณฑ์สมาชิก
IAPV4::purchaseSubscriptionUpdate(marketPid, oldMarketPid, iapPayload, [=](ResultAPI const & result, IAPV4Receipt const & receipt) {
        if (result.isSuccess()) {
                                // การขอเพื่อตรวจสอบใบเสร็จด้วยใบเสร็จที่ได้รับ
        }
        else {
                // การจัดการข้อผิดพลาด
        }
});
```

val marketPid = "{YOUR_PRODUCT_MARKET_PID}"    
    val oldMarketPid = "{YOUR_PRODUCT_OLD_MARKET_PID}"    
    val iapPayload = "{YOUR_PRODUCT_IAP_PAYLOAD}"    


    // การขอซื้อผลิตภัณฑ์สมัครสมาชิก    
    IAPV4.purchaseSubscriptionUpdate(pid, oldMarketPid, iapPayload, object : IAPV4.IAPV4PurchaseListener {    
        override fun onIAPV4Purchase(result: ResultAPI, iapV4Receipt: IAPV4.IAPV4Receipt?) {    
            if (result.isSuccess()) {    
                    // การขอเพื่อยืนยันใบเสร็จด้วยใบเสร็จที่ได้รับ    
            } else {    
                   // การจัดการข้อผิดพลาด    
            }    
        }    
})

String marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    String oldMarketPid = "{YOUR_PRODUCT_OLD_MARKET_PID}";    
    String iapPayload = "{YOUR_PRODUCT_IAP_PAYLOAD}";    


    // ขอซื้อผลิตภัณฑ์สมาชิก    
    IAPV4.purchaseSubscriptionUpdate(pid, oldMarketPid, iapPayload, new IAPV4.IAPV4PurchaseListener() {    
        @Override    
        public void onIAPV4Purchase(ResultAPI result, IAPV4.IAPV4Receipt iapV4Receipt) {    
            if (result.isSuccess()) {    
                    // ขอให้ตรวจสอบใบเสร็จด้วยใบเสร็จที่ได้รับ    
            } else {    
                   // การจัดการข้อผิดพลาด    
            }    
        }    
});

let marketPid = "{YOUR_PRODUCT_MARKET_PID}"    
    let oldMarketPid = "{YOUR_PRODUCT_OLD_MARKET_PID}"    
    let iapPayload = "{YOUR_PRODUCT_IAP_PAYLOAD}"    

    // การขอซื้อผลิตภัณฑ์สมาชิก    
    HIVEIAPV4.purchaseSubscriptionUpdate(marketPid, oldMarketPid: oldMarketPid, iapPayload: iapPayload) { result, receipt in    
        if result.isSuccess() {    
            // การขอเพื่อยืนยันใบเสร็จด้วยใบเสร็จที่ได้รับ    
        } else {    
            // การจัดการข้อผิดพลาด    
        }    
}

NSString* marketPid = @"{YOUR_PRODUCT_MARKET_PID}";    
    NSString* oldMarketPid = @"{YOUR_PRODUCT_OLD_MARKET_PID}";    
    NSString* iapPayload = @"{YOUR_PRODUCT_IAP_PAYLOAD}";    

    // คำขอในการซื้อผลิตภัณฑ์สมาชิก    
    [HIVEIAPV4 purchaseSubscriptionUpdate:marketPid oldMarketPid:oldMarketPid iapPayload:iapPayload handler:^(HIVEResultAPI *result, HIVEIAPV4Receipt *receipt) {    
        if ([result isSuccess]) {    
                    // คำขอในการตรวจสอบใบเสร็จด้วยใบเสร็จที่ได้รับ    
        } else {    
                   // การจัดการข้อผิดพลาด    
        }    
}];

การกู้คืนสถานะการสมัครสมาชิก¶

หากการสมัครสมาชิกปัจจุบันไม่สามารถใช้งานได้บนอุปกรณ์ของผู้สมัครสมาชิก ให้ดำเนินการ restoreSubscription() ในคลาส IAPV4 เพื่อกู้คืนการสมัครสมาชิกและขอใบเสร็จสำหรับการสมัครสมาชิกที่เรียกเก็บเงิน

ต่อไปนี้คือตัวอย่างโค้ดในการ implement วิธีการ restoreSubscription()

using hive;    
    IAPV4.restoreSubscription((ResultAPI result, List<IAPV4Receipt> receiptList) => {    
    if (result.isSuccess()) {    
    // TODO: Request receipt verification using the received receiptList    
         }    
});

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::restoreSubscription([=](ResultAPI const & result, vector<reference_wrapper<IAPV4Receipt>> receiptList) {    
         if (result.isSuccess()) {    
    // TODO: Request receipt verification using the received receiptList    
         }    
});

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.restoreSubscription(object : IAPV4.IAPV4RestoreListener {    
         override fun onIAPV4Restore(result: ResultAPI, iapv4ReceiptList: ArrayList<IAPV4.IAPV4Receipt>?) {    
             if (result.isSuccess) {    
                 // TODO: Request receipt verification using the received iapv4ReceiptList    
             }    
         }    
})

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    IAPV4.INSTANCE.restoreSubscription((result, iapv4ReceiptList) -> {    
         if (result.isSuccess()) {    
             // TODO: Request receipt verification using the received iapv4ReceiptList    
         }    
});

import HIVEService    
    IAPV4Interface.restoreSubscription() { result, receiptList in    
    if result.isSuccess() {    
    // TODO: Request receipt verification using the received receiptList    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 restoreSubscription: ^(HIVEResultAPI *result, NSArray<HIVEIAPV4Receipt *> *receiptList) {    
         if ([result isSuccess]) {    
    // TODO: Request receipt verification using the received receiptList    
         }    
}];