DeltaForceMerchantTopupOrder

Last Updated 11th May, 2025

The DeltaForceMerchantTopupOrder mutation allows merchant clients to top up Delta Force balances using their merchant key. It deducts the merchant's balance and query count, validates the product, and logs the transaction.

💡 Merchant accounts benefit from discounted pricing — products are charged at 80% of the usual retail price.

🔗 Endpoint URL: https://api.vscgames.com/graphql Method: POST Content-Type: application/json

📎 Mutation Structure

mutation DeltaForceMerchantTopupOrder($productId: String!, $playerID: String!) {
  DeltaForceMerchantTopupOrder(productId: $productId, playerID: $playerID) {
    code
    message
    orderId
    playerID
    productId
    name
    amount
    status
  }
}

📅 Parameters

Name	Type	Required	Description
productId	String	Yes	ID of the Delta Force top-up product
playerID	String	Yes	Player ID to receive the top-up

✅ Successful Response

{
  "data": {
    "DeltaForceMerchantTopupOrder": {
      "code": 200,
      "message": "Delta Force top-up placed successfully",
      "orderId": "DFM123456",
      "playerID": "905382718",
      "productId": "abc123",
      "name": "Delta Force Pack 1",
      "amount": 1.60,
      "status": "Pending"
    }
  }
}

🚫 Error Codes

Code	Message	Meaning
401	Merchant key required	Missing or invalid merchant header
403	Invalid merchant key	Merchant not found
402	Insufficient merchant query balance	Merchant has 0 remaining query credits
404	Top-up product not found	The product ID is not valid
503	Topup failed	Internal operation failed to process
500	Transaction not found	No record matched after placement

🔪 Code Examples Python

import requests

url = "https://api.vscgames.com/graphql"
headers = {"Content-Type": "application/json", "merchantkey": "YOUR_MERCHANT_KEY"}

query = """
mutation DeltaForceMerchantTopupOrder($productId: String!, $playerID: String!) {
  DeltaForceMerchantTopupOrder(productId: $productId, playerID: $playerID) {
    code
    message
    orderId
    playerID
    productId
    name
    amount
    status
  }
}
"""

variables = {
  "productId": "abc123",
  "playerID": "905382718"
}

response = requests.post(url, json={"query": query, "variables": variables}, headers=headers)
print(response.json())

JavaScript

const fetch = require("node-fetch");

const query = `
mutation DeltaForceMerchantTopupOrder($productId: String!, $playerID: String!) {
  DeltaForceMerchantTopupOrder(productId: $productId, playerID: $playerID) {
    code
    message
    orderId
    playerID
    productId
    name
    amount
    status
  }
}`;

const variables = {
  productId: "abc123",
  playerID: "905382718"
};

fetch("https://api.vscgames.com/graphql", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "merchantkey": "YOUR_MERCHANT_KEY"
  },
  body: JSON.stringify({ query, variables })
})
  .then(res => res.json())
  .then(data => console.log(data));