ดูรายการสินค้าและการซื้อ

ค้นหารายการสินค้า¶

เรียกใช้ API ค้นหารายการผลิตภัณฑ์เมื่อผู้ใช้เข้าสู่ร้านค้าในแอป หากผู้ใช้ขอรายการผลิตภัณฑ์ ให้ส่งคืนคลาส IAPV4Product พร้อมข้อมูลผลิตภัณฑ์

รายชื่อผลิตภัณฑ์และรายละเอียด¶

displayPrice¶

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

ในการค้นหารายการผลิตภัณฑ์ ให้เรียกใช้วิธี getProductInfo() ในคลาส IAPV4 เพื่อรับข้อมูลผลิตภัณฑ์ของรายการและยอดเงิน Lebi
ต่อไปนี้คือตัวอย่างโค้ดในการขอค้นหารายการผลิตภัณฑ์

using hive;    
    IAPV4.getProductInfo((ResultAPI result, List<IAPV4Product> productInfoList, int balance) => {    
         if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::GetProductInfo(FHiveIAPV4OnProductInfoDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<FHiveIAPV4Product>& ProductInfoList, uint32 Balance) {
        if (Result.IsSuccess()) {
                // call successful
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::getProductInfo([=](ResultAPI const & result, vector<IAPV4Product> const & productInfoList, unsigned int balance) {    
         if (result.isSuccess()) {    
         // call successful    
         }    
});

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.getProductInfo(object : IAPV4.IAPV4ProductInfoListener {    
         override fun onIAPV4ProductInfo(result: ResultAPI, iapV4ProductList: ArrayList<IAPV4.IAPV4Product>?, balance: Int) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.INSTANCE.getProductInfo((result, iapV4ProductList, balance) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    IAPV4Interface.getProductInfo() { result, productInfoList, balance in    
        if result.isSuccess() {    
            // call successful    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 getProductInfo: ^(HIVEResultAPI *result, NSArray<HIVEIAPV4Product *> *productInfoList, NSUInteger balance) {    
         if ([result isSuccess]) {    
            // call successful    
         }    
}];

การซื้อสินค้า¶

เรียกใช้เมธอด purchase() ในคลาส IAPV4 พร้อมกับ Market PID ซึ่งเป็นพารามิเตอร์ที่ลงทะเบียนใน Apple App Store และ Google Play Store เพื่อขอซื้อผลิตภัณฑ์ใน IAP v4.

ต่อไปนี้คือตัวอย่างโค้ดสำหรับการขอซื้อผลิตภัณฑ์.

using hive;    
    String marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    String iapPayload = "{YOUR_CUSTOM_PAYLOAD}";    

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

#include "HiveIAPV4.h"

FString MarketPid = TEXT("YOUR_PRODUCT_MARKET_PID");
FString IapPayload = TEXT("YOUR_CUSTOM_PAYLOAD");

FHiveIAPV4::Purchase(MarketPid, IapPayload, 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;    
    string marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    string iapPayload = "{YOUR_CUSTOM_PAYLOAD}";    
    IAPV4::purchase(marketPid, iapPayload, [=](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 marketPid = "{YOUR_PRODUCT_MARKET_PID}"    
    val iapPayload = "{YOUR_CUSTOM_PAYLOAD}"    
    IAPV4.purchase(marketPid, iapPayload, object : IAPV4.IAPV4PurchaseListener {    
         override fun onIAPV4Purchase(result: ResultAPI, iapV4Receipt: IAPV4.IAPV4Receipt?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    String marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    String iapPayload = "{YOUR_CUSTOM_PAYLOAD}";    
    IAPV4.INSTANCE.purchase(marketPid, iapPayload, (result, iapV4Receipt) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    let marketPid = "{YOUR_PRODUCT_MARKET_PID}"    
    let iapPayload = "{YOUR_CUSTOM_PAYLOAD}"    

    HIVEIAPV4.purchase(marketPid, iapPayload: iapPayload) { result, receipt in    
         if result.isSuccess() {    
             // TODO: Request verification of receipt with received receipt    
         }    
}

#import <HIVEService/HIVEService-Swift.h> 

NSString *marketPid = @"{YOUR_PRODUCT_MARKET_PID}";
NSString *iapPayload = @"{YOUR_CUSTOM_PAYLOAD}";

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

ใช้ iapPayload¶

เมื่อดำเนินการซื้อ (purchase()) หรือการสมัครสมาชิก (purchaseSubscription) บริษัทเกมสามารถส่ง iapPayload เป็นอาร์กิวเมนต์ iapPayload เป็นข้อมูลเมตาของการซื้อที่กำหนดโดยบริษัทเกม ตัวอย่างเช่น เมื่อผู้ใช้ซื้อผลิตภัณฑ์ อาจรวมถึงเวลาการซื้อ ข้อมูลผู้ใช้ที่ซื้อ ข้อมูลตัวละครเกมที่ซื้อ จำนวนที่ซื้อ (สินค้าที่ใช้แล้วหมดไป) โทเค็นการซื้อ เป็นต้น

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

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

ตั้งค่าปริมาณการซื้อของใช้ที่ใช้แล้วหมดไป¶

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

ข้อควรระวังก่อนเรียกใช้วิธี purchase()¶

• หากเกิดข้อผิดพลาด RESPONSE_FAIL หรือ CANCELED ขณะเรียกใช้เมธอด purchase() เนื่องจากปัญหาตลาด ให้แจ้งปัญหาแก่ผู้ใช้ว่ามีข้อผิดพลาดในกระบวนการซื้อ
• หากผู้ใช้ได้รับการแจ้งเตือนเกี่ยวกับปัญหาการซื้อเนื่องจากปัญหาตลาด ให้เรียกใช้เมธอด restore() เพื่อกู้คืนการซื้อ
• หากเกิดข้อผิดพลาด NEED_RESTORE ขณะเรียกใช้เมธอด purchase() การซื้อจะถูกยกเลิก เพื่อกู้คืนการซื้อ ให้เรียกใช้เมธอด restore()
• ในกรณีที่ระบบการเรียกเก็บเงินพยายามชำระเงินแบบออฟไลน์หรือเด็กขอให้พ่อแม่ชำระเงินแทนขณะเรียกใช้เมธอด purchase() จะมีการส่งข้อผิดพลาด ITEM_PENDING และรายการจะอยู่ในสถานะรอดำเนินการ การซื้อแทนของพ่อแม่ได้รับการสนับสนุนสำหรับ Google Play Store, Amazon และ Apple App Store
• หากชำระเงินแบบออฟไลน์สำเร็จหรือพ่อแม่ชำระเงินแทนลูกของตน IAP_UPDATED เหตุการณ์จะถูกส่งผ่าน UserEngagement เมื่อพารามิเตอร์ถูกส่งกลับผ่านการเรียกกลับ eventEnd ของ UserEngagement ให้เรียกใช้ restoreSubscription() หาก type เป็น "subscription" หรือเรียกใช้ restore() หาก type ว่าง สลิปที่เสร็จสมบูรณ์สามารถตรวจสอบได้โดยการเรียกใช้วิธีเหล่านี้
• เพื่อแก้ไขข้อผิดพลาด NOT_SUPPORTED ที่แจ้งว่าการซื้อไม่สามารถใช้ได้ ให้ดูที่ คู่มือสำหรับวลีในการจำกัดการซื้อในแอป
• เมื่อทำการซื้อผ่าน HIVESTORE ในสภาพแวดล้อมเดสก์ท็อป หน้าจอคำขอชำระเงินจะแสดงในหน้าต่างใหม่

การเรียก hive.IAPV4.purchase(marketPid, null, onIAPV4PurchaseCB); จะส่งคืนการตอบสนองทันทีพร้อมกับ ErrorCode:IAPSUCCESS=90 และ Code:IAPV4HiveStoreSuccess=-6110000 โดยไม่มีข้อมูลใบเสร็จ ผ่าน onIAPV4PurchaseCB ขึ้นอยู่กับ ErrorCode (หรือ Code) สามารถแสดงข้อความแนะนำเกี่ยวกับสถานะของความมีสิทธิ์ในการแจกจ่ายสินค้าได้

• สำหรับแอป Windows บน Google Play (Hive SDK v4 Unity Windows 23.0.0 หรือสูงกว่า) ที่ใช้ตลาด GOOGLE\_PLAYSTORE หากข้อมูลการตรวจสอบสิทธิ์ของบัญชี Google ที่ใช้ในการชำระเงินหมดอายุ Hive SDK จะดำเนินการกระบวนการตรวจสอบสิทธิ์ใหม่โดยอัตโนมัติ
• สำหรับแอป Windows บน Google Play (Hive SDK v4 Unity Windows 23.0.0 หรือสูงกว่า) ที่ใช้ตลาด GOOGLE\_PLAYSTORE เมื่อผู้ใช้กดปุ่มยืนยันบนป๊อปอัพการรอการชำระเงินที่แสดงในแอป และการชำระเงินยังไม่ได้รับการยืนยัน จะมีการส่งคืนการตอบกลับที่มี ErrorCode:IAPSUCCESS=90 และ Code:IAPV4PendingPurchase=-6100013 ผ่าน onIAPV4PurchaseCB การตอบกลับนี้ไม่ได้หมายความว่าการชำระเงินล้มเหลว แต่หมายถึงว่าการชำระเงินไม่สามารถยืนยันได้เนื่องจากข้อผิดพลาดภายใน หรือผู้ใช้เพียงแค่ไม่ได้ทำการชำระเงิน ในกรณีนี้จะไม่มีใบเสร็จส่งคืน และหากผู้ใช้ได้ทำการชำระเงินในหน้าต่างเบราว์เซอร์การชำระเงิน ใบเสร็จสามารถรับได้ผ่าน IAPV4.restore

รหัสข้อผิดพลาดในการซื้อ¶

วลีที่ต้องจำกัดในการซื้อในแอป¶

วลีเพื่อแจ้งนโยบายการถอนการซื้อ¶

ตามพระราชบัญญัติการส่งเสริมอุตสาหกรรมเนื้อหา Content Industry Promotion Act กรุณาเปิดเผยประกาศเกี่ยวกับการถอนการซื้อและลิงก์ไปยังนโยบายการถอนการซื้อของคุณในร้านเกมของคุณ สำหรับ iOS หากมีการเปิดเผยประกาศเกี่ยวกับการถอนการซื้อในระหว่างกระบวนการตรวจสอบของ Apple ในแอปของคุณ อาจเป็นเหตุผลในการปฏิเสธการตรวจสอบเกมของคุณ