> For the complete documentation index, see [llms.txt](https://docs.hyperswitch.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hyperswitch.io/integrations/connectors-integrations/payouts/get-started-with-payouts/process-payouts-using-saved-payment-methods.md).

# Payouts with Saved Payment Methods

Juspay Hyperswitch allows you to store payment method details in a secure, PCI-compliant card vault for subsequent payout processing. By utilizing stored credentials, you can programmatically list a customer's saved methods and retrieve a `payment_token` to initiate payouts without re-collecting sensitive information.

### Tokenizing Payment Methods

Payment methods are persisted in the [Hyperswitch Vault](https://docs.hyperswitch.io/explore-hyperswitch/workflows/vault) through two primary entry points:

* Pre-transaction storage: Create a payment method for a specific customer using the [/payment\_methods API](https://api-reference.hyperswitch.io/v1/payment-methods/paymentmethods--create). This action stores details directly in the secure locker.
* Post-transaction storage: Details are automatically vaulted following a successful transaction if specific flags are set:
  * For payments: Set `"setup_future_usage": "off_session"`.
  * For payouts: Set `"recurring": true`.

### Retrieving Saved Methods

To process a payout, fetch the identifiers for a customer's saved methods via the [List Payment Methods API](https://api-reference.hyperswitch.io/v1/payment-methods/payment-method--retrieve#payment-method-retrieve). The response includes a `payment_token` required for transaction processing.

### Executing the Payout

The `payment_token` is passed in the [Payouts Create](https://api-reference.hyperswitch.io/v1/payouts/payouts--create#payouts-create) request to trigger the fund transfer using the customer's vaulted credentials.

### Setup and Integration

Utilize the Hyperswitch Dashboard and the specialized Postman collection to test vaulted payout flows.

* Sandbox Endpoint: `https://sandbox.hyperswitch.io`
* Dashboard: [app.hyperswitch.io](https://app.hyperswitch.io)
* Technical Reference: [Payouts API Reference](https://api-reference.hyperswitch.io/v1/payouts/payouts--create)

### Prerequisites

Before implementing saved payment method workflows, ensure the following:

* [Payout processors](https://docs.hyperswitch.io/explore-hyperswitch/connectors/payouts/get-started-with-payouts) are configured and active.
* An API Key is generated in the [Developers section](https://www.google.com/search?q=/docs/dashboard/developers) of the dashboard.
* The Merchant ID is retrieved from your [Dashboard home page](https://app.hyperswitch.io).

### Step-by-Step Implementation

#### Import Testing Collection

Download and import the [Saved Payment Methods Postman Collection](https://www.postman.com/hs-payouts/hyperswitch/collection/us5vnwo/payout-using-saved-payment-methods).

<figure><img src="/files/0EsSHPAPSBsoNfA39gtA" alt=""><figcaption><p>Import Postman collection</p></figcaption></figure>

#### Configure Environment

In the Variables tab of the collection, define the following global parameters:

* `baseUrl`: `https://sandbox.hyperswitch.io`
* `merchant_id`: Your unique identifier.
* `api_key`: Your secret API key.

<figure><img src="/files/fUMVE3gMMD4xWrsLUmGO" alt=""><figcaption><p>Updating env variables in Postman collection</p></figcaption></figure>

#### Direct Vaulting

Follow the sequence to create a payment method and immediately utilize the resulting token for a payout.

#### Recurring/Subsequent Payouts

Follow the sequence to list existing customer payment methods and process a payout using a previously stored token.

{% content-ref url="/pages/9DaWKBGUiGgPLNki9T8T" %}
[Smart Router for Payouts](/integrations/connectors-integrations/payouts/get-started-with-payouts/route-your-payout-transactions-using-smart-router.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hyperswitch.io/integrations/connectors-integrations/payouts/get-started-with-payouts/process-payouts-using-saved-payment-methods.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
