Distribute a single customer payment across multiple outstanding Syncro invoices via the Payments API.
domain: api-docs.syncromsp.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authorize the API key against the subdomain.
POST to /payments with customer_id, amount_cents (total payment in cents), payment_method, and an apply_payments object mapping invoice_id strings to payment amount strings.
Ensure amount_cents is greater than or equal to the sum of all values in apply_payments.
Ensure no individual apply_payments value exceeds that invoice's current outstanding balance.
Expect any leftover amount (amount_cents minus the sum applied) to be automatically added to the customer as Store/Customer Credit.
Known gotchas
Exceeding an individual invoice's outstanding balance in apply_payments, or having the apply_payments sum exceed amount_cents, returns a validation error — check current balances first.
The apply_payments keys/values must be strings (invoice_id as a string key, amount as a string with two decimals), not raw numbers — malformed types will fail the request.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?