> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vulpy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Accept payments in your Vulpy Commerce shop

> Configure payment providers in the Medusa admin, understand authorize vs. capture, and follow the Medusa payment module docs for provider setup.

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.

<Tip>
  **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.
</Tip>

## 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

<Steps>
  <Step title="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](https://docs.medusajs.com/resources/commerce-modules/payment) for the correct package name and version.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/shop/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](/shop/email) for setup details.

<Warning>
  Never commit payment provider keys to version control. Store them in `environments/<name>/.env` and rotate keys through your provider dashboard when needed.
</Warning>

## Reference

* [Medusa payment module documentation](https://docs.medusajs.com/resources/commerce-modules/payment)
* [Medusa provider documentation](https://docs.medusajs.com/) (for Stripe, PayPal, Adyen, and other gateway-specific setup)

<CardGroup cols={2}>
  <Card title="Orders" icon="clipboard-list" href="/shop/orders">
    Learn the full order lifecycle from placement through fulfillment and capture.
  </Card>

  <Card title="Shipping & Tax" icon="truck" href="/shop/shipping-tax">
    Configure shipping options and tax providers for accurate checkout totals.
  </Card>
</CardGroup>