superposition_seed.toml

# Superposition Seed Configuration for Hyperswitch
# This file serves dual purpose:
#   1. Seeding via scripts/seed_superposition.sh (posts to Superposition API)
#   2. Runtime fallback for FileDataSource via backup_file_path config
#
# Extra fields (description, change_reason) are used only by the seeding script
# and are silently ignored by the FileDataSource parser.

# Empty overrides table - required for FileDataSource backup parsing
# The seeding script ignores this field; it's only needed for runtime fallback
overrides = []

[default-configs.deja_record]
value = true
schema = { type = "boolean" }
description = "Whether Deja request recording is enabled for matching request contexts (inert unless deja.sampler.enabled is set)"
change_reason = "Initial setup"


[dimensions.connector]
position = 1
schema = { type = "string" }
description = "Payment connector identifier (e.g. stripe, adyen)"
change_reason = "Initial setup"

[dimensions.payment_method]
position = 2
schema = { type = "string" }
description = "Payment method identifier (e.g. card, wallet, bank_transfer)"
change_reason = "Initial setup"

[dimensions.payment_method_type]
position = 3
schema = { type = "string" }
description = "Payment method type identifier (e.g. credit, debit, google_pay)"
change_reason = "Initial setup"

[dimensions.payout_retry_type]
position = 4
schema = { type = "string" }
description = "Type of payout retry (single_connector or multi_connector)"
change_reason = "Initial setup"

[dimensions.incoming_webhook_events]
position = 5
schema = { type = "string" }
description = "Incoming webhook event type identifier (e.g. payment_intent.succeeded)"
change_reason = "Initial setup"

[dimensions.organization_id]
position = 6
schema = { type = "string" }
description = "Organization identifier"
change_reason = "Initial setup"

[dimensions.provider_merchant_id]
position = 7
schema = { type = "string" }
description = "Provider merchant identifier (hyperswitch merchant id)"
change_reason = "Initial setup"

[dimensions.processor_merchant_id]
position = 8
schema = { type = "string" }
description = "Processor merchant identifier (connector-side merchant id)"
change_reason = "Initial setup"

[dimensions.profile_id]
position = 9
schema = { type = "string" }
description = "Business profile identifier"
change_reason = "Initial setup"

[default-configs.requires_cvv]
value = true
schema = { type = "boolean" }
description = "Whether CVV is required for payments"
change_reason = "Initial setup"

[default-configs.implicit_customer_update]
value = false
schema = { type = "boolean" }
description = "Whether to implicitly update customer details on payment"
change_reason = "Initial setup"

[default-configs.payout_tracker_mapping]
schema = { type = "object" }
description = "Payout sync retry mapping configuration per connector"
change_reason = "Initial setup"

[default-configs.payout_tracker_mapping.value]
start_after = 60
frequencies = [[300, 5]]

[default-configs.client_session_validation_enabled]
value = true
schema = { type = "boolean" }
description = "Whether client session validation is enabled for payments"
change_reason = "Initial setup"

[default-configs.should_call_gsm]
value = false
schema = { type = "boolean" }
description = "Whether to call GSM (Global Status Mapping) for auto-retries on payment failure"
change_reason = "Initial setup"

[default-configs.should_perform_eligibility]
value = false
schema = { type = "boolean" }
description = "Whether the SDK should perform an eligibility check before confirming payment"
change_reason = "Initial setup"

[default-configs.should_enable_mit_with_limited_card_data]
value = false
schema = { type = "boolean" }
description = "Whether to allow merchant-initiated transactions (MIT) with limited card data"
change_reason = "Initial setup"

[default-configs.should_store_eligibility_check_data_for_authentication]
value = false
schema = { type = "boolean" }
description = "Whether to store eligibility check data during authentication"
change_reason = "Initial setup"

[default-configs.enable_extended_card_bin]
value = false
schema = { type = "boolean" }
description = "Whether to use extended card BIN (8-digit) for payment method data"
change_reason = "Initial setup"

[default-configs.max_auto_payout_retries]
value = 0
schema = { type = "integer", minimum = 0, maximum = 4294967295 }
description = "Maximum auto payout retries, differentiated by payout_retry_type dimension (single_connector or multi_connector)"
change_reason = "Initial setup"

[default-configs.gsm_payout_call]
value = false
schema = { type = "boolean" }
description = "Whether to call GSM for payout retries"
change_reason = "Initial setup"

[default-configs.should_disable_vault_tokenization]
value = false
schema = { type = "boolean" }
description = "Whether to disable vault tokenization for a merchant"
change_reason = "Initial setup"

[default-configs.should_call_pm_modular_service]
value = false
schema = { type = "boolean" }
description = "Whether to call the PM modular service for an organization"
change_reason = "Initial setup"

