payabli/integration-skills

payabli-reporting

Use when an agent needs the Query API — to build reports and exports, reconcile batches, track settlement, or back a list/detail data UI such as a customer's transaction history.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/payabli/integration-skills --skill payabli-reporting

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Payabli reporting

Query and export Payabli data, and reconcile settlements.

Load fundamentals first

If payabli-fundamentals is not already loaded, load it now, then continue.

On load

If payabli-integration.md exists at the repo root, read it; honor its ## SDK value.

Query the API

Query records — transactions, payouts, batches, settlements, customers, vendors, chargebacks — by entry (paypoint) or organization. Filters use fieldName(condition)=value (operators include eq, gt, lt, ne, ct, in, and others). Export directly with exportFormat=csv or exportFormat=xlsx. https://docs.payabli.com/guides/pay-ops-reporting-overview.md

Transaction records return numeric status codes. To render a transaction list or history view, map TransStatus (payment status) and SettlementStatus (funding status) to their meanings with the Pay In status reference. https://docs.payabli.com/guides/pay-in-status-reference.md

For payout records, prefer the PaymentStatus string over the numeric Status — the payout status enum has values the reference doesn't list, so mapping the integer alone can render "unknown." https://docs.payabli.com/guides/pay-out-status-reference.md

Bind a payout data UI to the record's actual keys: the id is PaymentId (a ULID) or IdOut (integer), the method is PaymentMethod (a string like "vcard"), and the description is Comments — not orderDescription.

Query basics

Every Query endpoint shares the same mechanics, so a list or detail view is just a filtered query:

  • Filter with fieldName(condition)=value. Conditions include eq (or empty), ne, gt, ge, lt, le, ct (contains), nct, and in/nin (pipe-separated, for example status(in)=1|0). Repeat the pattern to AND multiple filters. The accepted field list is per-endpoint — check that endpoint's API reference.
  • Paginate with limitRecord (page size; 0 or a negative value returns all) and fromRecord (offset).
  • Response envelope: results come back as { Summary, Records } — Records is the array, and Summary carries totalRecords and totalPages for paging.

Filters are bare query params (?status(in)=1|0). The API reference models the whole filter set as one parameters object — an OAS representation limit — so a request copied from the console comes prefixed with parameters=, which Payabli ignores, silently returning the full unfiltered set. Strip the literal parameters= before sending, and sanity-check that the returned count actually narrowed.

Confirm the count in both directions, not just against over-returning. An unrecognized or mis-cased filter field may be ignored (returning the full set) or return no records, so treat a 0 result as a possible bad filter rather than a definitive empty set — particularly on a list a user acts on, such as disputes. Filter field names are case-sensitive and can differ from the PascalCase fields in the response (filter caseNumber, not CaseNumber); use the exact field name documented for that endpoint.

Embedded summary objects (for example customerSummary on a customer record) may come back null — don't assume they're populated.

Scriptable exports: the Query CLI

For repeatable or batch exports, use the Payabli Query CLI — an open-source tool that wraps the Query API. https://docs.payabli.com/developers/platform-developer-query-cli.md

Reconcile settlements

Query batches, inspect each batch's Transfer object (for example ReturnedAmount, ChargeBackAmount), then pull transfer details for line-by-line adjustments (holds, releases, fees). https://docs.payabli.com/guides/pay-ops-developer-transfers-reconcile.md

Scheduled reports

Reports can be delivered on a schedule via notifications (report-email or report-web). Set these up the same way as other notifications — see payabli-webhooks.

Boundary

Real-time, per-event delivery (reacting the moment something happens) → payabli-webhooks. Use reporting for pulls, exports, and reconciliation.

같은 저장소의 Skills

더 많은 Skills

모든 Skills
payabli
커뮤니티

payabli-accept-payments

Use when writing code that accepts payments through Payabli: charging cards or ACH, integrating embedded payment components or a hosted payment page, handling Apple Pay or Google Pay, or processing voids and refunds. Boundaries — subscriptions: payabli-subscriptions; invoices and payment links: payabli-invoices; disputes and refund-failure recovery: payabli-disputes. Reads payabli-integration.md on load if present.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일
payabli
커뮤니티

payabli-bills

Use when building accounts-payable automation on Payabli — capturing vendor bills (manual entry or OCR) and paying them through Pay Out. Distinct from raw payouts (payabli-send-payments): a bill is a captured vendor invoice that you then pay. Reads payabli-integration.md on load if present.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일
payabli
커뮤니티

payabli-boarding

Use when onboarding merchants to Payabli through the API — creating the business, its people, paypoints, and bank accounts, opening a boarding application, validating and submitting it, answering underwriting requests, or tracking an application's status and enablement. Moving an existing integration off the legacy /Boarding/ endpoints lives in payabli-boarding-migration. Reads payabli-integration.md on load if present.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일
payabli
커뮤니티

payabli-boarding-migration

Use when moving an existing integration off Payabli's legacy boarding endpoints (/Boarding/app, /Boarding/read, boarding links) to intelligent boarding — converting legacy application payloads to the new records, mapping fields, values, and statuses, or planning the cutover before the legacy sunset. Building boarding from scratch lives in payabli-boarding. Reads payabli-integration.md on load if present.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일