VI | EN
Message us on Messenger
Developer resources

Đơn đã giải ngân theo thời gian — Shopee API

v2.payment.get_escrow_list · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

v2.payment.get_escrow_list

GET/api/v2/payment/get_escrow_listVia 360: GET https://partner.quantri360.com/v1/shopee/api/v2/payment/get_escrow_list
Description

Danh sách đơn ĐÃ QUYẾT TOÁN (Shopee đã chuyển tiền đơn vào ví người bán) trong một khoảng thời gian: mã đơn, số tiền thực nhận, thời điểm quyết toán. Dùng để biết đơn nào vừa có tiền, rồi lấy chi tiết phí bằng get_escrow_detail_batch.

  • Chỉ gồm đơn đã quyết toán. Đơn chưa hoàn tất chưa có ở đây — xem tiền dự kiến bằng get_escrow_detail_batch.
  • Đồng bộ hằng ngày: gọi với cửa sổ 1–2 ngày gần nhất, gom order_sn thành nhóm ≤ 50 rồi gọi get_escrow_detail_batch.

Request

Endpoint

GET https://partner.quantri360.com/v1/shopee/api/v2/payment/get_escrow_list

Authentication & shop

NameInTypeSampleDescription
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Request parameters

NameInTypeRequiredSampleDescription
release_time_fromquerytimestampYes1792990800Quyết toán từ (Unix giây).
release_time_toquerytimestampYes1793250000Quyết toán đến (Unix giây).
page_sizequeryintNo100Số đơn mỗi trang: tối đa 100, mặc định 40.
page_noqueryintNo1Trang, bắt đầu từ 1.

Pagination

Tăng page_no (1, 2, 3…) khi response.more = true.

Request examples

curl -s "https://partner.quantri360.com/v1/shopee/api/v2/payment/get_escrow_list?release_time_from=1792990800&release_time_to=1793250000&page_size=100&page_no=1" \
  -H "Authorization: Bearer $KEY"
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/shopee/api/v2/payment/get_escrow_list",
    params={
        "release_time_from": 1792990800,
        "release_time_to": 1793250000,
        "page_size": 100,
        "page_no": 1
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/shopee/api/v2/payment/get_escrow_list');
for (const [k, v] of Object.entries({"release_time_from":1792990800,"release_time_to":1793250000,"page_size":100,"page_no":1})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());
PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/shopee/api/v2/payment/get_escrow_list' . '?' . http_build_query(['release_time_from' => 1792990800, 'release_time_to' => 1793250000, 'page_size' => 100, 'page_no' => 1]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by Shopee)

NameTypeSampleDescription
request_idstringd52ca43b277a4f9292fb8be658bfd33dMã request của Shopee để tra lỗi.
errorstringMã lỗi Shopee; rỗng = thành công.
messagestringMô tả lỗi.
responseobject
morebooltrueCòn trang sau.
escrow_listobject[]Đơn đã quyết toán, mới nhất trước.
order_snstring2610230ABCDE15Mã đơn.
payout_amountfloat187264Số tiền người bán thực nhận cho đơn (VND) = escrow_amount của get_escrow_detail_batch.
escrow_release_timetimestamp1793248394Thời điểm Shopee quyết toán (chuyển tiền vào ví).

Response sample

{
  "error": "",
  "message": "",
  "request_id": "f8a4d2bb5ef335f6…",
  "response": {
    "escrow_list": [
      {
        "escrow_release_time": 1793248394,
        "order_sn": "2610230ABCDE15",
        "payout_amount": 187264
      },
      {
        "escrow_release_time": 1793248047,
        "order_sn": "2610270ABCDE07",
        "payout_amount": 364850
      }
    ],
    "more": true
  }
}

Shopee error codes (20)

Show
CodeMeaning
error_paramTham số sai / thiếu / sai kiểu — xem `message` để biết tham số nào.
error_dataDữ liệu không tồn tại hoặc không hợp lệ cho thao tác (vd mã không có, loại yêu cầu không cho phép).
error_serverLỗi hệ thống Shopee — thử lại sau ít phút.
error_shopGian hàng không hợp lệ — kiểm tra platform_shop_id.
get_item_error_serverGet item failed.
income_error_serverGet escrow income failed.
decoded_failed_errorThe escrow item extinfo decoded failed.
income_not_foundThe escrow income not found.
order_error_serverThe escrow order extinfo decoded failed.
order_not_foundOrder SN provided is invalid or does not belong to you. Please enter a valid Order SN.
order_shopid_invalidThe escrow order's shopid is invalid.
return_info_error_serverGet return or refund info failed.
internal_error_serverThe inner server err when warp http req.
shopid_invalidShopid is invalid.
userid_invalidUserid is invalid.
error_authỦy quyền gian hàng cho 360 đã hết hạn hoặc bị thu hồi (360 đã tự làm mới token một lần) — chủ gian hàng kết nối lại Shopee trong Partner.
error_limitChạm hạn mức gọi Shopee trong ngày của kết nối — 360 trả kèm thời điểm thử lại; giảm tần suất gọi.
error_rate_limitGọi quá nhanh — chờ vài giây rồi gọi lại (360 cũng giới hạn theo key: 429 + Retry-After).
shop_bannedGian hàng đang bị Shopee khóa — mọi API tạm ngưng tới khi gỡ khóa.
error_kyc_authGian hàng chưa hoàn tất đăng ký người bán trên Kênh Người Bán.

Get started

  1. Sign up for Partner
  2. Enable a data type of the Tài chính / đối soát group on the platform page
  3. Create an API key (tick the Shopee channel)
  4. Call it as in the examples above