From 7e915e8c1044a96b05cb2445763a48f6e1d1f082 Mon Sep 17 00:00:00 2001
From: defiQUG <defi@defi-oracle.io>
Date: Mon, 20 Jul 2026 14:57:07 -0700
Subject: [PATCH] Seed OpenPayd marketplace service

---
 api/src/db/seeds/sovereign_stack_services.ts  | 26 +++++++++
 .../openpayd-connector-service.md             | 58 +++++++++++++++++++
 2 files changed, 84 insertions(+)
 create mode 100644 docs/marketplace/sovereign-stack/openpayd-connector-service.md

diff --git a/api/src/db/seeds/sovereign_stack_services.ts b/api/src/db/seeds/sovereign_stack_services.ts
index f3eddb0..73f4bc2 100644
--- a/api/src/db/seeds/sovereign_stack_services.ts
+++ b/api/src/db/seeds/sovereign_stack_services.ts
@@ -591,6 +591,32 @@ const services: ServiceDefinition[] = [
       billingModel: 'enterprise_contract',
       quoteRequired: true,
     }
+  },
+  {
+    name: 'OpenPayd Financial Services Connector',
+    slug: 'phoenix-openpayd-connector',
+    category: 'FINANCIAL_MESSAGING',
+    description: 'Operator-provisioned OpenPayd connector for accounts, virtual IBANs, pay-ins, payouts, FX, Open Banking, Direct Debit, and gated digital-asset flows in Phoenix Financial Cloud.',
+    shortDescription: 'OpenPayd connector for Phoenix Financial Cloud tenants',
+    tags: ['openpayd', 'payments', 'virtual-ibans', 'fx', 'open-banking', 'direct-debit'],
+    featured: false,
+    documentationUrl: 'https://docs.sankofa.nexus/marketplace/sovereign-stack/openpayd-connector-service',
+    metadata: {
+      architecture: 'docs/marketplace/sovereign-stack/openpayd-connector-service.md',
+      entitlement: 'OPENPAYD_CONNECTOR_ENTITLED',
+      manifestRef: 'config/openpayd-marketplace.v1.json',
+      targetTenants: ['DBIS', 'OMNL', 'zBank', 'NovaBank', 'Ananka Bank'],
+      fulfillmentMode: 'operator_provisioned',
+      status: 'planned_openpayd_onboarding_required',
+      gatedCapabilities: ['stablecoins', 'on_off_ramp']
+    },
+    pricingType: 'SUBSCRIPTION',
+    pricingConfig: {
+      currency: 'USD',
+      billingPeriod: 'MONTHLY',
+      billingModel: 'enterprise_contract',
+      quoteRequired: true,
+    }
   }
 ]
 
diff --git a/docs/marketplace/sovereign-stack/openpayd-connector-service.md b/docs/marketplace/sovereign-stack/openpayd-connector-service.md
new file mode 100644
index 0000000..2767b41
--- /dev/null
+++ b/docs/marketplace/sovereign-stack/openpayd-connector-service.md
@@ -0,0 +1,58 @@
+# OpenPayd Financial Services Connector
+
+## Summary
+
+The OpenPayd Financial Services Connector is an operator-provisioned Sankofa
+Marketplace service for enrolled Phoenix Financial Cloud tenants.
+
+It exposes Phoenix-controlled workflows for OpenPayd-backed accounts, virtual
+IBANs, pay-ins, payouts, FX, Open Banking, Direct Debit, signed webhooks, and
+gated digital-asset planning.
+
+## Entitlement
+
+| Field | Value |
+| --- | --- |
+| Product slug | `phoenix-openpayd-connector` |
+| Entitlement flag | `OPENPAYD_CONNECTOR_ENTITLED` |
+| Fulfillment mode | `operator_provisioned` |
+| Manage path | `/marketplace/entitlements/phoenix-openpayd-connector` |
+
+## Operator Boundary
+
+Phoenix controls tenant entitlement, credential references, approval gates,
+audit evidence, ledger posting boundaries, and suspension/offboarding.
+
+OpenPayd remains the upstream provider for regulated financial services. The
+connector does not grant a banking license, correspondent account, SWIFT
+membership, OpenPayd production access, or digital-asset approval by marketplace
+listing alone.
+
+## Activation States
+
+- `requested`
+- `sandbox_ready`
+- `production_staged`
+- `production_readonly`
+- `production_mutating_enabled`
+- `suspended`
+- `offboarded`
+
+Production mutating traffic is disabled until OpenPayd production URLs,
+credentials, webhook keys, tenant entitlements, and Sankofa approval gates are
+complete.
+
+## Gated Capabilities
+
+Stablecoin and on/off-ramp execution remain blocked until OpenPayd supplies API
+contracts, supported assets/chains, custody model, settlement rules, and
+jurisdiction/compliance approvals.
+
+## References
+
+- Proxmox manifest: `config/openpayd-marketplace.v1.json`
+- Proxmox runbook: `docs/03-deployment/OPENPAYD_CONNECTOR_RUNBOOK.md`
+- Proxmox integration reference:
+  `docs/11-references/OPENPAYD_SANKOFA_MARKETPLACE_INTEGRATION.md`
+- OpenPayd implementation plan:
+  `/home/intlc/projects/openpayd/docs/technical-implementation-plan.md`