การชำระเงิน PG แบบเรียกเก็บซ้ำ¶
"PG prilmentment" หมายถึง เมื่อผู้ใช้ทําการลงทะเบียนวิธีการชําระเงินในกล่องชําระเงิน PG เซิร์ฟเวอร์แอพจะร้องขอเงินจากวิธีการชําระเงินนั้นในเวลาที่เหมาะสมกับพวกเขา มี การ ใช้ ยา นี้ เพื่อ จ่าย เป็น ระยะ ๆ สําหรับ ผลิตภัณฑ์ เดียว กัน เช่น ผลิตภัณฑ์ ปริมาณ ต่อ เดือน.
เอกสารนี้อธิบายกระบวนการ integration ของ 'PG regressment' และวิธีการใช้ API เพื่อเรียกจากเซิร์ฟเวอร์โปรแกรม เอพีไอหลักอยู่ด้านล่าง
- ดูรายการวิธีการจ่ายเงินตั้งค่าโครงการ
- การลงทะเบียนสมาชิกหน้าลงทะเบียนและชําระเงินเพื่อชําระเงินครั้งแรก
- ชาร์จซ้ําแปรงทาสี
- สิ้นสุดHOURSฟังก์ชัน
ภาพรวม¶
วงจรการเรียกเก็บเงินและช่วงต่างๆ ถูกจัดการโดยเซิร์ฟเวอร์แอพ แม่ข่ายบริการ App ต้องร้องขอการชําระสําหรับระยะเวลาของผลิตภัณฑ์ และรังผึ้งจะไม่จ่ายโดยอัตโนมัติในวันที่กําหนด
รองรับ PGs และวิธีการชําระเงิน มีรายการด้านล่างนี้ จะไม่มีรายการ PGs และวิธีการผ่อนส่งอยู่ในรายการการชําระเงินซ้ําเมื่อเชื่อมต่อกับคอนโซลแบบ Hive
- คาคาโอะ เพย์: คาคาโอะ จ่ายเงินอย่างง่าย
- แดน: บัตร เครดิต
- ค่าใช้จ่ายวอลล์: บัตรเครดิตระหว่างประเทศ; อีเมล์ของผู้ซื้อต้องการลงทะเบียน
- NHN KCP: บัตรเครดิต
ขั้นตอนการเชื่อมต่อ¶
แม่ข่ายบริการ App จะตรวจสอบและลงทะเบียนวิธีการชําระเงินของคุณสําหรับการชําระเงินครั้งแรก เมื่อมีการชําระเงินแล้ว เซิร์ฟเวอร์ไฮฟ์จะส่งการแจ้งเตือนการชําระเงินไปยังเซิร์ฟเวอร์โปรแกรม เพื่อแจ้งให้ทราบถึงผลของการชําระเงิน เซิร์ฟเวอร์ App เก็บorder_idจากการประกาศการชําระเงินครั้งแรก เป็นหมายเลขลําดับที่ออกมา ซึ่งใช้สําหรับการเรียกเก็บเงินซ้ํา และยกเลิกการร้องขอ
โพรเซสการชําระเงินของ PG ที่ทําบนเซิร์ฟเวอร์ App จะทํางานต่อไป
- แสดงวิธีจ่ายเงินของผู้ใช้ด้วยการร้องขอรายการวิธีการจ่ายเงินจากเซิร์ฟเวอร์แอพ
- ร้องขอการลงทะเบียนการจ่ายเงินซ้ําด้วยวิธีผลิตภัณฑ์และวิธีชําระเงินที่ถูกเลือกโดยผู้ใช้
- แสดงหน้าการชําระเงิน HTML ที่ได้รับจากการลงทะเบียนในมุมมองเว็บ หรือเว็บเบราว์เซอร์ของคุณ 4 เก็บ
order_idของการแจ้งเตือนการชําระเงินจากเซิร์ฟเวอร์ Hive เมื่อผู้ใช้ทําการลงทะเบียนวิธีการชําระเงินและการชําระเงินครั้งแรกเสร็จสมบูรณ์ 5 กรุณาใช้order_idคุณบันทึกไว้ที่เช็คเอาท์ครั้งต่อไปคืนค่าเดิมด้วยตัวเลขวงจรค่าใช้จ่ายของคุณ - การชําระเงินจากผลิตภัณฑ์ของโพรเซส อาศัยการแจ้งการชําระเงินหนึ่งครั้ง 7 ถามยกเลิกเมื่อคุณจบการจ่ายเงินซ้ํา
หลังจากยกที่สอง หมายเลขลําดับของคุณจะถูกส่งต่อไป การตอบรับค่าใช้จ่ายที่เกิดขึ้นซ้ํา ๆ และการแจ้งเตือนการชําระเงินเป็นครั้งที่สอง เชื่อมต่อและจัดการหมายเลขลําดับเริ่มต้นของคุณ และหมายเลขลําดับในเซิร์ฟเวอร์โปรแกรม
หากผู้ใช้ปิดหน้าทําการชําระเงิน หรือไม่สามารถทําการล็อกอินได้ เซิร์ฟเวอร์ไฮฟ์จะไม่ส่งการแจ้งเตือนการชําระเงิน
การเตรียมล่วงหน้า¶
ตั้งค่าวิธีการชําระเงินของคุณและที่อยู่ URL แจ้งเตือนการชําระเงินในคอนโซล Hive ก่อนจะเรียก API หากคุณได้ติดตั้งกุญแจรักษาความปลอดภัยในโปรแกรมของคุณ นอกจากนี้คุณจะต้องเตรียมเครื่องหมายการตรวจสอบสิทธิ์
เชื่อมต่อวิธีการชำระเงิน¶
เชื่อมต่อวิธีการจ่ายเงินซ้ําของคุณไปยังโปรแกรมจากคอนโซล Hive ดูตั้งค่า PGสําหรับคําแนะนําว่าจะตั้งมันยังไง
ตั้งค่า URL แจ้งผลการชำระเงิน¶
ล็อกอินที่อยู่ URL ของเซิร์ฟเวอร์โปรแกรมเพื่อรับผลการจ่ายเงินแก้ไขโครงการหลัก... ตั้งค่าต่าง ๆ ของบิลลิงส์ > ตั้งค่าต่าง ๆ ของ PG > การตั้งค่าเพิ่มเติมใช้การตั้งค่าเดียวกันกับการจ่ายเงิน PG ปกติ ดูตั้งค่าการแจ้งให้ทราบของ PGสําหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการตั้งค่านี้
เตรียมโทเค็นการยืนยันตัวตน¶
หากคุณได้ตั้งค่ากุญแจรักษาความปลอดภัยในแอพนี้ คุณสามารถเข้าถึงได้โดยกําลังออก OAUTL TOKรวมสัญลักษณ์นี้ในX-Access-Tokenในส่วนหัวร้องขอเมื่อเรียก API
คำขอและการตอบกลับทั่วไป¶
API ทั้งหมดใช้POSTวิธีการและร่างกายร้องขอในรูปแบบ Json ยังไม่รองรับการส่งแบบฟอร์ม ทําการร้องขอโดยนําหน้าเส้นทางของ API แต่ละ กับโฮสต์ของสภาพแวดล้อมที่คุณต้องการใช้
- เจ้าภาพ:
https://hiveiap.qpyou.cn - เจ้าภาพทราย:
https://sandbox-hiveiap.qpyou.cn
Request header¶
ฟอร์แมตร่างกายที่ต้องการเป็นContent-Type. เดอะX-Access-Tokenการตรวจสอบก็ต่อเมื่อคุณมีกุญแจรักษาความปลอดภัยในแอพของคุณ
| ช่องข้อมูล | ชนิด | ต้องการ? | คําอธิบาย |
|---|---|---|---|
Content-Type | ข้อความ | ต้องการ | application/json |
X-Access-Token | ข้อความ | ต้องการเงื่อนไขต่าง ๆ | เข้าใช้ OAuth 2. 0 จําเป็นต้องใช้ ถ้าคุณได้ตั้งกุญแจนิรภัยในแอพของคุณ |
การระบุผู้ใช้¶
เมื่อร้องขอคิดเงินซ้ํา หรือยกเลิกข้อมูลของผู้ใช้ที่ลงทะเบียนการชําระเงินซ้ํา ต้องมีการติดต่อไป เซิร์ฟเวอร์ Hive ใช้player_typeถึงplayer_idด้วยกันเพื่อระบุตัวคุณ
ถ้าplayer_typeคือv4ผ่านหมายเลขผู้เล่นไฮฟ์vidถึงplayer_id. ถ้าv0ส่งต่อข้อมูลสมาชิกของไฮฟ์uid. player_typeมันมีค่าเท่ากับvid_typeในการแจ้งเตือนการชําระเงิน
player_idต้องเป็นข้อความตัวเลขที่มีค่าเป็น 1 หรือมากกว่า ถ้าค่าไม่เป็นอนันต์ผ่าน10010002คืนค่ากลับมาเป็น
Response body¶
สําเร็จ หากcodeในการตอบสนอง Json คือสตริง"0"เกิดความผิดพลาดขึ้นกับรหัสสถานะ HTTP200ลองเช็คดูสิcodeในศพ การตรวจสอบสิทธิ์ล้มเหลว401.
ถ้าการจดทะเบียนที่ซ้ํากันประสบความสําเร็จ หน้าการชําระเงิน HTML จะถูกคืนแทนที่จะเป็น Json ดูการเรียกโปรแกรม.
| ช่องข้อมูล | ชนิด | รวมการตอบกลับด้วย | คําอธิบาย |
|---|---|---|---|
code | ข้อความ | เจ สัน ตอบ โต้ | รหัสผลลัพธ์"0"ประสบความสําเร็จ เห็นรหัสผิดพลาดสําหรับค่าอื่น |
message | ข้อความ | เจ สัน ตอบ โต้ | ข้อความผิดพลาดภายในคือInternal server error |
ตัว อย่าง ของ การ ตอบ สนอง ความ สําเร็จ โดย ทั่ว ไป มี ดัง นี้:
= "เจสัน"
```json
{ "code": "0", "message": "SUCCESS" }
```
API เรียกดูรายการวิธีการชำระเงิน¶
ดูวิธีการจ่ายเงินของคุณสําหรับการชําระเงินซ้ํา แสดงวิธีการจ่ายเงินตามลําดับของลําดับของรายการในมุมมอง, และส่งผู้ระบุรายการที่เลือกจากผู้ใช้ไปยังการร้องขอการลงทะเบียนที่ซ้ํากัน
Request info¶
เส้นทางที่ร้องขอ/v2/payment/recurring/methods...วิธีร้องขอและอนุมัติส่วนหัวตามการร้องขอและการตอบสนองทั่วไป.
- ที่อยู่ URL ที่ขยาย:
https://hiveiap.qpyou.cn/v2/payment/recurring/methods - ที่อยู่ URL:
https://sandbox-hiveiap.qpyou.cn/v2/payment/recurring/methods
Request body¶
ราคาที่แพงที่สุด คือราคาต่อประกัน คุณตั้งสําหรับสินค้าของคุณ หากคุณกําหนดmarket_pidมันจะคืนเฉพาะวิธีชําระเงินที่สามารถจ่ายได้ในสกุลเงิน ด้วยราคาที่เสมอกันที่ตั้งค่าสําหรับผลิตภัณฑ์
ถ้าcountryไม่ได้รับการยกเลิก ประเทศถูกกําหนดโดย IP ของแม่ข่ายที่ร้องขอมา จึงขอแนะนําให้ส่งต่อรหัสประเทศของผู้ใช้
| ช่องข้อมูล | ชนิด | ต้องการ? | คําอธิบาย |
|---|---|---|---|
appid | ข้อความ | ต้องการ | หมายเลข App |
market_pid | ข้อความ | เลือก | บัตรประชาชน ใช้เพื่อกรองวิธีการชําระเงินโดยเงินตราที่ราคาขอบของผลิตภัณฑ์อยู่ |
country | ข้อความ | ตัวเลือกการเลือก | รหัสประเทศผู้ใช้ รูปแบบ ISO 3166-1 อัลฟา-2 |
language | ข้อความ | เลือก | วิธีการชําระเงิน แสดงภาษาชื่อ ค่าปริยายen |
ข้าง ล่าง นี้ เป็น กาย ของ คํา ขอ ที่ จะ ตรวจ สอบ วิธี จ่าย ของ ผลิตภัณฑ์item08สําหรับผู้ใช้เกาหลี
= "เจสัน"
```json
{ "appid": "com.com2us.example.normal.freefull.google.global.android.common", "market_pid": "item08", "country": "KR", "language": "ko" }
```
Response body¶
การตอบสนองที่ประสบความสําเร็จมีสนามตอบสนองทั่วไปและเป็นกลุ่มชนจํานวนน้อยpayment_methods. แต่ละรายการในอาร์เรย์เป็นข้อมูลวิธีการชําระเงินของ PG
| ช่องข้อมูล | ชนิด | ตําแหน่งรวม | คําอธิบาย |
|---|---|---|---|
payment_methods | อาร์เรย์ | ร่าง กาย ที่ ฟื้น ตัว | รายการวิธีจ่ายเงินสําหรับการชําระเงินซ้ํา แสดงผลลําดับ |
agency_id | จํานวนเต็ม | payment_methods[] | เครื่องตรวจจับ PG ส่งต่อการร้องขอลงทะเบียนตรงกับที่มันเป็น |
agency_code | ข้อความ | payment_methods[] | รหัส PGkakaopay, danal_tpay, paymentwall, kcp_billing |
agency_name | ข้อความ | payment_methods[] | ชื่อ PG |
pay_method | ข้อความ | payment_methods[] | วิธีชําระหนี้kakaopay, card |
payment_method_id | จํานวนเต็ม | payment_methods[] | ตัวระบุวิธีการชําระเงิน ร้องขอการชําระเงินซ้ําไปมาว่า |
payment_method_name | ข้อความ | payment_methods[] | แสดงชื่อตามวิธีการชําระเงินlanguage |
icon_url | ข้อความ | payment_methods[] | ที่อยู่ URL ของไอคอนสําหรับจ่าย |
currency | ข้อความ | payment_methods[] | เงินตราที่ต้องจ่าย |
ข้าง ล่าง นี้ เป็น ตัว อย่าง ของ การ ตอบ สนอง วิธี ชําระ เงิน คืน ของ คา เกา.https://…ในicon_urlเป็นสัญลักษณ์ที่ไม่สนใจที่อยู่ URL จริง
= "เจสัน"
```json
{
"code": "0",
"message": "SUCCESS",
"payment_methods": [
{ "agency_id": 3, "agency_code": "kakaopay", "agency_name": "카카오페이", "pay_method": "kakaopay",
"payment_method_id": 472, "payment_method_name": "카카오페이", "icon_url": "https://…", "currency": "KRW" }
]
}
```
ผลตอบแทน10010003หากไม่พบโปรแกรมหรือรายการ หรือตรวจสอบรายการที่อยู่นอกช่อง หากไม่มีวิธีการชําระเงินซ้ําที่ตรงกับ มาตราฐานของประเทศและผลิตภัณฑ์10010005จะถูกส่งคืน
API ลงทะเบียนการชำระเงินแบบเรียกเก็บซ้ำ¶
มันร้องขอการชําระเงินหน้า HTML เพื่อให้ผู้ใช้สามารถลงทะเบียนวิธีการชําระเงินได้ และดําเนินการในการชําระเงินครั้งแรก เซิร์ฟเวอร์ App จะยังคงแสดง HTML ที่ได้รับในมุมมองเว็บ หรือเว็บเบราว์เซอร์ของคุณ
หลัง จาก ทํา การ จด ทะเบียน ใน หน้า จ่าย เงิน แล้ว คุณ จะ เห็น จอ ที่ ทํา ให้ มี ความ สุข. ผลของการจ่ายเงินแรกจะถูกส่งต่อไปยังเซิร์ฟเวอร์โปรแกรมเป็นการแจ้งเตือนการจ่ายเงิน
Request info¶
เส้นทางที่ร้องขอ/v2/payment/recurring/register...วิธีร้องขอและอนุมัติส่วนหัวตามการร้องขอและการตอบสนองทั่วไป.
- ที่อยู่ URL ที่ขยาย:
https://hiveiap.qpyou.cn/v2/payment/recurring/register - ที่อยู่ URL:
https://sandbox-hiveiap.qpyou.cn/v2/payment/recurring/register
Request body¶
ค้น ดู วิธี จ่าย เงิน รวม ถึงmarket_pidและส่งต่อagency_idถึงpayment_method_idรวม อยู่ ใน การ ตอบ รับ.countryควร จะ ให้ ค่า เท่า กับ เมื่อ ตรวจ ดู ราย ชื่อ.
| ช่องข้อมูล | ชนิด | ต้องการ? | คําอธิบาย |
|---|---|---|---|
appid | ข้อความ | ต้องการ | หมายเลข App |
market_pid | ข้อความ | ต้องการ | ID ของผลิตภัณฑ์ที่จะสมัครรับ ใช้สินค้าเดียวกันในวงจรการเรียกเก็บเงินทั้งหมด |
server_id | ข้อความ | ต้องการ | ID ของเซิร์ฟเวอร์ App, เพื่อใช้สื่อสารในใบแจ้งหนี้ของทุกเวลา |
player_id | ข้อความ | ต้องการ | ID ของผู้ใช้ ดูระบุผู้ใช้ |
player_type | ข้อความ | ต้องการ | ชนิดของผู้ใช้v4หรือv0 |
agency_id | จํานวนเต็ม | ต้องการ | ตัวระบุค่า PG สําหรับรายการวิธีการชําระเงินแบบสอบถาม |
payment_method_id | จํานวนเต็ม | ต้องการ | ตัวระบุวิธีชําระเงินสําหรับรายการวิธีการชําระเงิน |
email | ข้อความ | ต้องการเงื่อนไขต่าง ๆ | อีเมล์ของผู้ซื้อ ผนังสําหรับชําระเงินไม่ต้องการ PGs อื่น ๆ |
iap_payload | ข้อความ | เลือก | ข้อมูลเพิ่มเติมที่จะส่งไปยังแม่ข่ายโปรแกรม จะถูกสื่อสารในใบแจ้งหนี้สําหรับรอบการเรียกเก็บเงินทั้งหมด และไม่สามารถเปลี่ยนเป็นการร้องขอค่าใช้จ่ายที่เกิดขึ้นซ้ําได้ |
country | ข้อความ | ตัวเลือกการเลือก | รหัสประเทศของผู้ใช้ มันควรจะเหมือนกับค่าที่ผ่านเมื่อค้นรายการแล้ว และถ้าตัดออกไป มันจะถูกกําหนดโดย IP ของเซิร์ฟเวอร์ที่ร้องขอ |
language | ข้อความ | เลือก | ภาษาของหน้าจ่ายเงินและหน้าจอผลลัพธ์ ค่าปริยายen |
ข้างล่างเป็นศพที่คุณขอลงทะเบียน สําหรับการชําระเงินซ้ํา ๆ ด้วยเงินคาเกา
= "เจสัน"
```json
{
"appid": "com.com2us.example.normal.freefull.google.global.android.common",
"market_pid": "item08", "server_id": "kr",
"player_id": "20000032552", "player_type": "v4",
"agency_id": 3, "payment_method_id": 472,
"iap_payload": "{\"character\":\"abc\"}",
"country": "KR", "language": "ko"
}
```
Response body¶
กรุณาตรวจสอบContent-Typeในส่วนหัวตอบรับ เนื่องจากรูปแบบการตอบสนองที่แตกต่างกัน ขึ้นอยู่กับความสําเร็จของการร้องขอลงทะเบียน โปรแกรมจะกําหนดสิ่งที่ผู้ใช้ข้อความจะเห็น เมื่อการร้องขอล้มเหลว
| ผลลัพธ์ | รหัสสถานะ HTTP | ประเภทเนื้อหา | การ ใช้ มือ อย่าง ไม่ หยุด ยั้ง |
|---|---|---|---|
| สําเร็จ | 200 | text/html | แสดงหน้าการจ่ายเงินแบบ HTML ว่าเป็นของผู้ใช้ |
| ล้มเหลว | 200 | application/json | ยืนยันcodeถึงmessageของคําตอบทั่วไป |
ด้านล่างนี้เป็นการตอบสนองเมื่ออีเมลหายไปจากการร้องขอการรับสมัครเดือน
= "เจสัน"
```json
{ "code": "10010003", "message": "email is required for paymentwall" }
```
การประมวลผลการลงทะเบียน¶
การชําระเงินครั้งแรกเป็นราคาสินค้าที่ตรงตามเวลาลงทะเบียน กําหนดราคาในเงินตราของวิธีการจ่ายเงินที่เลือก
จะให้มีการชําระเงินซ้ําทุกครั้งที่คุณร้องขอลงทะเบียน หากผู้ใช้ปิดหน้าทําการชําระเงิน การชําระเงินที่เกิดขึ้นซ้ําจะยังไม่สมบูรณ์ และพวกเขาก็จะไม่สามารถร้องขอค่าชดเชยซ้ําได้
หลังจากชําระเงินครั้งแรกแล้ว เซิร์ฟเวอร์ Hive จะส่งการแจ้งเตือนการชําระเงินมาด้วยtypeถึงpaidเก็บ...order_idการแจ้งเตือนนี้เป็นการแจ้งหมายเลขลําดับ
ถ้าคุณได้รับ10010005เกิดข้อผิดพลาด โปรดกลับไปทํารายการวิธีการจ่ายเงินของคุณรวมถึงmarket_pidและร้องขอด้วยวิธีการชําระเงิน ที่รวมอยู่ในการตอบสนองของคุณ ดูรหัสผิดพลาดสําหรับ ข้อมูล เพิ่ม เติม เกี่ยว กับ วิธี รับมือ กับ ความ ผิด พลาด.
API เรียกเก็บเงินครั้งถัดไป¶
เราจะขอจ่ายหลังจากจ่ายเงินครั้งที่สอง ให้วิธีชําระเงินของคุณในไฟล์ การตอบรับที่ประสบความสําเร็จ คือใบเสร็จรับเงิน การอนุมัติของ PG รุ่นหลัง ๆ เช่น ผนังการชําระเงิน อาจส่งผลให้มีการอนุมัติหลังจากการตอบรับที่ประสบความสําเร็จ และเมื่ออนุมัติแล้ว เซิร์ฟเวอร์ Hive จะส่งการแจ้งเตือนการจ่ายเงิน
Request info¶
เส้นทางที่ร้องขอ/v2/payment/recurring/charge. วิธีการร้องขอและส่วนหัวการตรวจสอบสิทธิ์ต่อไปนี้การร้องขอและการตอบสนองทั่วไป.
- ที่อยู่ URL ที่ขยาย:
https://hiveiap.qpyou.cn/v2/payment/recurring/charge - ที่อยู่ URL:
https://sandbox-hiveiap.qpyou.cn/v2/payment/recurring/charge
Request body¶
order_idจะทําการส่งต่อหมายเลขลําดับที่ออกจากการแจ้งการชําระเงินครั้งแรกsequenceเป็นกุญแจสํารองที่แยกวงจรการเรียกเก็บเงินภายในการชําระเงินซ้ําเดียวกัน และป้องกันค่าใช้จ่ายซ้ําเมื่อ ลองวงจรการเรียกเก็บเงินเดียวกัน
| ช่องข้อมูล | ชนิด | ต้องการ? | คําอธิบาย |
|---|---|---|---|
appid | ข้อความ | ต้องการ | App ID ของแอพที่คุณลงทะเบียน |
order_id | ข้อความ | ต้องการ | ลําดับปัญหา ไม่order_idการแจ้งเตือนการชําระเงินครั้งที่ 1 |
sequence | จํานวนเต็ม | ต้องการ | ตัวเลขวงจรค่าใช้จ่าย มันเป็นค่าของ 2 หรือมากกว่า และค่าเดียวกันเมื่อลองซ้ํารอบเดียวกัน |
player_id | ข้อความ | ต้องการ | หมายเลขผู้ใช้ที่ลงทะเบียนไว้ |
player_type | ข้อความ | ต้องการ | ชนิดของผู้ใช้ที่ลงทะเบียนไว้ |
ข้าง ล่าง นี้ เป็น ข้อ ที่ ขอ ให้ จ่าย เงิน ราย ที่ สอง โดย ออก หมาย เลข ลําดับ.
= "เจสัน"
```json
{ "appid": "com.com2us.example.normal.freefull.google.global.android.common",
"order_id": "H4179125520850787386", "sequence": 2,
"player_id": "20000032552", "player_type": "v4" }
```
Response body¶
การตอบสนองที่ประสบความสําเร็จจะรวมถึงสนามตอบรับทั่วไป และจํานวนลําดับของวงจรการเรียกเก็บเงินนี้ กรุณาเชื่อมโยงตัวเลขนี้เข้ากับวงจรค่าใช้จ่ายนี้ที่จะบันทึก
| ช่องข้อมูล | ชนิด | รวมการตอบกลับด้วย | คําอธิบาย |
|---|---|---|---|
order_id | ข้อความ | การตอบกลับที่ประสบความสําเร็จ | ลําดับของวงจรการเรียกเก็บเงินนี้ เช่นorder_idสําหรับใบแจ้งหนี้และใบแจ้งหนี้ |
ด้านล่างนี้เป็นการตอบสนองที่ประสบความสําเร็จ ซึ่งจะคืนค่ากลับมาเป็นหมายเลขลําดับที่สอง
= "เจสัน"
```json
{ "code": "0", "message": "SUCCESS", "order_id": "H5179125523990923210" }
```
เงื่อนไขและการลองเรียกเก็บเงินใหม่¶
คุณ จะ จ่าย ด้วย ผลิตภัณฑ์ ที่ ระบุ ไว้ ใน เวลา ที่ มี การ จด ทะเบียน เงิน คืน ซ้ํา. ตัวเลขวงจรการเรียกเก็บเงินถูกจัดการโดยเซิร์ฟเวอร์แอพ และรังผึ้งไม่ตรวจสอบรอบการเรียกเก็บเงินติดต่อกัน
ถ้าคุณหยุดขายรายการ เราจะดําเนินการเรียกเก็บเงินซ้ํา ๆ เพื่อชําระเงินซ้ํา ๆ ที่ได้ลงทะเบียนไว้แล้ว หยุดขายเฉพาะการลงทะเบียนใหม่เท่านั้น อย่ายื่นฟ้องซ้ําเพื่อหยุดการเรียกเก็บเงิน
เมื่อร้องขออีกครั้งsequenceการประมวลผลเป็นดังต่อไปนี้
| สถานะซ้ํา | ปฏิกิริยา | ชาร์จเพิ่มเติม | ประมวลผลเซิร์ฟเวอร์ App |
|---|---|---|---|
| จ่าย | 10010007 | ไม่มี | ไม่สนใจการร้องขอซ้ําที่พวกเขาได้รับชําระแล้วสําหรับเวลา |
| การ เห็น ชอบ | การตอบรับที่สําเร็จก็เช่นเดียวกันorder_id | ไม่มี | การจ่ายสินค้าตามการแจ้งการชําระเงิน |
| การร้องขอถ่ายโอนล้มเหลว | ผลการชําระเงิน | การ จ่าย คืน | ลองใหม่อีกครั้งsequence |
คืนเหตุผลสําหรับความล้มเหลวของ PGmessageด้วย10010024ในกรณีที่การอนุมัติของ PG ล้มเหลว โปรดแนะนําผู้ใช้ให้ยืนยันวิธีการจ่ายเงินแล้วลองใหม่อีกครั้งsequenceข้อผิดพลาดภายใน:10010001, 10010004และ10010022และ (มะลาอิกะฮฺ) ผู้ควบคุมอย่างรัดกุมsequence.
API ยกเลิกการชำระเงินแบบเรียกเก็บซ้ำ¶
เมื่อคุณยกเลิกการชําระเงินที่ซ้ํากัน เซิร์ฟเวอร์ Hive จะลบวิธีชําระเงินที่ลงทะเบียนไว้ด้วยการชําระเงินซ้ํา10010023ฟังก์ชัน EXACT () จะคืนค่ากลับมาเป็นค่า True
Request info¶
เส้นทางที่ร้องขอ/v2/payment/recurring/cancel. วิธีการร้องขอและส่วนหัวการตรวจสอบสิทธิ์ต่อไปนี้การร้องขอและการตอบสนองทั่วไป.
- ที่อยู่ URL ที่ขยาย:
https://hiveiap.qpyou.cn/v2/payment/recurring/cancel - ที่อยู่ URL:
https://sandbox-hiveiap.qpyou.cn/v2/payment/recurring/cancel
Request body¶
ตั้งค่าลําดับของการจ่ายเงินที่ซ้ํากันที่คุณต้องการจะยุติ เช่นเดียวกับข้อมูลโปรแกรมและผู้ใช้ที่คุณลงทะเบียนไว้ หมายเลขลําดับไม่สามารถยกเลิกได้หลังจากยกที่สอง
| ช่องข้อมูล | ชนิด | ต้องการ? | คําอธิบาย |
|---|---|---|---|
appid | ข้อความ | ต้องการ | App ID ของแอพที่คุณลงทะเบียน |
order_id | ข้อความ | ต้องการ | ลําดับปัญหา ไม่order_idการแจ้งเตือนการชําระเงินครั้งที่ 1 |
player_id | ข้อความ | ต้องการ | หมายเลขผู้ใช้ที่ลงทะเบียนไว้ |
player_type | ข้อความ | ต้องการ | ชนิดของผู้ใช้ที่ลงทะเบียนไว้ |
ข้าง ล่าง นี้ เป็น ร่าง กาย ของ คุณ ที่ ขอ ยก เลิก การ ชําระ เงิน ที่ เกิด ซ้ํา อีก โดย มี หมาย เลข ลําดับ ออก มา.
= "เจสัน"
```json
{ "appid": "com.com2us.example.normal.freefull.google.global.android.common",
"order_id": "H4179125520850787386",
"player_id": "20000032552", "player_type": "v4" }
```
Response body¶
การ ตอบ รับ ที่ ประสบ ผล สําเร็จ รวม ไป ถึง สนาม ปฏิกิริยา ตอบ รับ ทั่ว ไปcodeถึงmessageข้างล่างเป็นการตอบสนองที่ประสบความสําเร็จ
= "เจสัน"
```json
{ "code": "0", "message": "SUCCESS" }
```
กลับค่า10010003หากไม่พบการชําระเงินซ้ําหรือ10010023ถ้ามันถูกเพิกถอนแล้ว หรือไม่ได้ทํางานอยู่ กรุณาลองใหม่10010004เกิดข้อผิดพลาดในการลบวิธีชําระเงินของ PG
การแจ้งผลการชำระเงินและการประมวลผลผลลัพธ์¶
เซิร์ฟเวอร์ Hive ส่งผลการจ่ายเงินที่ซ้ํากันไปยังที่อยู่ URL แจ้งเตือนการชําระเงินแบบเดียวกัน ในรูปแบบเดียวกันกับการชําระเงินแบบ PG ธรรมดา กรุณาอ้างอิงถึงบริการแจ้งการชําระเงินของ PGสําหรับรูปแบบที่ร้องขอ และข้อมูลการส่งมอบ
เชื่อมโยงหมายเลขคำสั่งซื้อกับรอบการชำระเงิน¶
การ แจ้ง ค่า ใช้ จ่าย ไม่ ได้ รวม เอา การ ชําระ ค่า ใช้ จ่าย ซ้ํา ๆ และ จํานวน วงจร การ จ่าย. แม่ข่ายบริการ App ควรใช้หมายเลขลําดับที่คุณบันทึกและorder_idในการตอบสนองของค่าใช้จ่ายที่เกิดขึ้นเพื่อตรวจสอบว่าการแจ้งแจ้งการชําระเงินซ้ํา ตรงกับการชําระเงินซ้ํา
| เมื่อจะส่ง | type | order_id | ประมวลผลเซิร์ฟเวอร์ App |
|---|---|---|---|
| การชําระเงินครั้งที่ 1 เสร็จสมบูรณ์ | paid | กําลังเรียกหมายเลขลําดับ | บันทึกหมายเลขลําดับเริ่มต้นและประมวลผลการจ่ายรอบแรก |
| จ่ายหลังจากยกที่ 2 | paid | ไม่.order_idในการตอบสนองของค่าใช้จ่ายที่เกิดขึ้นซ้ํา | การชําระค่าสินค้าของโพรเซสหลังจากทําการรวมกับวงจรการเรียกเก็บเงินที่บันทึกไว้ |
| Refuld วงจรการเรียกเก็บเงินจาก Hive คอนโซลหรือ PG | cancelled | จํานวนลําดับที่ตั้งไว้ | กระบวนการ คืน เงิน คืน เนื่อง จาก วัฏจักร การ เรียก เก็บ นี้ |
server_id, iap_payload, market_pidค่าที่ส่งเมื่อลงทะเบียนจะถูกติดต่อในการแจ้งการชําระเงินตลอดเวลา
การมอบไอเทมและการคืนเงิน¶
ใช้purchase_bypass_infoในประกาศการชําระหนี้ที่typeคือpaidเพื่อตรวจสอบใบเสร็จและจ่ายเงิน กรุณาอ้างอิงถึงบริการแจ้งการชําระเงินของ PGเพื่อขยายเขตเพาะปลูก
วงจรการเรียกเก็บเงินที่ค้างชําระ จะขึ้นอยู่กับค่าใช้จ่ายซ้ําที่ผู้ใช้กําหนดใหม่ต่อเงินปกติ
รหัสข้อผิดพลาด¶
แม้ว่ารหัสสถานะ HTTP200คุณต้องตรวจสอบcodeในร่างเจสัน ระบุรหัสข้อผิดพลาดและสถานะของการร้องขอ:
| รหัส | API ที่เกี่ยวข้อง | สาเหตุ | วิธีการจัดการ |
|---|---|---|---|
0 | เจ สัน | สําเร็จ | การ รับมือ กับ ความ สําเร็จ ใน แต่ ละ API |
10010001 | ธรรมดา | เกิดข้อผิดพลาดภายใน | พยายาม ลองใช้เหมือนเดิมsequence |
10010002 | ธรรมดา | ค่าที่ขาดไป, การพิมพ์ผิดพลาด, ร่างที่ไม่ใช่ Json, ไม่-POSTวิธี รวมถ้าsequenceของประจุซ้ํา น้อยกว่าเท่ากับ 1 หรือplayer_typeไม่ถูกต้อง | แก้ไขค่าที่ต้องการและรูปแบบ |
10010003 | วิธีการผ่อนชําระเงิน | ไม่พบสินค้าเอปหรือสินค้า สินค้าจึงยุติการทํางาน หายไปemailบนผนังจ่ายเงินเมื่อลงทะเบียน | เช็คแอพและสินค้า ต้องการเป็นรายการที่ขายอยู่ และตรวจสอบผนังการชําระเงินหลังจากป้อนอีเมล |
10010003 | การชําระคืน การยกเลิก | ไม่พบการจ่ายเงินซ้ํา ไม่ใช้หมายเลขลําดับ หรือการจ่ายเงินซ้ําโดยโปรแกรมหรือผู้ใช้อื่น ๆ | ยืนยันหมายเลขลําดับแรกและข้อมูลผู้ใช้ |
10010004 | ธรรมดา | เกิดข้อผิดพลาดในการล็อค PG รวมถึงการลบวิธีชําระเงิน PG เมื่อถูกยกเลิก | พยายาม ลองใช้เหมือนเดิมsequence |
10010005 | วิธีการผ่อนชําระเงิน | ไม่มีวิธีชําระเงินซ้ําที่ตรงกับประเทศและเงินตราผลิตภัณฑ์ | ปรับปรุงรายการรวมmarket_pidและลงทะเบียนด้วยวิธีการชําระเงินรวมในการตอบรับ |
10010007 | ชาร์จซ้ํา | เวลาที่ผมจ่ายเงินไปแล้ว | ไม่สนใจว่ามันเป็นเหมือน |
10010022 | ธรรมดา | เกิดข้อผิดพลาดภายใน | พยายาม ลองใช้เหมือนเดิมsequence |
10010023 | การชําระคืน การยกเลิก | การสมัครสมาชิกไม่แอคทีฟเนื่องจากถูกยกเลิก, การลงทะเบียนล้มเหลว, การลงทะเบียนที่ไม่สมบูรณ์ เป็นต้น | เตือนผู้ใช้ให้เปลี่ยนรายการ |
10010024 | ชาร์จซ้ํา | ไม่อนุมัติ PGs เช่น เกินขีด จํากัด หยุดไพ่ ฯลฯ รวมเหตุผลสําหรับ PG ล้มเหลวด้วยmessage | หลังจากผู้ใช้ได้รับแจ้งถึงวิธีการจ่ายเงินแล้ว ให้ลองใหม่อีกครั้งsequence |
HTTP401 | ธรรมดา | การตรวจสอบสิทธิ์ที่ล้มเหลว | ตรวจสอบX-Access-Tokenใบรับรอง |
ข้อควรระวังในการเชื่อมต่อ¶
เมื่อมีการเชื่อมโยงการชําระเงินของ PG เกิดขึ้นอีก ให้ตรวจสอบว่าหมายเลขลําดับและหมายเลขลําดับที่ถูกใช้อย่างไร เมื่อจ่ายรายการแล้ว ราคาจะขึ้นอยู่กับอะไร และขอบเขตของการยกเลิก
ใช้หมายเลขคำสั่งซื้อที่ออกให้¶
การร้องขอเรียกเก็บเงินซ้ําและยกเลิกจะต้องมีการออกหมายเลขลําดับorder_idในการแจ้งการชําระเงินครั้งแรก กลับเป็น10010003ผิดพลาด หากร้องขอด้วยหมายเลขลําดับหลังวินาที ดูความไวแสงสําหรับวิธีการเรียงตัวเลข
หมายเลขรอบและการลองใหม่¶
ใช้sequenceเริ่มที่ 2 คุณต้องส่งต่อเหมือนกันsequenceเมื่อพยายามจ่ายเงินเป็นยกๆ เพื่อหลีกเลี่ยงการซื้อสองใบ กลับเป็นชาร์จ API ใหม่อีกครั้งสําหรับการตอบสนองโดยสถานะการเรียกเก็บเงินและวิธีการลองใหม่
มอบไอเทมตามการแจ้งผลการชำระเงิน¶
จ่ายเงินตามฐานtype paidใบจ่าย ไม่ ควร ใช้ เงิน เพื่อ ตอบ โต้ ข้อ กล่าว หา ที่ ประสบ ความ สําเร็จ. กลับเป็นแจ้งเตือนการชําระเงินและการทํางาน APIเพื่อเรียนรู้วิธีการตรวจสอบใบเสร็จ และวงจรการเรียกเก็บเงิน
ใช้ราคาสินค้า ณ เวลาชำระเงิน¶
จํานวน เงิน ที่ จ่าย แต่ ละ ครั้ง คือ ราคา ที่ ต้อง จ่าย ใน ตอน ที่ มี การ เรียก ร้อง. ถ้าคุณเปลี่ยนราคาของสินค้า คุณจะต้องจ่ายค่าปรับปรุง ในตอนต่อไป กลับเป็นชาร์จ API ใหม่อีกครั้งสําหรับสิ่งที่ต้องจ่ายสําหรับอีกครั้งและจะ จัดการกับในกรณีที่ถูกพักงาน
อีเมลผู้ซื้อสำหรับ Paymentwall¶
เมื่อมีการลงทะเบียนการจ่ายเงินซ้ํากับผนังการชําระเงิน โปรดป้อนอีเมลของผู้ซื้อไปยังผู้ใช้ แล้วส่งต่อไปยังemailโปรดอ้างอิงถึงการชําระหนี้อีกครั้ง APIสําหรับร้องขอข้อมูลและเงื่อนไขการเข้าใช้
แยกการยกเลิกออกจากการคืนเงิน¶
ถ้าคุณยกเลิกเงินที่จ่ายซ้ําไปซ้ํามา คุณจะไม่ถูกคืนค่าตามที่จ่ายไปแล้ว ถ้าคุณต้องการจะคืนเงิน วงจรค่าใช้จ่ายเหล่านี้ คุณจะต้องประมวลผลการคืนเงินแยกกัน กลับเป็นเรียกโปรแกรม API ใหม่สําหรับการร้องขอและตอบโต้