AGENT SKILL

pm-xsolla

Xsolla connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-xsolla
description
Xsolla connector knowledge and safe action guide.

02 资源文件 1

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

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