API For Vendor

Endpoint

Production : https://api.p2wtopup.com/

Sandbox : https://api.2wtopup.com/

Authentication

ทุก Endpoint ต้องส่ง Header ดังนี้

{
    "Content-Type" : "application/json",
    "Authorization" : "Bearer <token>"
}

GET Game Topup Products

สำหรับดึงข้อมูลเกมที่เปิดให้บริการ

GET : {endpoint}/vendor/products

// Response
{
	  "products": [{
		    "id": "hsr",
		    "name": "Honkai: Star Rail",
		    "status": "sale",  // sale, suspend
		    "providers": [{
				    "id": "lapak", // lapak, oneone, razer, wepay, uid
				    "form": [{ 
				        "input_type": "textbox", 
				        "name": "uid"
				    },{
							  "input_type": "select",
							  "name": "server",
								"option": [
									{ "value": "881", "text": "Asia" },									
									{ "value": "882", "text": "America" },
									{ "value": "883", "text": "Europe" },
									{ "value": "884", "text": "TW, HK, MO" }
								]
						}]
			  }, ... ]
		}, ... ]
}

GET Packages

สำหรับดึงข้อมูล Packages ที่เปิดขาย

GET: {endpoint}/vendor/products/{product_id}

// simple: vendor/products/hsr
// Response
{
    "id": "hsr",
	  "name": "Honkai: Star Rail",
	  "status": "sale", 
	  "packages": [{
	      "package_id": "hsr_lapak_package_01",  //SKU
			  "display": "60 Oneiric Shard",
			  "selling_price": 27,
			  "cost_price": 21.57,
			  "wholesale_price": 25,
			  "provider": "lapak",
			  "limit": true,
			  "status": "sale",
			  "sort": "1",
			  "updatedAt": ""
		}, ...]
}

Change Package (Webhook)

webhook สำหรับ update ข้อมูลเมื่อมีการเปลี่ยนแปลงค่า package

// Response
[{
    "id": "hsr",
	  "name": "Honkai: Star Rail",
	  "status": "sale", 
	  "packages": [{
	      "package_id": "hsr_lapak_package_01",  //SKU
			  "display": "60 Oneiric Shard",
			  "selling_price": 27,
			  "cost_price": 21.57,
			  "wholesale_price": 25,
			  "provider": "lapak",
			  "limit": true,
			  "status": "sale",
			  "sort": "1",
			  "updatedAt": ""
		}, ...]
}, ... ]

Topup Game

สร้างคำสั่งซื้อ

POST: {endpoint}/vendor/topup

// Request
{
    "ref_id": "TR0001", // unique key
	  "package_id": "hsr_lapak_package_01",
	  "fields": "{'uid': 'XXXXXXX', 'server': '881'}", // JSON text
	  "qty": 1, //
	  "wholesell_prince": 25
}

// Response
{
	  "ref_id": "TR0001",
	  "order_id": "202511210001", // หมายเลข Transaction ของระบบ
 	  "status": "pending",
	  "reason": ""
}

Get Topup Status

สอบถามสถานะการสั่งซื้อ

GET: {endpoint}/vendor/topup/{ref_id}

// Response
{
    "ref_id": "TR0001",
	  "order_id": "202511210001",
	  "status": "success",
	  "reason": ""
}

Update Topup Status (Webhook)

Webhook สำหรับ update สถานะการเติมเงิน

// Response
{
    "ref_id": "TR0001",
	  "order_id": "202511210001",
	  "status": "failed",
	  "reason": "player_not_found"
}