Skip to main content
Payments in Vulpy Commerce are handled entirely by the Medusa v2 payment module. Vulpy Commerce does not override the payment API or add custom checkout logic. You configure providers inside the Medusa admin and follow upstream Medusa payment documentation for provider-specific setup.
The fastest way is to ask Fox. Fox works in the same Medusa admin and can manage payment setup and operations for you.
  • Install the Stripe provider in Medusa.
  • Enable Stripe on the EU region.
  • Capture payment on order #1023.

​
Where payments live

All payment configuration is managed in the Medusa admin:
  • Local development: http://localhost:9000/app
  • Production: https://api.<your-domain>/app
Region settings control which payment providers are available at checkout. Each region can have one or more providers enabled, and the storefront shows the options configured for the customer’s selected region.

​
Authorize vs. capture

Medusa supports a two-step payment flow:
  1. Authorize: The customer’s funds are held when they place the order.
  2. Capture: You collect the funds after the order is confirmed or shipped.
Some providers automatically capture at checkout. Others authorize only and require a manual capture step from the order detail page in the Medusa admin. Check your provider’s behavior in the Medusa payment documentation.

​
Configure a provider

1

Install the provider package

Inside apps/medusa-backend, install the Medusa provider package for your chosen gateway. For example, Stripe, PayPal, or Adyen. See the Medusa payment providers documentation for the correct package name and version.
2

Add credentials to the environment

Add the provider’s required environment variables to the per-environment .env file at environments/<name>/.env. This keeps secrets out of the codebase and scoped to the correct environment.
3

Enable the provider on a region

Open the Medusa admin, go to Settings → Regions, select the region you want to configure, and add the provider to the region’s payment providers list. Save the change. Or just ask Fox to enable the provider on the region.
4

Test in checkout

Visit the storefront at http://localhost:3000 (dev) or your live domain, add a product to cart, and proceed to checkout. The payment option you enabled should appear.

​
Capture from the admin

For providers that do not auto-capture, you must capture payment manually before fulfilling the order. Open the order in the Medusa admin and use the capture action on the order detail page. For the full fulfillment flow, see Orders.

​
Refunds

Refunds are processed through the Medusa admin on the order detail page. After you issue a refund, the transactional email plugin sends the customer a notice if email is configured. See Email for setup details.
Never commit payment provider keys to version control. Store them in environments/<name>/.env and rotate keys through your provider dashboard when needed.

​
Reference

Orders

Learn the full order lifecycle from placement through fulfillment and capture.

Shipping & Tax

Configure shipping options and tax providers for accurate checkout totals.