การชำระเงิน PG

ต่อไปนี้คือ API การชำระเงิน PG ที่ต้องนำไปใช้ในเซิร์ฟเวอร์เกมเพื่อรองรับการชำระเงิน PG ในเกมที่ใช้ Windows OS สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการชำระเงิน PG ในสภาพแวดล้อม Windows โปรดตรวจสอบที่ ต่อไปนี้

ตรวจสอบประวัติการชำระเงิน¶

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

URL ที่ร้องขอ¶

Bearer token คือคีย์การรับรอง Hive ที่อยู่ใน แอปเซ็นเตอร์ > การจัดการโปรเจกต์ > เลือกเกมของผู้พัฒนา > รายละเอียดเกม > ข้อมูลพื้นฐาน

พารามิเตอร์คำขอ¶

องค์ประกอบการตอบกลับ¶

ตัวอย่างคำขอ¶

curl -L -v
 -d '{"appid" : "com.com2us.hivesdk.windows.microsoftstore.global.normal","market_id" : 15,"server_id" : "kr","user_id_type": "player_id", "user_id": 30000056996}' \
 -H "Content-Type: text/html" \
 -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY" \
 https://sandbox-hiveiap.qpyou.cn/api_v4/purchases/unconsumed

ตัวอย่างการตอบกลับ¶

{
        "result": 0,
        "result_msg": "SUCCESS",
        "unconsumed_lists": [
                {
                        "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
                        "order_id": "h2164792542890731850",
                        "server_id": "kr",
                        "vid": "30000056996",
                        "uid": "13079",
                        "amount": "1200",
                        "currency": "KRW",
                        "quantity": 1,            
                        "started_datetime": "2022-03-22 14:03:49",
                        "paid_datetime": "2022-03-22 14:04:39",
                        "market_id": "15",
                        "hiveiap_receipt": "2YnGzfTCGycoMjcSyYyNXBjANwmFyB6m\/c0bYazQ8VQ=",
                        "purchase_bypass_info": "eyJtYXJrZXRfcGlkIjoiY29tLmNvbTJ1cy5oaXZlc2R...",
                        "additionalInfo": null
                }
        ]
}

การตรวจสอบข้อมูลการชำระเงิน¶

API การตรวจสอบผลการชำระเงินอิงจาก IAP v4 การตรวจสอบใบเสร็จ

การตรวจสอบผลการชำระเงินจะใช้ purchase_bypass_info ที่ได้รับมาก่อนหน้านี้ purchase_bypass_info จะบรรจุข้อมูลต่างๆ ที่ได้รับผ่าน SDK ก่อนที่จะดำเนินการชำระเงิน และจะถูกส่งไปยัง Hive Analytics หากต้องการส่ง บันทึกยอดขาย พร้อมกับคำขอการตรวจสอบใบเสร็จ ให้ใช้ game_info ข้อมูล game_info ที่ได้รับจะทำหน้าที่ส่งบันทึกไปยังเซิร์ฟเวอร์การวิเคราะห์ของ Hive IAP

URL ที่ร้องขอ¶

Bearer โทเค็นคือรหัสการรับรองของ Hive ที่อยู่ใน แอปเซ็นเตอร์ > การจัดการโปรเจกต์ > เลือกเกมของผู้พัฒนาเกม > รายละเอียดเกม > ข้อมูลพื้นฐาน

พารามิเตอร์คำขอ¶

องค์ประกอบการตอบกลับ¶

รหัสการตอบกลับ¶

ตัวอย่างคำขอ¶

curl -L -v 
 -d '{"purchase_bypass_info":"eyJtYXJrZXRfaWQiOiIxNSIsIm9yZGVyX2lkIjoiSDMxNjQ3OTI1NDI4OTA3MzE4NTAiLCJtYXJrZXRfcGlkIjoiY29tLmNvbTJ1cy5oaXZlc2RrLndpbmRvd3MubWljcm9zb2Z0c3RvcmUuZ2xvYmFsLm5vcm1hbC5pdGVtMDEiLCJ2aWQiOiIzMDAwMDA1Njk5NiIsInVpZCI6IjEzMDc5Iiwic2VydmVyX2lkIjoia3IiLCJhcHBpZCI6ImNvbS5jb20ydXMuaGl2ZXNkay53aW5kb3dzLm1pY3Jvc29mdHN0b3JlLmdsb2JhbC5ub3JtYWwiLCJhbW91bnQiOiIxMjAwIiwic3RhcnRlZF9kYXRldGltZSI6bnVsbCwicGFpZF9kYXRldGltZSI6bnVsbCwiY3VycmVuY3kiOiJLUlciLCJoaXZlaWFwX3JlY2VpcHQiOiIyWW5HemZUQ0d5Y29NamNTeVl5TlhCakFOd21GeUI2bVwvYzBiWWF6UThWUT0ifQ=="}' 
 -H "Content-Type: text/html"
    -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY" \
 https://sandbox-hiveiap-verify.qpyou.cn/api_v4/verify

