shopify-admin-payout-reconciliation

Reconcile Shopify Payments payout net amounts against order transactions and fees.

174|18|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-payout-reconciliation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-admin-payout-reconciliation
Source: https://github.com/40RTY-ai/shopify-admin-skills/tree/main/skills/finance/shopify-admin-payout-reconciliation
Command: npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-payout-reconciliation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Payout reconciliation eliminates the uncertainty of whether reported Shopify Payments payout net amounts match the actual order transactions, refunds, adjustments, and fees that funded those payouts.

Core Features & Use Cases

  • Payout vs. Transaction Net Reconciliation: Computes an expected net from charges, refunds, adjustments, and retried payouts, then flags any delta against the reported payout net.
  • Read-only Shopify Admin Drill-down: Uses flagged payouts to query relevant orders for an order-level cross-check, without performing mutations.
  • Operational Guardrails: Handles non-Shopify-Payments stores by exiting cleanly, skips payouts not yet final, supports tolerance thresholds, and supports human or JSON output.

Quick Start

Run shopify-admin-payout-reconciliation for your store domain with a 30-day lookback and a 0.01 tolerance, and review any flagged discrepancies in the generated payout_reconciliation CSV.

Frequently Asked Questions about shopify-admin-payout-reconciliation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reconcile Shopify Payments payouts against order transactions?

Shopify payout reconciliation computes an expected net from charges, refunds, adjustments, and fees, then flags any delta against the reported payout net amount. It drills down into relevant orders for a cross-check without performing mutations.

What is the best way to audit Shopify payout discrepancies over a specific time window?

Shopify payout reconciliation supports a configurable days-back window and tolerance threshold for scheduled finance workflows. It generates a CSV or JSON discrepancy report, validating deposit-level accounting across the specified period.

Can I use Shopify GraphQL queries to reconcile payouts without modifying store data?

Yes, Shopify payout reconciliation requires read-only access to shopifyPaymentsAccount and orders GraphQL operations. It performs an order-level cross-check on flagged payouts while ensuring no mutations are executed on the store.

Does Shopify payout reconciliation work for stores without Shopify Payments?

Shopify payout reconciliation handles non-Shopify-Payments stores by exiting cleanly. It also skips payouts that are not yet final, ensuring only completed deposit-level accounting validation is processed.

Why do my Shopify payout net amounts not match the summed order transactions and fees?

Shopify payout reconciliation identifies discrepancies by computing expected net amounts from charges, refunds, adjustments, and retried payouts. It flags any delta against the reported payout net, accounting for various transaction adjustments.

Do I need a tolerance threshold to reconcile Shopify payouts?

Shopify payout reconciliation supports configurable tolerance thresholds to account for minor rounding differences. Setting a tolerance, such as 0.01, filters out negligible deltas, ensuring the discrepancy report only flags meaningful mismatches.