[default-configs.should_perform_sdk_vaulting]
value = true
schema = { type = "boolean" }
description = "Org level override on top of should_call_pm_modular_service; when false the SDK skips vaulting"
change_reason = "Initial setup"

[default-configs.should_schedule_modular_forward_compat]
value = false
schema = { type = "boolean" }
description = "Whether to schedule PM modular forward compatibility PT for a merchant"
change_reason = "Initial setup"

[default-configs.should_trigger_fingerprint_migration]
value = false
schema = { type = "boolean" }
description = "Whether to trigger fingerprint and entity_id migration for a merchant"
change_reason = "Initial setup"


[default-configs.should_schedule_modular_backward_compat]
value = false
schema = { type = "boolean" }
description = "Whether to schedule PM modular backward compatibility PT for a merchant"
change_reason = "Initial setup"

[default-configs.should_trigger_backwards_compatibility_inline]
value = false
schema = { type = "boolean" }
description = "Whether to trigger PM modular backward compatibility inline for a merchant"
change_reason = "Initial setup"

[default-configs.should_return_raw_payment_method_details]
value = false
schema = { type = "boolean" }
description = "Whether to return raw payment method details (v2 only)"
change_reason = "Initial setup"

[default-configs.routing_result_source]
value = "hyperswitch_routing"
schema = { type = "string", enum = ["decision_engine", "hyperswitch_routing"] }
description = "Source of routing result: decision_engine (external DE) or hyperswitch_routing (inbuilt)"
change_reason = "Initial setup"

[default-configs.threeds_routing_region_uas]
value = "region1"
schema = { type = "string", enum = ["region1", "region2"] }
description = "3DS routing region for UAS (Unified Authentication Service) per organization"
change_reason = "Initial setup"

[default-configs.incoming_webhook_disabled_events]
value = false
schema = { type = "boolean" }
description = "Whether a specific incoming webhook event is disabled for a given connector"
change_reason = "Initial setup"

[default-configs.poll_config_external_three_ds]
schema = { type = "object" }
description = "Poll configuration for external 3DS authentication per connector"
change_reason = "Initial setup"

[default-configs.poll_config_external_three_ds.value]
delay_in_secs = 2
frequency = 5

[default-configs.pt_mapping_outgoing_webhooks]
schema = { type = "object" }
description = "Outgoing webhook retry process tracker mapping configuration"
change_reason = "Initial setup"

[default-configs.pt_mapping_outgoing_webhooks.value.default_mapping]
start_after = 60
frequencies = [[300, 2], [600, 5], [3600, 5], [21600, 3]]

[default-configs.pt_mapping_outgoing_connector_webhooks]
schema = { type = "object" }
description = "Outgoing connector webhook retry process tracker mapping configuration"
change_reason = "Initial setup"

[default-configs.pt_mapping_outgoing_connector_webhooks.value.default_mapping]
start_after = 60
frequencies = [[300, 2], [600, 5], [3600, 5], [21600, 3]]

[default-configs.pt_mapping_pcr_retries]
schema = { type = "object" }
description = "Revenue recovery (PCR) payment retry process tracker mapping configuration"
change_reason = "Initial setup"

[default-configs.pt_mapping_pcr_retries.value.default_mapping]
start_after = 60
frequencies = [[10800, 2], [21600, 3], [32400, 3], [43200, 3], [64800, 3]]

[default-configs.pt_mapping_payment_sync]
schema = { type = "object" }
description = "Payment sync (psync) retry process tracker mapping configuration"
change_reason = "Initial setup"

[default-configs.pt_mapping_payment_sync.value]
max_retries_count = 5

[default-configs.pt_mapping_payment_sync.value.default_mapping]
start_after = 60
frequencies = [[300, 5]]

[default-configs.pt_mapping_refund_sync]
schema = { type = "object" }
description = "Refund sync retry process tracker mapping configuration"
change_reason = "Initial setup"

[default-configs.pt_mapping_refund_sync.value]
max_retries_count = 5

[default-configs.pt_mapping_refund_sync.value.default_mapping]
start_after = 60
frequencies = [[300, 5]]

[default-configs.pt_mapping_dispute_sync]
schema = { type = "object" }
description = "Dispute sync retry process tracker mapping configuration"
change_reason = "Initial setup"

[default-configs.pt_mapping_dispute_sync.value]
max_retries_count = 5

[default-configs.pt_mapping_dispute_sync.value.default_mapping]
start_after = 60
frequencies = [[300, 5]]

[default-configs.save_wallet_decrypted_data]
value = false
schema = { type = "boolean" }
description = "Whether to save wallet decrypted data"
change_reason = "Initial setup"