Skip to content

Payment Gateways

A Payment Gateway record configures the connection between Fluid and an external payment provider. Each Payment Method references a single gateway through which its transactions are routed.

Field Type Description
Name (name) string Gateway display name
URL (url) string Base URL of the gateway’s API
Webhook Url (webhook_url) string Optional server-to-server webhook URL the gateway calls to notify Fluid of state changes
Field Type Description
Success Callback URL (success_callback_url) string URL the gateway redirects to on a successful transaction
Failure Callback URL (failure_callback_url) string URL the gateway redirects to on a failed transaction
Cancel Callback URL (cancel_callback_url) string URL the gateway redirects to when the player cancels
Pending Callback URL (pending_callback_url) string URL the gateway redirects to when a transaction is pending
Field Type Description
Encryption Type (encryption_type) string Encryption algorithm used for card data (e.g. RSA OAEP)
Encrypt Cardholder Name (encrypt_cardholder_name) boolean When enabled, the cardholder name is encrypted before being sent to the gateway
Encrypt Full Year (encrypt_full_year) boolean When enabled, the full 4-digit expiry year is encrypted instead of the 2-digit year
Expiry Date Encryption Mode (expiry_date_encryption_mode) string How the card expiry date is encrypted (e.g. Separate Fields)
Field Type Description
Hosted Fields Base Url (hosted_fields_base_url) string Address the Hosted Fields iframes load from. Set by Fluid per gateway and environment