Payment API Request

This function is used when payment is completed in the web shop.

This API is used to query users who want to make payments in the web shop. If the example below works, the integration work is complete.

Payment API Request

POST /purchase

This is a webhook to verify if the game ID is valid.

Headers

Name	Value
Content-Type	`application/json`
X-API-KEY	`API KEY`

Body

Name	Type	Description	Example
`userID`	string	User ID entered by customer	playerID
`serverID`	string	Server ID (if needed)	promether
`amount`	number	Product price	1.99
`currency`	string	Currency	USD
`method`	string	Sub payment method	100000
`status`	number	Status	1 (normal)
`createdAt`	date	Payment time	2024-11-11 12:00:00
`productID`	string	Product ID	com.game.item.001
`paymentID`	string	Payment method ID	kcp
`orderID`	string	Order number	KCP-20250318111330517771-ca0662-375a26c2
`merchantTransactionId`	string	PG company order number (optional)	827363512525

Request Examples

cURL Request

curl -X POST https://api.stageup.store/purchase \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-api-key" \
  -d '{
    "userID": "playerID",
    "serverID": "promether",
    "amount": 1.99,
    "currency": "USD",
    "method": "100000",
    "status": 1,
    "createdAt": "2024-11-11 12:00:00",
    "productID": "com.game.item.001",
    "paymentID": "kcp",
    "orderID": "KCP-20250318111330517771-ca0662-375a26c2",
    "merchantTransactionId": "827363512525"
  }'

JavaScript Request

const response = await fetch('https://api.stageup.store/purchase', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'your-api-key'
  },
  body: JSON.stringify({
    userID: 'playerID',
    serverID: 'promether',
    amount: 1.99,
    currency: 'USD',
    method: '100000',
    status: 1,
    createdAt: '2024-11-11 12:00:00',
    productID: 'com.game.item.001',
    paymentID: 'kcp',
    orderID: 'KCP-20250318111330517771-ca0662-375a26c2',
    merchantTransactionId: '827363512525'
  })
});
 
const data = await response.json();
console.log(data);

Response

Success Response (200)

{
  "status": 1,
  "message": "OK"
}

Error Response (400)

{
  "status": -1,
  "message": "error message"
}

Payment API Request

Payment API Request

Request Examples

Response

On this page