Free Fire TOPUP

Last Updated 11th May, 2025

1️⃣ Endpoint

GET https://api.vscgames.com/freefire-merchant-topup

---

2️⃣ Required Headers

Header	Description	Example
merchantkey	Your assigned merchant API key	merchantkey: 12345-ABCDE

---

3️⃣ Query Parameters

Parameter	Type	Required	Description	Example
productId	Number	✅ Yes	The ID of the Free Fire top-up product.	1
playerID	Number	✅ Yes	The Free Fire Player's in-game ID.	123456789
Merchantname	String	✅ Yes	A name or tag for your top-up request.	VScgames

---

4️⃣ Example Request

curl -X GET "https://api.vscgames.com/freefire-merchant-topup?productId=1&playerID=2255245647&Merchantname=VScgames" \
-H "merchantkey: YOUR_MERCHANT_KEY"

---

5️⃣ Example Successful Response (200 OK)

{
  "code": 200,
  "message": "Top-up placed successfully",
  "orderId": "VSC-1722939932-T",
  "productId": "1",
  "playerID": "2255245647",
  "name": "Free Fire Diamonds 110",
  "amount": 0.91,
  "status": "Completed",
  "timestamp": "2025-08-06T12:00:00.000Z"
}

---

6️⃣ Example Error Responses

HTTP Code	JSON Response Example
400	{ "code": 400, "message": "Invalid or missing playerID (numbers only)" }
401	{ "code": 401, "message": "Merchant key required" }
404	{ "code": 404, "message": "Top-up product not found" }
402	{ "code": 402, "message": "Insufficient balance" }
500	{ "code": 500, "message": "Top-up failed" }

---

7️⃣ Notes for Merchants

• ✅ You must include your merchantkey in every request header.

• ✅ Only numeric values are allowed for productId and playerID.

• ✅ Merchantname can be any text label to track your request.

• ❌ If your balance or query quota is insufficient, the API will return a 402 error.

• ✅ Successful top-ups are processed instantly, and transaction details are logged in your account dashboard.