SDK & Thư viện
SDK HiTechCloud Pay API: thư viện client mẫu và đoạn mã sẵn dùng để tích hợp truy vấn tài khoản, giao dịch và tài khoản ảo vào PHP, Node.js và Python.
HiTechCloud Pay API là REST thuần nên có thể gọi bằng bất kỳ ngôn ngữ nào. Dưới đây là các lớp bọc (wrapper) gọn nhẹ giúp bạn khởi động nhanh mà không cần cài thêm SDK nặng.
PHP — lớp client tối giản
HitechcloudPayClient.php
<?php
class HitechcloudPayClient {
private string $base = 'https://userapi.hitechcloud.vn';
public function __construct(private string $token) {}
public function get(string $path, array $query = []): array {
$url = $this->base . $path . (empty($query) ? '' : '?' . http_build_query($query));
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer {$this->token}",
"Accept: application/json",
],
]);
$res = curl_exec($ch);
curl_close($ch);
return json_decode($res, true);
}
}
$client = new HitechcloudPayClient(getenv('HITECHCLOUD_PAY_API_TOKEN'));
$accounts = $client->get('/v2/bank-accounts');
print_r($accounts['data']);Node.js / TypeScript — lớp client tối giản
hitechcloud-pay.ts
export class HitechcloudPay {
private base = "https://userapi.hitechcloud.vn";
constructor(private token: string) {}
async get<T = unknown>(path: string, query: Record<string, string | number> = {}): Promise<T> {
const qs = new URLSearchParams(
Object.entries(query).map(([k, v]) => [k, String(v)]),
).toString();
const url = `${this.base}${path}${qs ? "?" + qs : ""}`;
const res = await fetch(url, {
headers: { Authorization: `Bearer ${this.token}`, Accept: "application/json" },
});
const body = await res.json();
if (body.status === "error") throw new Error(`[${body.code}] ${body.message}`);
return body.data as T;
}
}
const pay = new HitechcloudPay(process.env.HITECHCLOUD_PAY_API_TOKEN!);
const txs = await pay.get("/v2/transactions", { page: 1, per_page: 50 });
console.log(txs);Python — lớp client tối giản
hitechcloud_pay.py
import os, requests
class HitechcloudPay:
BASE = "https://userapi.hitechcloud.vn"
def __init__(self, token: str):
self.session = requests.Session()
self.session.headers.update({
"Authorization": f"Bearer {token}",
"Accept": "application/json",
})
def get(self, path: str, **params):
r = self.session.get(f"{self.BASE}{path}", params=params)
body = r.json()
if body.get("status") == "error":
raise RuntimeError(f"[{body['code']}] {body['message']}")
return body["data"]
pay = HitechcloudPay(os.environ["HITECHCLOUD_PAY_API_TOKEN"])
print(pay.get("/v2/bank-accounts"))Bắt đầu nhanhCấp token và gọi API đầu tiên.Mã lỗiXử lý lỗi và thử lại đúng cách.WebhookNhận biến động số dư tức thời.
Các lớp client trên là mã nguồn mẫu để bạn sao chép và tùy biến. Nhớ giữ API Token trong biến môi trường và chỉ gọi API từ phía server.