SuperAPI AI Directory
Partner中文AI newsFavorites
Skillslinkfox-shopee-store-payment

linkfox-shopee-store-payment

General & other

View repository

Updated 10-16 01:48

About this skill

Shopee store Payment

Shopee Open Platform Payment module(18 APIs).Depends on linkfox-shopee-store-auth store selection; via POST /shopee/developerProxy pass in shopId(or merchantId)，the server parses the token and forwards (path must be api/v2/payment/...）。

Invocation method

  • API endpoint：POST /shopee/developerProxy(different operations are distinguished by the request body; for complete parameters/responses/error codes see references/api.md）
  • Python script：python scripts/<脚本名>.py '<JSON 参数>' [--inline](available scripts are listed in the script overview above)
  • Cost constraints: This tool consumes compute; on failure/empty results, do not automatically switch keywords, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output strategy (script default behavior)：

  • Alwayswrite the complete response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json（<cwd> is the working directory when the script runs, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated by user task;Writing to /tmp is prohibited, if the current directory is not writable, an error is reported)
  • Response body ≤ 8 KB: after writing to disk, print the complete JSON to stdout
  • Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, the length of the largest list field + the first 3 samples)
  • Add --inline to force full printing to stdout (also written to disk)

Data reading suggestions: First look at the summary to determine whether it is sufficient; when specific fields are needed, prioritize using jqorConvertFrom-Json to extract on demand from the saved json file, avoiding the entire JSON entering the context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide resolution:

Abnormal situations

  • API Key not configured: The environment variable is not configured with LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
  • Response 401 or 402 status code
  • Response indicates insufficient compute or balance: The message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Official reference

Payment module index:v2.payment.get_escrow_detail

Prerequisites (must read first)

  1. Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth and authorize the store.
  2. Do notimplement authorization/token logic within this skill.

Core Concepts

  • Forwarding chain：developerProxy（shopId/merchantId store selection, server injects token) → Ziniao shopee-proxy → Shopee API
  • Escrow: order escrow/settlement details → get_escrow_detail(requires order_sn）
  • Payout: payout → get_payout_detail、get_payout_info
  • Wallet：get_wallet_transaction_list
  • Income report：generate_income_* asynchronously generated → get_income_* get results
  • Order query → linkfox-shopee-store-orders; this skill is responsible forfunds/settlement

Available scripts (Payment module 18 APIs)

Group Script
Escrow/settlement get_escrow_detail.py、get_escrow_list.py、get_escrow_detail_batch.py
Payout/wallet get_payout_detail.py、get_payout_info.py、get_wallet_transaction_list.py、get_billing_transaction_info.py
Installments get_shop_installment_status.py、set_shop_installment_status.py、get_item_installment_status.py、set_item_installment_status.py
Income Report generate_income_statement.py、get_income_statement.py、generate_income_report.py、get_income_report.py、get_income_overview.py、get_income_detail.py
Other get_payment_method_list.py
General Entry payment_api.py(JSON contains api field)

Shared:_shopee_payment_common.py、_payment_endpoints.py、_payment_api_runner.py。

API Description (by API)

Request parameters and response details are placed in references/apis/, the SKILL only keeps the index.

API Documentation
generate_income_report references/apis/generate-income-report.md
generate_income_statement references/apis/generate-income-statement.md
get_billing_transaction_info references/apis/get-billing-transaction-info.md
get_escrow_detail references/apis/get-escrow-detail.md
get_escrow_detail_batch references/apis/get-escrow-detail-batch.md
get_escrow_list references/apis/get-escrow-list.md
get_income_detail references/apis/get-income-detail.md
get_income_overview references/apis/get-income-overview.md
get_income_report references/apis/get-income-report.md
get_income_statement references/apis/get-income-statement.md
get_item_installment_status references/apis/get-item-installment-status.md
get_payment_method_list references/apis/get-payment-method-list.md
get_payout_detail references/apis/get-payout-detail.md
get_payout_info references/apis/get-payout-info.md
get_shop_installment_status references/apis/get-shop-installment-status.md
get_wallet_transaction_list references/apis/get-wallet-transaction-list.md
set_item_installment_status references/apis/set-item-installment-status.md
set_shop_installment_status references/apis/set-shop-installment-status.md

Module Overview / Feedback see references/api.md。

Usage Scenarios

1. Query Order Settlement Details

  1. orders skill to get order_sn
  2. get_escrow_detail.py：order_sn

2. Query Payouts and Wallet

  • get_payout_detail.py / get_payout_info.py
  • get_wallet_transaction_list.py

3. Income Report

  1. generate_income_report.py or generate_income_statement.py
  2. get_income_report.py / get_income_statement.py to get results

Invocation Principles

  • First check developerProxy.httpStatus, then read *Response field
  • GET: business parameters go at the top level of JSON
  • POST: pass body or top-level body fields
  • Each script docstring contains Official documentation URL（module=97）

Not Applicable

  • Shop Authorization → linkfox-shopee-store-auth
  • Order Query/Processing → linkfox-shopee-store-orders
  • Promotions Discount/Voucher etc. → non-Payment modules

Compute Power Consumption Rules

Does not consume compute power.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.