<?php
// PHP 7.4+; merchant API signing. Use only on your server.
function starlinkSign(array $params, string $apiKey): string {
unset($params['EncryptValue'], $params['sign']);
ksort($params, SORT_STRING);
$parts = [];
foreach ($params as $key => $value) {
if (is_array($value) || is_object($value)) {
throw new InvalidArgumentException('Only scalar values are supported');
}
$parts[] = $key . '=' . (string)$value;
}
return strtoupper(hash('sha256', strtolower(implode('&', $parts) . '&HashKey=' . $apiKey)));
}
// Usage: set STARLINK_MERCHANT_CODE and STARLINK_API_KEY in your server environment.
// $params = ['merchantCode' => getenv('STARLINK_MERCHANT_CODE'), 't' => time()];
// $params['EncryptValue'] = starlinkSign($params, getenv('STARLINK_API_KEY'));
// POST JSON to https://api.xltd8899.com/api/pay/products
// Callback: form data from $_POST, verified with your merchant key.
// $received = $_POST['EncryptValue'] ?? '';
// if (!hash_equals(starlinkSign($_POST, getenv('STARLINK_API_KEY')), strtoupper($received))) {
// http_response_code(401); exit('invalid signature');
// }
// Then match mchOrderId, compare amount as a decimal, and check OrderStatusId == 2.
// Persist the payment atomically and idempotently before acknowledging with HTTP 200 "ok".
// Never acknowledge invalid data as a successful payment.
Python 3
"""Merchant API signing: Python 3. No dependencies. Server-side only."""
import hashlib
def sign(params: dict, api_key: str) -> str:
def scalar(value):
if value is None or value is False:
return ""
if value is True:
return "1"
if isinstance(value, (dict, list, tuple)):
raise ValueError("Only scalar values are supported")
return str(value)
pairs = [f"{key}={scalar(value)}" for key, value in sorted(params.items())
if key not in ("EncryptValue", "sign")]
raw = "&".join(pairs) + "&HashKey=" + api_key
# Match PHP strtolower: lowercase ASCII bytes only, preserving UTF-8 text.
return hashlib.sha256(raw.encode("utf-8").lower()).hexdigest().upper()
# Use strings for decimal amounts and opaque product codes, integer seconds for t.
# params["EncryptValue"] = sign(params, os.environ["STARLINK_API_KEY"])
# Send with Content-Type: application/json and Accept: application/json.
Node.js 18+
'use strict';
// Node.js 18+. Server-side only: never expose your merchant key in a browser.
const { createHash } = require('node:crypto');
function sign(params, apiKey) {
const scalar = value => {
if (value == null || value === false) return '';
if (value === true) return '1';
if (typeof value === 'object') throw new Error('Only scalar values are supported');
return String(value);
};
const raw = Object.keys(params).filter(k => k !== 'EncryptValue' && k !== 'sign')
.sort().map(k => `${k}=${scalar(params[k])}`).join('&') + `&HashKey=${apiKey}`;
const bytes = Buffer.from(raw, 'utf8');
for (let i = 0; i < bytes.length; i++) {
if (bytes[i] >= 65 && bytes[i] <= 90) bytes[i] += 32;
}
return createHash('sha256').update(bytes).digest('hex').toUpperCase();
}
module.exports = { sign };
// params.EncryptValue = sign(params, process.env.STARLINK_API_KEY);
// await fetch('https://api.xltd8899.com/api/pay/products', {
// method: 'POST', headers: {'Content-Type':'application/json', 'Accept':'application/json'},
// body: JSON.stringify(params)
// });