ตัวอย่างการตอบกลับ¶

{
        "result": 0,
        "result_msg": "success",
        "hiveiap_transaction_id": "HS_13",
        "hiveiap_market_id": 15,
        "hiveiap_market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
        "hiveiap_market_transaction_id": "h2164792542890731850",
        "hiveiap_receipt": null,
        "hiveiap_purchase_test": "N"
}

การประมวลผลผลลัพธ์การจ่าย¶

API การประมวลผลผลลัพธ์การจ่าย อิงจาก การส่งผลลัพธ์การจ่าย IAP v4

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

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

URL ที่ร้องขอ¶

Bearer token คือคีย์การรับรองของ Hive ที่สามารถหาได้จาก Hive Console > App Center > Project Management > เลือกเกมของผู้พัฒนา > รายละเอียดเกม > ข้อมูลพื้นฐาน

พารามิเตอร์คำขอ¶

องค์ประกอบการตอบกลับ¶

ตัวอย่างคำขอ¶

• การเรียก

curl -L -v
 -d '{"hiveiap_transaction_id" : "HS_13","result_status": 1,"user_id_type": "vid","user_id": 30000056996,"asset": [ {"asset_id":"item_id","asset_name":"item_name","quantity":1}
,{"asset_id":"item_id","asset_name":"item_name","quantity":1}]}' \
 -H "Content-Type: text/html" \
 -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY" \
 https://sandbox-hiveiap.qpyou.cn/api_v4/item_result

ตัวอย่างการตอบกลับ¶

{
        "result": 0,
        "result_msg": "success"
}

การแจ้งเตือนผลการชำระเงิน¶

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

คุณต้องตั้งค่า PG ที่จะใช้ใน [Hive Console](../../../operation/billing/pg_mangement/#ftoc-heading-6) ก่อนที่จะใช้ API นี้
เพื่อการตรวจสอบใบเสร็จและการมอบสินค้า แนะนำให้ใช้ API นี้หรือ API ตรวจสอบประวัติการชำระเงินเพียงหนึ่งในสองตัวเลือกนี้

ข้อกำหนดพื้นฐานในการส่งผลลัพธ์การชำระเงิน¶

ข้อมูลการส่งผลลัพธ์การชำระเงิน¶

ตัวอย่างการส่งผลการชำระเงิน (เมื่อชำระเงินเสร็จสิ้น)¶

{
        "type": "paid",
        "market_id": "15",
        "order_id": "H2168993822440686730",
        "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
        "vid": "20000011337",
        "uid": "67200717",
        "vid_type": "v4",
        "server_id": "kr",
        "appid": "com.com2us.hivesdk.windows.microsoftstore.global.normal",
        "amount": "1200",
        "started_datetime": "2023-07-21 20:17:06",
        "paid_datetime": "2023-07-21 20:18:13",
        "cancelled_datetime": null,
        "cancelled_reason": null,
        "currency": "KRW",
        "quantity": 1,    
        "additionalInfo": null,
        "hiveiap_receipt": "tJpwQSIlNFiCSPokHSRYTvTLmtbDiSZnkYa7+IWaMwM=",
        "purchase_bypass_info": "eyJ0eXBlIjoicGFpZCIsIm1hcmtldF9pZCI6IjE1Iiwib3JkZXJfaWQiOi..."
}

ตัวอย่างการส่งผลลัพธ์การชำระเงิน (เมื่อยกเลิกการชำระเงิน)¶

{
        "type": "cancelled",
        "market_id": "15",
        "order_id": "H2168993822440686730",
        "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
        "vid": "20000011337",
        "uid": "67200717",
        "vid_type": "v4",
        "server_id": "kr",
        "appid": "com.com2us.hivesdk.windows.microsoftstore.global.normal",
        "amount": "1200",
        "started_datetime": "2023-07-21 20:17:06",
        "paid_datetime": "2023-07-21 20:18:13",
        "cancelled_datetime": "2023-07-21 20:21:44",
        "cancelled_reason": "테스트 결제 취소",
        "currency": "KRW",
        "quantity": 1,    
        "additionalInfo": null,
        "hiveiap_receipt": "tJpwQSIlNFiCSPokHSRYTvTLmtbDiSZnkYa7+IWaMwM=",
        "purchase_bypass_info": "eyJ0eXBlIjoiY2FuY2VsbGVkIiwibWFya2V0X2lkIjoiMT..."
}