Khoá của tài khoản này

Đăng nhập để lấy khoá. Khoá đại diện đúng ví đang đăng nhập: mua qua API trừ coin của tài khoản đó.

Cần có gì

1. Đăng nhập rồi bấm Tạo khoá. Khoá sk_ là chính tài khoản đó. Gửi trong header, không dán lên web công khai. Tạo khoá mới thì khoá cũ hết hiệu lực.
2. Ví coin gắn với khoá đó còn tiền. Hết coin thì nạp trên trang Nạp, hoặc nhờ shop cộng coin.
3. Mỗi lần mua một requestId riêng, dài 16–128 ký tự, chỉ chữ, số, dấu gạch, gạch dưới và dấu chấm.

Gốc API: https://sky-sky-sky.com

Mọi lệnh đều kèm:

Authorization: Bearer sk_KHOA_CUA_BAN
Accept: application/json

1. Xem hàng đang bán

GET /api/partner/products

curl -s https://sky-sky-sky.com/api/partner/products \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Mỗi sản phẩm có id, label, coins (giá 1 cái), stock hoặc unlimited: true. Nếu có variants thì phải gửi variantId lúc mua. Giá trong variants[].coins là giá của phân loại đó.

2. Xem số coin còn lại

GET /api/partner/balance

curl -s https://sky-sky-sky.com/api/partner/balance \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Trả accountId và balance. Đây là số coin trừ khi mua, không phải số tiền ngân hàng.

3. Mua hàng

POST /api/partner/orders với JSON:

curl -s -X POST https://sky-sky-sky.com/api/partner/orders \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN" \
  -H "Content-Type: application/json" \
  -d '{"productId":"ma-san-pham","variantId":"ma-phan-loai","quantity":1,"requestId":"don-doi-tac-000001","payosOrderCode":"3002035518737"}'

• productId lấy từ danh sách hàng.
• variantId bắt buộc khi sản phẩm có phân loại. Không có phân loại thì gửi chuỗi rỗng hoặc bỏ trường này.
• quantity từ 1 đến 50. Bỏ trống thì tính là 1.
• requestId do bạn đặt. Gửi lại đúng mã đó thì nhận lại đúng đơn cũ, không trừ coin lần hai.
• payosOrderCode là mã số PayOS. Shop chỉ trả tài khoản khi mã đó đã xác nhận thanh toán và số tiền đủ giá gói. Chưa xác nhận thì không trừ coin và không có content.

Lần mua mới trả HTTP 201. Gọi lại cùng requestId trả HTTP 200.

Đơn đã giao có status: "delivered" và content là nội dung hàng (tài khoản, mật khẩu, file text). coinsSpent là coin vừa trừ, balance là số còn lại. files liệt kê tệp đính kèm nếu có.

status: "processing" nghĩa là shop chưa giao xong. Giữ id và gọi mục 4 cho đến khi thành delivered.

Web, bot Telegram và API dùng cùng ví khi được liên kết đúng tài khoản. Mua qua API vẫn được xử lý bằng luồng giao hàng của sản phẩm; chưa có hàng phù hợp thì đơn tiếp tục ở trạng thái processing.

4. Đọc lại đơn và tải tệp

GET /api/partner/orders/{id}

curl -s https://sky-sky-sky.com/api/partner/orders/buy_MA_DON \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Tệp thứ nhất: GET /api/partner/orders/{id}/file?i=0. Tệp tiếp theo tăng i lên 1, 2, …

Đơn trả thêm preparation và priority khi có dữ liệu. Đơn huỷ có cancelReason, cancelledAt và refundedCoins; nội dung tài khoản chỉ có khi delivered. payment chứa khoản đã trả, mã thanh toán gốc và các hoá đơn bổ sung nếu có.

curl -L -o hang.bin \
  "https://sky-sky-sky.com/api/partner/orders/buy_MA_DON/file?i=0" \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

5. Danh sách đơn đã mua bằng khoá này

GET /api/partner/orders

curl -s https://sky-sky-sky.com/api/partner/orders \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Mỗi dòng có productId, variantId, label, quantity, coinsSpent, status, createdAt và requestId. Nội dung hàng nằm ở mục 4, không nằm trong danh sách này.

Có thể lọc bằng status (all, processing, delivered, cancelled), query, productId, variantId. Thêm page và pageSize để phân trang; page bắt đầu từ 1, pageSize tối đa 200. Không gửi tham số phân trang thì vẫn nhận danh sách đầy đủ như API cũ.

curl -s "https://sky-sky-sky.com/api/partner/orders?status=processing&page=1&pageSize=20" \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Mua ngay · ưu tiên theo giá hiện tại

Chỉ áp dụng cho đơn đang xử lý: luồng thường chưa có tài khoản đáp ứng giá đã cấu hình, nhưng vẫn có hàng phù hợp ở giá cao hơn. Nếu đã có hàng ở giá thường hoặc không có hàng ở bất kỳ mức giá nào, available là false và không tạo thanh toán ưu tiên.

