# The Sources API

Learn about the different payment methods and mechanisms available through the Sources API.

> We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must [migrate them to the Payment Methods API](https://docs.stripe.com/payments/payment-methods/transitioning.md).
> 
> While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the [PaymentMethods API](https://docs.stripe.com/api/payment_methods.md), which provides access to our latest features and payment method types.

[Source](https://docs.stripe.com/api.md#sources) objects allow you to accept a variety of payment methods with a single API. A source represents a customer’s payment method, and you can use it with the Stripe API to create payments. You can charge sources directly, or attach them to customers for later reuse.

Each [payment method supported](https://docs.stripe.com/sources.md#supported-payment-methods) by the Sources API is defined by four key characteristics. The combination of these characteristics determines how a source is made chargeable, and how it’s used in a charge request to complete a payment.

- [Pull or push](https://docs.stripe.com/sources.md#pull-or-push-of-funds): How the funds for the method of payment are transferred from your customer
- [Flow](https://docs.stripe.com/sources.md#flow-for-customer-action): The type of action your customer must take to authenticate the payment
- [Usage](https://docs.stripe.com/sources.md#single-use-or-reusable): Whether the `Source` is reusable or not
- [Synchronous or asynchronous](https://docs.stripe.com/sources.md#synchronous-or-asynchronous-confirmation): Whether the resulting charge can be confirmed immediately, or only after a delay

For a complete example illustrating how to accept any payment method using the Sources API, check out this [sample e-commerce store](https://stripe-payments-demo.appspot.com), and browse its [source code on GitHub](https://github.com/stripe/stripe-payments-demo).

## Supported payment methods

You can enable any payment method available to you within the [Dashboard](https://dashboard.stripe.com/account/payments/settings). Activation is generally instantaneous, and doesn’t require additional contracts nor include a lengthy process. For a detailed listing, see the available payment methods and their [supported geographical regions](https://stripe.com/payments/payment-methods-guide#payment-methods-fact-sheets).

The following table maps the aforementioned key characteristics to the supported payment methods:

| Transfer     | Confirmation                   | None                                                                                                                                                      | Redirect                                                                   | Code verification | Receiver                |
| ------------ | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------- | ----------------------- |
| Pull         | Synchronous                    | Cards                                                                                                                                                     | —                                                                          | —                 | —                       |
| Asynchronous | SEPA Direct Debit (Deprecated) | [ACH debits with authentication](https://docs.stripe.com/ach-deprecated.md)                                                                               | [ACH debits with microdeposits](https://docs.stripe.com/ach-deprecated.md) | —                 |
| Push         | Synchronous                    | - Alipay (Deprecated)
  - Bancontact (Deprecated)
  - giropay (Deprecated)
  - iDEAL (Deprecated)
  - Przelewy24 (Deprecated)
  - WeChat Pay (Deprecated) | —                                                                          | —                 | Multibanco (Deprecated) |
| Asynchronous | —                              | Sofort with Sources (Deprecated)                                                                                                                          | —                                                                          | —                 |

## Pull or push of funds

Each method of payment is categorized as either pull or push, depending on how funds are transferred from the customer’s payment method.

- Using a *pull* method, you debit the funds from the customer’s account after the customer has provided consent. Card payments are an example of a pull method: your customer’s card is debited when a payment is made, and no customer interaction is required for subsequent debits.
- Using a *push* method, the customer sends the funds to you. ACH Credit Transfers are an example of a push method: Your customer is provided with bank routing and account numbers to which they should send (push) the correct amount. After confirmation that your customer has sent the funds to you, the source becomes chargeable, and is ready to be used in a charge request. Other push payment methods, such as iDEAL or Sofort, rely on a redirect for your customer to push the money to you directly from their online bank account. Generally, push methods require a customer interaction for each payment.

## Flow for customer action

Certain payment methods require your customer to complete a particular action (flow) before the source is chargeable. The type of flow that applies to a payment method is stated within the `Source` object’s `flow` parameter. Each method is categorized into one of the following flow types.

#### No customer action

No action is required from your customer. Some payment methods (generally *pull* methods), such as cards (excluding 3D Secure), require no additional authentication beyond collecting the payment information from customers. Sources representing this payment method can be used immediately when making charge requests.
![](https://b.stripecdn.com/docs-statics-srv/assets/02-none.7bd4a29f0be27cbb0c94a6c891af9d70.png)

#### Redirect flow

Your customer must approve the payment through a redirect (for example, to their online banking service). When creating a source for this type of payment method, the Source object contains the URL that you should redirect your customer to.
![](https://b.stripecdn.com/docs-statics-srv/assets/03-redirect.466a8131e55be32f3ad71c159edd976d.png)

#### Code verification flow

Your customer must verify ownership of their account by providing a code that you post to the Stripe API.
![](https://b.stripecdn.com/docs-statics-srv/assets/04-verification.e2d8ab4818f455c3effb00c733ba7688.png)

#### Receiver flow

Your customer must push funds to the account information provided. The `Source` object contains suitable account information to which your customer must push funds. If not fully charged, funds received by Receiver sources are charged on your behalf and credited to your balance after 60 days.
![](https://b.stripecdn.com/docs-statics-srv/assets/05-receiver.e543c092ac037bc7dbe3b0276b446d3d.png)

Once the required flow has been completed and a source becomes chargeable, the source must be used to make a charge request for the payment to be completed. If not, the source is canceled and the customer’s authenticated payment is refunded automatically—no money is moved into your account.

## Single-use or reusable

Certain payment methods allow for the creation of sources that can be reused for additional payments without your customer needing to complete the payment process again. Sources that can be reused have their `usage` parameter set to `reusable`.

Conversely, if a source can only be used once, this parameter is set to `single_use`, and a source must be created each time a customer makes a payment. Such sources shouldn’t be attached to customers—instead, they should be charged directly. They can be charged only once, and their status will change to `consumed` when charged.

Reusable sources must be attached to a [Customer](https://docs.stripe.com/api.md#customers) to be reused. (If charged directly, their status will change to `consumed`.)

## Synchronous or asynchronous confirmation

Once you use a payment method to create a [Charge](https://docs.stripe.com/api.md#charges) object, that charge’s status can be confirmed either immediately (synchronously), or after a certain amount of time (asynchronously).

- With a synchronous payment method, the charge request’s status can be immediately confirmed as either `succeeded` or `failed`. If the charge request is successful, the payment is completed—it’s considered guaranteed that the customer has been charged, and that you’ll receive the funds. Card payments are an example of a synchronous payment method: there is real-time confirmation of the payment’s success or failure.

- For *asynchronous payment methods* (Asynchronous payment methods can take up to several days to confirm whether the payment has been successful. During this time, the payment can't be guaranteed), it can take up to several days to confirm whether the payment has been successful. During this time, the payment can’t be guaranteed. The status of the payment’s `Charge` object is initially set to `pending`, until the payment has been confirmed as successful or failed. ACH debits are an example of an asynchronous method: with these debits, it takes a few days to confirm that the payment has succeeded.

Stripe sends a *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) event once a charge’s status has changed. When accepting any payment method that is asynchronous, your integration must be able to receive webhooks, so that it can receive this notification and confirm whether the customer’s payment was successful or has failed.

## See also

- [Sources API reference](https://docs.stripe.com/api.md#sources)
- [Payment methods guide](https://stripe.com/payments/payment-methods-guide)