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

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

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

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

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

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

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

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

การซื้อ¶

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

การยกเลิก¶

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

การคืนเงิน¶

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

การฟื้นฟู¶

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

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

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

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

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

หยุด (Google)¶

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

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

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

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

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

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

แผนภาพ¶

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

Google subscription V2 support¶

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 มีประเภทการแสดงผลของตนเอง ลำดับของสัญลักษณ์สกุลเงินและราคาอาจแสดงผลแตกต่างกันในหลายประเทศขึ้นอยู่กับ OS
• ตรวจสอบให้แน่ใจว่าได้แสดงสัญลักษณ์สกุลเงินของแต่ละประเทศให้ตรงกับตารางของมัน อ้างอิงถึงนโยบาย 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
            }

    }];

สินค้าสมัครสมาชิก¶

เรียกใช้เมธอด 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    
         }    
}];