@paymos/mcp 1.4.0 → 1.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +7 -0
- package/README.md +1 -3
- package/dist/index.js +4 -4
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [1.4.1] - 2026-11-02
|
|
6
|
+
|
|
7
|
+
- docs: regenerate merged documentation on shared node
|
|
8
|
+
- merge: integrate current main and shared workspace
|
|
9
|
+
- wip: snapshot shared working tree before merging main
|
|
10
|
+
- wip(refunds): merchant refund plugin work (CMS adapters, PHP SDK, tests) - unverified WIP snapshot
|
|
11
|
+
|
|
5
12
|
## [1.4.0] - 2026-11-01
|
|
6
13
|
|
|
7
14
|
- feat(mcp): add sandbox payment channel tools
|
package/README.md
CHANGED
|
@@ -8,9 +8,7 @@ Use a test Payment key pair. Live and Payout keys are rejected; API requests are
|
|
|
8
8
|
|
|
9
9
|
## Requirements
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
- Node.js 20 or newer
|
|
11
|
+
- Requires Node.js 22.12 or later.
|
|
14
12
|
- A Paymos merchant account with a test key pair from Dashboard → Developer → API Keys (`pk_test_…` and `sk_test_…`)
|
|
15
13
|
- An MCP client that can launch a local stdio server
|
|
16
14
|
|
package/dist/index.js
CHANGED
|
@@ -734,7 +734,7 @@ typed response. Manual signing is documented separately in <a href="/docs/authen
|
|
|
734
734
|
<pre class="shiki one-dark-pro" style="background-color:#282c34;color:#abb2bf" tabindex="0" data-lang="json"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
|
|
735
735
|
<span class="line"><span style="color:#E06C75"> "event_id"</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"evt_J7EEYeL9pZJukfj2c5OQ44"</span><span style="color:#ABB2BF">,</span></span>
|
|
736
736
|
<span class="line"><span style="color:#E06C75"> "event_type"</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"invoice.paid"</span><span style="color:#ABB2BF">,</span></span>
|
|
737
|
-
<span class="line"><span style="color:#E06C75"> "version"</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">
|
|
737
|
+
<span class="line"><span style="color:#E06C75"> "version"</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">2</span><span style="color:#ABB2BF">,</span></span>
|
|
738
738
|
<span class="line"><span style="color:#E06C75"> "occurred_at"</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">1739281200</span><span style="color:#ABB2BF">,</span></span>
|
|
739
739
|
<span class="line"><span style="color:#E06C75"> "data"</span><span style="color:#ABB2BF">: {</span></span>
|
|
740
740
|
<span class="line"><span style="color:#E06C75"> "invoice_id"</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"inv_5CcyDYmMUGtzYL10q0Iimr"</span><span style="color:#ABB2BF">,</span></span>
|
|
@@ -900,7 +900,7 @@ typed response. Manual signing is documented separately in <a href="/docs/authen
|
|
|
900
900
|
<span class="line"><span style="color:#D19A66"> src</span><span style="color:#ABB2BF">=</span><span style="color:#98C379">"https://checkout.paymos.io/invoice/inv_xxx?embed=true"</span></span>
|
|
901
901
|
<span class="line"><span style="color:#D19A66"> title</span><span style="color:#ABB2BF">=</span><span style="color:#98C379">"Paymos checkout"</span></span>
|
|
902
902
|
<span class="line"><span style="color:#D19A66"> allow</span><span style="color:#ABB2BF">=</span><span style="color:#98C379">"clipboard-write"</span></span>
|
|
903
|
-
<span class="line"><span style="color:#D19A66"> sandbox</span><span style="color:#ABB2BF">=</span><span style="color:#98C379">"allow-scripts allow-same-origin allow-forms"</span></span>
|
|
903
|
+
<span class="line"><span style="color:#D19A66"> sandbox</span><span style="color:#ABB2BF">=</span><span style="color:#98C379">"allow-scripts allow-same-origin allow-forms allow-popups"</span></span>
|
|
904
904
|
<span class="line"><span style="color:#D19A66"> style</span><span style="color:#ABB2BF">=</span><span style="color:#98C379">"display:block;width:100%;max-width:460px;height:min(90vh,900px);border:0;"</span></span>
|
|
905
905
|
<span class="line"><span style="color:#ABB2BF">></</span><span style="color:#E06C75">iframe</span><span style="color:#ABB2BF">></span></span>
|
|
906
906
|
<span class="line"></span></code></pre>
|
|
@@ -952,7 +952,7 @@ typed response. Manual signing is documented separately in <a href="/docs/authen
|
|
|
952
952
|
<div class="callout callout--danger"><svg class="callout__icon" viewBox="0 0 20 20" fill="none" stroke="currentColor" aria-hidden="true"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.6" d="M10 2.5a7.5 7.5 0 1 0 0 15 7.5 7.5 0 0 0 0-15ZM7 7l6 6m0-6-6 6"></path></svg><div class="callout__body"><p>Treat these events as UX hints, not proof of payment. Drive spinners, redirects, and analytics from them \u2014 but never ship goods, credit balances, or mark an order paid based on a <code>postMessage</code>. A <code>postMessage</code> is trivial to spoof: any page sharing the customer's origin can post a fake <code>paymos:succeeded</code>. Settlement is confirmed only by the signed server-side webhook \u2014 the one source of truth for fulfillment.</p></div></div>
|
|
953
953
|
<h2 id="security-model">Security model</h2>
|
|
954
954
|
<p>The recommended iframe sandbox is deliberately small:</p>
|
|
955
|
-
<ul class="list-none p-0 m-0 flex flex-col gap-3"><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-scripts</code> is required for checkout interactivity, API calls, timers, copy buttons, and live status updates.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-same-origin</code> lets the Paymos-hosted checkout run with its own origin instead of an opaque sandbox origin.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-forms</code> allows normal form interactions inside checkout.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-top-navigation</code> is omitted so the iframe cannot navigate the merchant page.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-popups</code>
|
|
955
|
+
<ul class="list-none p-0 m-0 flex flex-col gap-3"><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-scripts</code> is required for checkout interactivity, API calls, timers, copy buttons, and live status updates.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-same-origin</code> lets the Paymos-hosted checkout run with its own origin instead of an opaque sandbox origin.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-forms</code> allows normal form interactions inside checkout.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-top-navigation</code> is omitted so the iframe cannot navigate the merchant page.</span></li><li class="flex gap-3"><span class="font-mono text-primary shrink-0">\u2014</span><span><code>allow-popups</code> lets the buyer open the terms and other checkout links in a new tab.</span></li></ul>
|
|
956
956
|
<h2 id="when-to-use-low-code-sdk-instead">When to use Low-Code SDK instead</h2>
|
|
957
957
|
<p>Use <a href="/docs/widget-sdk">Low-Code SDK</a> when you want Paymos to create invoices from browser-side config, render the payment button, manage the modal lifecycle, validate iframe messages, and dispatch <code>paymos:*</code> <code>CustomEvent</code>s for you.</p>
|
|
958
958
|
<p>Use manual iframe embed when your backend already owns invoice creation and you only need to place the hosted checkout UI inside your page.</p>`
|
|
@@ -1171,7 +1171,7 @@ function registerResources(server) {
|
|
|
1171
1171
|
}
|
|
1172
1172
|
|
|
1173
1173
|
// src/version.ts
|
|
1174
|
-
var MCP_VERSION = "1.4.
|
|
1174
|
+
var MCP_VERSION = "1.4.1";
|
|
1175
1175
|
|
|
1176
1176
|
// src/server.ts
|
|
1177
1177
|
function buildServer(gateway) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@paymos/mcp",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.1",
|
|
4
4
|
"description": "Official Paymos MCP server: a local stdio server that lets coding agents (Claude Code, Cursor, custom LLM bots) build and verify a merchant integration against the Paymos sandbox without reading docs.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"paymos",
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
],
|
|
48
48
|
"sideEffects": false,
|
|
49
49
|
"engines": {
|
|
50
|
-
"node": ">=
|
|
50
|
+
"node": ">=22.12"
|
|
51
51
|
},
|
|
52
52
|
"scripts": {
|
|
53
53
|
"build": "npm run build:resources && tsup src/index.ts --format esm --dts --clean",
|