Skip to main content

Payments Module

Try in Playground

Primus Payments focuses on webhook validation and event handling. It does not process charges or manage subscriptions directly.

Data Isolation

Webhook validation happens locally using your provider's signing secrets. No payment data is transmitted to Primus servers.

Key Capabilities​

  • Webhook signature validation with cryptographic verification
  • Typed event parsing for subscriptions, invoices, and payments
  • Built-in idempotency and event deduplication hooks

Supported Providers​

Stripe

Webhook validation and event parsing.

WebhooksEvents

PayPal

Webhook signature verification via PayPal API.

WebhooksEvents

Packages​

PlatformPackageVersion
.NETPrimusSaaS.Payments2.0.0
Node.js@primus-saas/payments1.0.0

Supported Events (Stripe)​

Stripe EventTyped Event
customer.subscription.createdSubscriptionCreatedEvent
customer.subscription.updatedSubscriptionUpdatedEvent
customer.subscription.deletedSubscriptionCancelledEvent
payment_intent.succeededPaymentSucceededEvent
payment_intent.payment_failedPaymentFailedEvent
invoice.paidInvoicePaidEvent
invoice.payment_failedInvoicePaymentFailedEvent
customer.createdCustomerCreatedEvent
customer.updatedCustomerUpdatedEvent
customer.deletedCustomerDeletedEvent

Supported Events (PayPal)​

PayPal EventTyped Event
BILLING.SUBSCRIPTION.CREATEDSubscriptionCreatedEvent
BILLING.SUBSCRIPTION.UPDATEDSubscriptionUpdatedEvent
BILLING.SUBSCRIPTION.CANCELLEDSubscriptionCancelledEvent
PAYMENT.SALE.COMPLETEDPaymentSucceededEvent
PAYMENT.CAPTURE.COMPLETEDPaymentSucceededEvent
PAYMENT.CAPTURE.DENIEDPaymentFailedEvent
PAYMENT.CAPTURE.REFUNDEDPaymentFailedEvent
INVOICING.INVOICE.PAIDInvoicePaidEvent
INVOICING.INVOICE.PAYMENT_FAILEDInvoicePaymentFailedEvent

Roadmap​

  • Subscription management helpers

Next Steps​

Want to...See Guide
Integrate StripeStripe Integration
Subscription webhooksSubscriptions