Skip to main content
  • Send to AI

Gateway References

The gateway_type column on Orders identifies the payment gateway or assignment source. Not all values represent real payment processors; several represent administrative or institutional assignment paths that never touch a payment gateway.

Payment gateways​

The four active payment gateways are MercadoPago, Stripe, PayU, and Yuno. PayPal exists in historical data but is no longer part of the active gateway set (see Deprecated gateways).

Stripe (stripe): Primary gateway for most markets. Supports one-off and recurring. Per-plan remote identifiers and prices are stored in plans_gateways_meta. See Gateway Routing for the selection logic.

MercadoPago (mercadopago): Primary gateway for Latin American markets. Supports one-off and recurring.

Yuno (yuno): Payment orchestrator integrated as a single gateway. Despite being an orchestrator, Farfalla treats it as one gateway. The subscription flow creates the order inside the recurring payment service rather than before the gateway call; the one-off (OTT) flow creates the order before the payment call like the other gateways. Yuno is not available in the reader or gift flows; the underlying reason is that the Yuno checkout SDK must be loaded in the page layout, which the reader does not do. See Yuno Checkout Flow.

PayU (payu): Legacy gateway. Supported for existing one-off orders only. No new tenants are onboarded. No refund path. Not available in the reader or gift flows.

Deprecated gateways​

Deprecated

PayPal was removed from the active gateway set. Existing PayPal recurring subscriptions are being wound down by an ongoing background process. New orders cannot route to PayPal.

PayPal (paypal): Deprecated. Historical recurring subscriptions still exist in the database but no new orders are created with this gateway type. There is no PayPal IPN handler registered in any event manager, and no PayPal payment or refund service is wired in. The CancelPaypalRecurringSubscriptions job is the operational mechanism that cancels surviving PayPal recurring subscriptions using the DEPRECATE_PAYPAL cancellation reason. Treat any remaining active PayPal record as out-of-band and confirm behavior directly with the team before relying on automated reconciliation.

Non-payment assignment sources​

These values appear in gateway_type but do not go through a payment gateway at checkout. Access is granted immediately. Whether a payments row exists varies by source: see the notes below.

  • Manual (manual): An admin assigned access directly from the control panel. No payment row.
  • Bulk (bulk): Assigned via CSV import. No payment row.
  • External (external): Sale happened outside the platform (wire transfer, invoice). The plan carries a real price, but collection was not done through Farfalla. PaymentSync writes a payment row after order approval.
  • LTI (lti): Access granted automatically when the user authenticated via an LTI identity provider. No payment row.
  • SAML (saml): Access granted automatically when the user authenticated via a SAML identity provider. No payment row.
  • Total Discount (totalDiscountCoupon): A 100% discount coupon was applied; the order amount became zero and no gateway was used. For tenants with the charge_total_discount_coupon flag enabled, PaymentSync writes a nominal $1.00 USD marker payment row (independent of the original price) so the order surfaces in revenue reports. Otherwise no payment row is created.

See Manual, Bulk, and External Orders for more detail on these types.

X

Graph View