Cần trả thêm = max(0, giá nguồn thấp nhất hiện tại quy đổi VND × 130% − số tiền đã thanh toán). API tính giá cho toàn bộ số lượng của đơn và giữ số tiền trong báo giá; ứng dụng không tự thay đổi giá thanh toán.

GET /api/partner/orders/{id}/priority-quote

curl -s https://sky-sky-sky.com/api/partner/orders/buy_EXAMPLE_000001/priority-quote \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Đọc priority.available và priority.normalAvailable trước. Khi được ưu tiên, lưu quoteId, expiresAt, totalPriorityVnd, alreadyPaidVnd và surchargeVnd. Báo giá hết hạn hoặc hàng thay đổi thì lấy lại báo giá trước khi thanh toán.

POST /api/partner/orders/{id}/priority-payment

curl -s -X POST https://sky-sky-sky.com/api/partner/orders/buy_EXAMPLE_000001/priority-payment \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN" \
  -H "Content-Type: application/json" \
  -d '{"quoteId":"pq_BAO_GIA_API_TRA_VE","method":"wallet"}'

method nhận wallet, payos hoặc usdt. Wallet trừ khoản bổ sung trong ví và trả confirmed khi thành công. PayOS trả checkoutUrl hoặc QR; USDT trả usdtAddress, usdtNetwork và usdtAmount. Chỉ dùng thông tin thanh toán API vừa trả về.

GET /api/partner/orders/{id}/priority-payment-status

curl -s https://sky-sky-sky.com/api/partner/orders/buy_EXAMPLE_000001/priority-payment-status \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Thanh toán ngoài ví trả pending; theo dõi statusUrl cho đến khi priorityActive là true. Sau đó đọc lại đơn hàng để nhận content khi delivered. Ưu tiên chỉ được ghi nhận sau khi máy chủ xác nhận thanh toán.

Mất kết nối khi thanh toán: gửi lại cùng quoteId và method để kiểm tra/tiếp tục hoá đơn đang có, không tạo đơn mua hàng mới. Một mã đơn hàng có thể gắn hoá đơn gốc và nhiều hoá đơn bổ sung; payment.originalInvoice và payment.supplementInvoices liên kết chúng. Chưa thanh toán hoá đơn đang chờ thì không đổi sang wallet.

6. Kiểm tra key POOL

Vào Key của tôi để xem các key đã cấp cho tài khoản đang đăng nhập. Liên kết cùng tài khoản Telegram để web và bot hiển thị chung danh sách và số liệu.

Với khoá mua hàng sk_: GET /api/partner/pool-keys

curl -s https://sky-sky-sky.com/api/partner/pool-keys \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Trả đúng các key POOL của ví gắn với khoá sk_. Mỗi key có key, pack, dollars, quotaUsed, expiresAt, status (pending, active, expired, exhausted) và detail (token vào, token ra, cache, số request, số đô đã tiêu). Gọi lại để xem số mới. Hết số đô thì request kế tiếp dừng.

7. Nạp thêm credit hoặc gia hạn key POOL

POST /api/partner/pool-keys/topup

curl -s -X POST https://sky-sky-sky.com/api/partner/pool-keys/topup \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN" \
  -H "Content-Type: application/json" \
  -d '{"id":"buy_MA_KEY_DA_MUA","variantId":"10","quantity":1,"days":0,"requestId":"nap-key-000000001"}'

id là mã đơn cấp key thuộc ví này; variantId lấy từ sản phẩm POOL. days: 0 chỉ thêm credit và giữ ngày hết hạn; 1–7 để gia hạn, bỏ days thì mặc định 1 ngày. Giữ cùng requestId khi thử lại để không trừ coin lần hai.

GET /api/partner/pool-keys/topup?requestId=nap-key-000000001

Kiểm tra trạng thái lượt nạp bằng requestId. pending nghĩa là đã ghi nhận và đang đồng bộ key; applied nghĩa là đã áp dụng. Đây là nạp credit vào key, không phải nạp tiền ngân hàng vào ví coin.

Lỗi thường gặp

• 401 — thiếu khoá, khoá sai, hoặc khoá đã bị thu hồi.
• 402 — không đủ coin. Xem needed, have, short.
• 409 — hết hàng, hoặc requestId đã dùng cho một đơn khác.
• 400 — thiếu phân loại, hoặc requestId không đúng dạng.
• 404 — không có sản phẩm hoặc không có đơn đó trên ví của khoá này.
• Ưu tiên: 409 là báo giá hết hạn, đơn không còn nhận ưu tiên, ví thiếu coin hoặc đang có hoá đơn chờ; đọc error/code và lấy lại báo giá khi cần. 502 là nguồn thanh toán chưa trả lời; giữ quoteId và method rồi thử lại. 405 là gọi sai phương thức; 429 thì giảm nhịp gọi.

Đơn nội dung RF là hoàn tiền, không phải hàng. Đừng đưa đơn đó cho khách của bạn.