XPayr MCP server
Commit Nov 9, 2026Provides production-oriented examples for integrating XPayr payment sessions, hosted checkout, webhooks, and merchant integrations.
Also known as xpayrcom/xpayr-api-examples
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is XPayr MCP?
XPayr provides production-oriented examples for integrating XPayr payment sessions, hosted checkout, webhooks, and merchant integrations.
Summary generated from the project's README
About XPayr MCP server
Integrating XPayr payment sessions and hosted checkout into your application is made easier with these production-oriented reference implementations. Developers can use these examples to evaluate or implement the XPayr Merchant API without needing to adopt a specific SDK immediately. The server provides code samples across multiple languages including Node.js, PHP, Python, and cURL commands to facilitate rapid development.
Users set up the environment by copying the example environment file and configuring an XPAYR_SECRET_KEY with a test key. The repository covers essential merchant tasks such as managing payment status, performing reconciliation, and implementing webhook signature verification with idempotency guidance. It is designed for teams that require reliable patterns for handling payment lifecycles and verifying webhook events securely.
This resource focuses on testnet-first merchant integrations to ensure stability before moving to live credentials. It emphasizes security by requiring that payment completion relies on verified API state and on-chain evidence rather than simple browser callbacks. The included workflows even demonstrate live testnet verification by creating small USDC sessions and validating balance deltas.
What you can do with it
- 1Implement multi-language payment sessionsA developer can find ready-to-use code for creating payment sessions in Node.js, PHP, Python, or via cURL.
- 2Secure webhook integrationTeams can implement secure webhook handling by following provided guidance on signature verification and idempotency.
- 3Verify payment reconciliationDevelopers can use the examples to ensure that payment statuses and reconciliations are handled correctly in their backend.
- 4Test merchant integrations on testnetYou can validate your integration using a testnet-first approach before using live credentials.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 16, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablexpayrcom/xpayr-api-examples is public and reachablegithub.com/xpayrcom/xpayr-api-examples ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/xpayrcom/xpayr-api-examples ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubXPayr API Examples
Production-oriented examples for XPayr payment sessions, hosted checkout, webhooks, and testnet-first merchant integrations.
Status: Public reference implementation
Purpose
Copy-paste examples for teams evaluating or integrating the XPayr Merchant API without adopting an SDK first.
Included
- cURL, Node.js, PHP, and Python payment-session examples
- Payment status and reconciliation examples
- Webhook signature verification and idempotency guidance
Quick start
cp .env.example .env
# Set XPAYR_SECRET_KEY to a test key, then choose an example under examples/.
Use an XPayr test key before live credentials. Never expose sk_test_*, sk_live_*, agent keys, webhook secrets, or wallet private keys in browser code or commits.
Documentation
Security
Read SECURITY.md before reporting a vulnerability. Payment completion must be based on verified XPayr webhook/API state and canonical on-chain evidence, not browser callbacks alone.
Live testnet verification
The XPayr Testnet smoke workflow uses a restricted sk_test_* repository-environment secret and a dedicated low-balance Arc Testnet wallet. It validates the live network catalog, creates a 0.001000 USDC session, reads the session back, renders hosted checkout, completes that exact session through the pinned XPayr lifecycle action, verifies the PaymentSplit event and balance deltas, and requires both backend and public status to reconcile as completed. Mainnet is hard-disabled and the secret-free evidence artifact is retained for 14 days.
License
MIT. See LICENSE.
XPayr MCP questions
What programming languages are supported in the examples?
The repository includes payment-session examples for cURL, Node.js, PHP, and Python.
How can I start using these examples?
You can start by copying the .env.example file to .env and setting your XPAYR_SECRET_KEY to a test key.
What security precautions should I take with my keys?
You should use an XPayr test key before live credentials and never expose secret keys, agent keys, webhook secrets, or wallet private keys in browser code or commits.