Skip to main content
InsForge Payments permite que su aplicación recaude dinero con su propia cuenta de Stripe o Razorpay. Los dos proveedores utilizan diferentes modelos de pago, por lo que los documentos se dividen por proveedor en lugar de describir un flujo de pago genérico.
Panel de pagos de InsForge

Panel de pagos: conexión de proveedor, catálogo, suscripciones y transacciones.

Stripe o Razorpay sigue siendo la fuente de verdad para cargos, facturas, reembolsos, disputas, impuestos y operaciones financieras a nivel de cuenta. InsForge no es un procesador de pagos ni comerciante registrado, y no reemplaza el panel del proveedor.

​
Elija un proveedor

Pagos de Stripe

Use Stripe Checkout, Products, Prices, Subscriptions y Billing Portal.

Pagos de Razorpay

Use Razorpay Orders, Items, Plans, Subscriptions y Razorpay Checkout.

​
Arquitectura

Las tablas nativas del proveedor mantienen intactos los conceptos del proveedor: Las tablas compartidas solo se usan cuando la forma duradera es útil en los proveedores: payments.transactions no es el contrato de cumplimiento. Es una proyección construida a partir de eventos y sincronización del proveedor. Para la lógica empresarial, cree tablas propiedad de la aplicación como public.orders, public.credit_ledger o public.team_entitlements, y luego rellénelas desde filas verificadas en payments.webhook_events.

​
Cumplimiento

No cumpla solo desde una URL de éxito de Stripe o una devolución de llamada de Razorpay Checkout. Estas son señales de experiencia del usuario. El cumplimiento duradero debe ejecutarse desde eventos webhook del proveedor verificados.
Si su aplicación acepta múltiples proveedores, mantenga el activador idempotente y rama en NEW.provider y NEW.event_type. Proteja sus tablas de cumplimiento propiedad de la aplicación con sus propias políticas de RLS. Los eventos webhook se procesan de forma independiente y los proveedores no dan garantía de pedido entre eventos. Las filas derivadas de un evento se confirman antes de que ese evento se marque como processed, pero es posible que las filas propiedad de otros eventos, como payments.customer_mappings (que se crea al completar la compra), no existan cuando se active su activador. Primero resuelva los sujetos de facturación de la carga útil del evento y trate las búsquedas en otras tablas como alternativas. Vea las guías del proveedor para ejemplos de cumplimiento de suscripción.
Las filas payments.payment_history antiguas solo de Stripe se migran a payments.transactions para panel e informe. Los activadores en payment_history no se reescriben automáticamente. Mueva la lógica de cumplimiento a payments.webhook_events.

​
Construir con él

Guía de pagos de TypeScript

Seleccione el módulo del proveedor Stripe o Razorpay para el código de la aplicación.

Patrones REST

Revise las rutas de la API de Pagos específicas del proveedor y las rutas de webhook.

​
Próximos pasos

  • Lea Pagos de Stripe si está utilizando Stripe Checkout o Billing Portal.
  • Lea Pagos de Razorpay si está utilizando Razorpay Orders o Subscriptions.
  • Configure las claves del proveedor en Dashboard -> Payments -> Settings.
  • Agregue verificaciones de pertenencia RLS específicas de la aplicación o del lado del servidor para sujetos de facturación.
  • Agregue cumplimiento respaldado por activadores desde payments.webhook_events.