AGENT SKILL
pm-xsolla
Xsolla connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-xsolla
- description
- Xsolla connector knowledge and safe action guide.
02 资源文件 1
- 参考文档MANUAL.md4.2 KB
03 SKILL.md 正文
pm-xsolla
Purpose
Reads Xsolla merchant transaction search/registry, payouts, payout currency breakdown, and financial report data, and writes full/partial transaction refunds through the Xsolla Pay Station API.
Icon
- id: pm-sample
- asset: icons/pm-sample.svg
- source: polymetrics
- review_status: polymetrics
- review_url: https://github.com/polymetrics-ai/cli
Capabilities
- check=true catalog=true read=true write=true query=false
- Integration type: api
Authentication
- Use pm credentials add with --from-env or --value-stdin for secret fields.
Configuration
- base_url
- datetime_from
- datetime_to
- merchant_id (required)
- mode
- project_id
- api_key (secret) (required)
ETL Streams
- projects:
- primary key: id
- cursor: updated_at
- fields: id(string), name(string), updated_at(string)
- orders:
- primary key: id
- cursor: updated_at
- fields: id(string), status(string), updated_at(string)
- transactions:
- primary key: id
- cursor: updated_at
- fields: id(string), status(string), updated_at(string)
- transactions_search:
- primary key: transaction_id
- cursor: transaction_create_date
- fields: payment_details(object), payment_system(object), purchase(object), transaction(object), transaction_create_date(string), transaction_id(integer), user(object)
- transactions_registry:
- primary key: transaction_id
- cursor: transaction_transfer_date
- fields: purchase(object), transaction(object), transaction_id(integer), transaction_transfer_date(string), user(object), user_balance(object)
- payouts:
- primary key: payout_id
- cursor: payout_date
- fields: canceled(integer), payout(object), payout_date(string), payout_id(integer), rate(number), transfer(object)
- payout_currency_breakdown:
- primary key: IsoCurrency
- fields: DirectTaxesOfPayments(number), IsoCurrency(string), PaymentsAmount(number), SumCommissionAgent(number), SumCommissionUserTaxes(number), SumItems(number), SumNominalSum(number), SumOutProject(number), SumPayoutSum(number), TaxesOfPayments(number)
- financial_reports:
- primary key: report_id
- fields: agreement_document_id(string), currency(string), is_direct_payout(boolean), is_draft_by_agreement(boolean), month(string), report_id(integer), year(integer)
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped
Reverse ETL Actions
- request_refund:
- endpoint: PUT /merchants/{{ config.merchant_id }}/reports/transactions/{{ record.transaction_id }}/refund
- required fields: transaction_id, description
- risk: irreversible external mutation; issues a full refund to the user for the given transaction; approval required
- request_partial_refund:
- endpoint: PUT /merchants/{{ config.merchant_id }}/reports/transactions/{{ record.transaction_id }}/partial_refund
- required fields: transaction_id, description, refund_amount
- risk: irreversible external mutation; issues a partial refund to the user for the given transaction; approval required
Security
- read risk: external Xsolla merchant API read of transaction, payout, and financial report data
- write risk: external mutation: issues full or partial refunds to end users for completed transactions
- approval: required for all write actions (request_refund, request_partial_refund); reads require none
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect xsolla
Inspect as structured JSON
pm connectors inspect xsolla --json
Agent Rules
- Run pm connectors inspect xsolla before creating credentials or plans.
- Use --json only when the caller needs structured output; use the manual for human-readable guidance.
- Never ask the user to paste secret values into chat.
- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.
04 同仓库更多 Skills
recipe-preview-approve-reverse-etl
Preview and approve a reverse ETL plan safely.
★ 7
recipe-github-prs-to-warehouse
Sync GitHub pull requests into the local warehouse.
★ 7
pm-zoom
Zoom connector knowledge and safe action guide.
★ 7
pm-zonka-feedback
Zonka Feedback connector knowledge and safe action guide.
★ 7
pm-zoho-invoice
Zoho Invoice connector knowledge and safe action guide.
★ 7
pm-zoho-inventory
Zoho Inventory connector knowledge and safe action guide.
★ 7