From malga-integration-toolkit
Use this skill when querying Malga payment data for analytics, dashboards, or finance reconciliation. Triggers on questions about "Malga Analytics API", "Malga analytics", "exportar transações Malga", "Malga Reports API", "CSV export Malga", "taxa de aprovação Malga", "approval rate Malga", "Malga Dashboard analytics", "métricas de pagamento Malga", "reconciliação financeira Malga", "Malga settlement report". Covers the Analytics API for aggregated metrics, the Reports API for raw CSV exports, the Dashboard analytics module, and how the three fit together.
How this skill is triggered — by the user, by Claude, or both
Slash command
/malga-integration-toolkit:analytics-reportingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Three complementary surfaces:
Three complementary surfaces:
| Surface | Use case |
|---|---|
| Analytics API | Aggregated metrics (approval rate, GMV by provider/method, by date) for embedding in the merchant's own dashboards. |
| Reports API | Raw .csv exports of charges / customers / providers — for finance, accounting, BI ingestion. |
| Dashboard analytics | Out-of-the-box web reports for operations teams (no integration needed). |
References:
Lives under /v1/analytics. Supports filters by merchantId, paymentMethod, status, date range, and provider. Returns aggregated counts and amounts.
Typical questions to answer:
provider, ratio of captured / total.amount where status = captured, grouped by paymentMethod.type.sum(amount) / count(distinct customerId) filtered by createdAt.Cache results aggressively; the API is rate-limited and intended for periodic refresh, not request-time.
For row-level data, request an export and download the file when ready (async):
POST /v1/reports/exports
{
"type": "charges",
"filters": {
"createdAtFrom": "2026-05-01T00:00:00Z",
"createdAtTo": "2026-05-31T23:59:59Z",
"status": ["captured", "refunded"]
},
"columns": ["id", "amount", "createdAt", "status", "paymentMethod.type", "provider", "customer.document"]
}
GET /v1/reports/exports/{exportId} # poll status
GET /v1/reports/exports/{exportId}/download # 302 to S3 URL
Custom column lists let the merchant shape the export to match their BI tooling. Exports for full months can take minutes — poll, don't block.
The Dashboard offers:
CX and Finance teams typically work directly in the Dashboard. Engineering uses Analytics + Reports APIs to feed internal BI.
The recommended monthly close pattern:
charges export (Reports API) filtered to the prior month.payouts export for the same window.chargeId → payoutOrderId for split charges; per-marketplace.Match by Malga's id field, not by orderId (merchant-controlled and may collide).
captured does not mean "settled". For cash-flow reporting, join with payout data.Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub plughacker/malga-claude-plugins --plugin malga-integration-toolkit