alternative-payments-api-patternslisted
Install: claude install-skill WYRE-AI/msp-claude-plugins
# Alternative Payments API Patterns
## Overview
The [Alternative Payments](https://www.alternativepayments.io/) API is a RESTful JSON
API for B2B payments: customers, invoices, hosted payment requests, transactions,
payouts, and webhooks. This skill covers OAuth2 client-credentials authentication,
pagination, rate limiting, and error handling.
The WYRE integration exposes a **read + safe-write** surface. It deliberately does
**not** implement direct payment creation (`POST /payments`), which would charge a
card or bank account. Money movement is out of scope.
## Anti-triggers
- **Transaction and payout data** — the transactions resource lives at
`GET /payments`, which makes this skill look like the destination; the
filters, statuses, and reconciliation workflows are
`alternative-payments-payments`.
- **Invoice, line-item, and payment-link fields** — use
`alternative-payments-invoicing`.
## Base URLs
| Environment | Base URL |
|-------------|----------|
| Production | `https://public-api.alternativepayments.io` |
| Demo | `https://public-api.demo.alternativepayments.io` |
## Authentication
Alternative Payments uses **OAuth 2.0 client-credentials**. Generate an API key
(`client_id` / `client_secret`) in the Partner Dashboard, then exchange it for a
short-lived bearer token.
**Token request** (HTTP Basic auth, form-encoded body):
```bash
curl -s -X POST https://public-api.alternativepayments.io/oauth/token \
-u "${AP_CLIENT_ID}:${AP_CLIENT_SECRET}" \
-H "C