Skip to main content
npayload is launching soon.
npayloadDocs
Concepts

Architecture

How npayload delivers messages globally with edge presence, regional instances, and guaranteed delivery

npayload is a global messaging network for autonomous systems. Shopify apps, SaaS integrations, microservices, autonomous agents. Anything that needs to communicate reliably connects through npayload. Your messages enter the nearest edge, travel the backbone, and arrive at the right destination. Like the internet, you do not manage the routers. You just send.

Global network

npayload connects diverse systems across every region. An e-commerce app in Tokyo, an AI agent in London, a payment processor in Sao Paulo, and your backend in Toronto all communicate through the same global fabric. Each system connects to the nearest edge node. The edge handles authentication, rate limiting, and validation, then routes the message through the npayload backbone to the correct regional instance.

Edge presence

npayload runs edge nodes across the globe. Every API call is handled by the nearest edge, giving you:

CapabilityWhat it does
Low latencyYour request hits the nearest edge, not a data centre on the other side of the world
DDoS protectionAttacks are absorbed at the edge before they reach backend services
TLS 1.3All connections are encrypted in transit
AuthenticationOAuth 2.0 + DPoP verification happens at the edge
Rate limitingPer-IP and per-credential limits enforced before messages reach instances
No public IPsBackend services have zero internet-facing endpoints

Regional instances

An instance is an isolated deployment, dedicated or shared, that handles all message operations for your organisation.

GuaranteeHow
Data isolationEach customer's data is physically separate from another's
Data residencyYou choose where your data lives. Messages stay in the region you configure
Independent scalingEach instance scales based on its own workload

Key capabilities per instance:

  • Immutable message log with configurable retention
  • Fan-out engine that routes messages to all matching subscriptions
  • Delivery pipeline with retries, circuit breaker, and dead letter queue
  • Three encryption modes (standard, hybrid, E2E)
  • Streams with ordered replay from any offset

What connects through npayload

SystemExampleWhy npayload
E-commerce appsShopify, WooCommerce, custom storefrontsSync inventory, orders, and fulfillment across stores and services
SaaS integrationsStripe, Twilio, Salesforce, HubSpotConnect services that have no shared communication bus
MicroservicesYour own backend servicesReliable pub/sub with retries, DLQ, and delivery guarantees
Autonomous systemsLangChain, CrewAI, AutoGen, custom agentsStructured communication with sessions, trust scoring, and encryption
IoT and edgeSensors, devices, edge workersPublish telemetry to regional instances with guaranteed delivery
B2B integrationsPartner APIs, supply chain systemsCross-organisation messaging with data residency compliance

Cross-region messaging

When a channel spans multiple regions, npayload automatically replicates messages between instances with exactly-once delivery guarantees. Your application publishes once. npayload handles the rest.

Cross-region messaging enables:

  • Multi-region architectures where services run close to their users
  • B2B integrations across geographies
  • Data residency compliance with global reach

Cross-region replication requires explicit data residency consent from both the source and destination organisations.

Protocol stack

npayload works alongside other protocols, not as a replacement:

ProtocolLayerPurpose
MCPTools"What can this system do?"
A2ATasks"System A, please do this task"
ASPSessions"Let us negotiate, build trust, commit"
npayloadTransport"Deliver it. Guarantee it. Encrypt it."

MCP defines the tools. A2A assigns the tasks. ASP negotiates the terms. npayload delivers the messages reliably, securely, at scale.

Next steps

Was this page helpful?

On this page