How juspay/hyperswitch-prism works
The README presents Prism as a stateless payment-connector library: an application uses a unified payment interface, Prism transforms requests for a selected processor, and returns normalized results. This repository also contains broader Hyperswitch server, SDK, and FFI components. The graph emphasizes the documented Prism workflow and shows server and transport components where source-index references support their connections; unsampled connector dispatch details are left unasserted.
Main entry points: connectors Processor connectors · payments.rs Payment handlers · app.rs gRPC server · sdk Language SDKs
Components 13
Client interfaces
- Language SDKs
sdk - Native FFI client
sdk/node-ffi-client/index.js - Unified payment result
crates/types-traits/grpc-api-types/proto/services.proto
Payment API
- gRPC server
crates/grpc-server/grpc-server/src/app.rs - Payment handlers
crates/grpc-server/grpc-server/src/server/payments.rs - Payment domain types
crates/types-traits/domain_types/src/router_data.rs
Connector execution
- Processor connectors
crates/integrations/connector-integration/src/connectors - Webhook transforms
crates/integrations/connector-integration/src/webhook_utils.rs
Shared services
- Connector HTTP services
crates/common/external-services/src/service.rs - HTTP client
crates/common/external-services/src/http_client.rs - Metrics services
crates/common/external-services/src/otel_metrics.rs
Other components
- Merchant application
- Payment processor
Connections 11
- Merchant application → Language SDKs: calls
- Language SDKs → Processor connectors: submits payment
- Processor connectors → Payment processor: transforms requests
- Payment processor → Unified payment result: returns result
- gRPC server → Payment handlers: registers services
crates/grpc-server/grpc-server/src/app.rs - Payment handlers → Payment domain types: uses payment types
- Payment handlers → Processor connectors: dispatches flows
- Native FFI client → Processor connectors: invokes native flows
- Connector HTTP services → HTTP client: executes requests
crates/common/external-services/src/service.rs - Processor connectors → Webhook transforms: handles webhook flows
- gRPC server → Metrics services: serves metrics
crates/grpc-server/grpc-server/src/app.rs