Economy Configuration

Configure the payment method, escrow/refund behavior, and cancellation rules.

economy:
  payment-method: ESCROW  # ESCROW or IMMEDIATE
  require-payment-confirmation: false

payment:
  charge-on-creation: true
  pay-on-delivery: true
  refund:
    enabled: true
    deduction-percentage: 0.0  # 0.0 to 1.0
    deduction-fixed: 0.0
    use-percentage: true        # true = percentage, false = fixed
    auto-refund-on-expiration: true
    auto-refund-on-cancel: true
  cancellation:
    allow-cancel-with-deliveries: false
    require-admin-approval: false
    min-time-before-cancel: 0  # seconds

Setting	Type	Default	Description
`economy.payment-method`	String	`ESCROW`	`ESCROW` (recommended) holds payment in escrow until delivery, guaranteeing payment for deliverers and protecting creators. `IMMEDIATE` pays on collection - less secure, not recommended.
`payment.charge-on-creation`	Boolean	`true`	Charge the creator immediately, held in escrow. The escrow system itself is always enabled regardless of this setting.
`payment.pay-on-delivery`	Boolean	`true`	Pay the deliverer immediately on delivery, proportional to items delivered
`payment.refund.enabled`	Boolean	`true`	Enable refunds
`payment.refund.deduction-percentage`	Double (0.0–1.0)	`0.0`	Percentage fee deducted from refunds (used when `use-percentage: true`)
`payment.refund.deduction-fixed`	Double	`0.0`	Fixed fee deducted from refunds (used when `use-percentage: false`)
`payment.refund.use-percentage`	Boolean	`true`	Selects which deduction method applies
`payment.refund.auto-refund-on-expiration`	Boolean	`true`	Auto-refund escrow balance (minus fees) when an order expires
`payment.refund.auto-refund-on-cancel`	Boolean	`true`	Auto-refund escrow balance (minus fees) when an order is cancelled
`payment.cancellation.allow-cancel-with-deliveries`	Boolean	`false`	If `false`, orders with partial deliveries can't be cancelled (admins can always cancel).
`payment.cancellation.require-admin-approval`	Boolean	`false`	Require admin approval to cancel with deliveries. Not fully implemented - cancellation is currently blocked outright if deliveries exist.
`payment.cancellation.min-time-before-cancel`	Integer (seconds)	`0`	Minimum time that must elapse before an order can be cancelled

Escrow System

Escrow is always enabled and cannot be disabled. Flow: payment is held on order creation (if charge-on-creation) → released to the deliverer on delivery (if pay-on-delivery) → remaining balance refunded on completion, expiration, or cancellation.

Troubleshooting

Symptom	Check
Payments not working	Vault installed, economy plugin connected to Vault, sufficient balance, payment settings correct
Refunds not processing	Auto-refund settings enabled, escrow balance exists, economy plugin working, transaction logs

Escrow System​

Troubleshooting​

See Also​

Escrow System

Troubleshooting

See Also