---
updatedAt: 2026-10-30T10:51:20.000Z
agentTools:
  projectIndex: https://developer.spreedly.com/llms.txt
---

# ACH payments

You can add bank accounts as payment methods in Spreedly to be used with a gateway’s ACH service.&#x20;

<Callout icon="📘" theme="info">
  ### Spreedly SDKs Support ACH Fields

  Spreedly's Checkout now supports tokenizing ACH payment method information. For more information see the [Alternative Payment Methods section](https://developer.spreedly.com/docs/tokenization#alternative-payment-methods) of our Checkout documentation.&#x20;
</Callout>

The only required fields for a bank account are `full_name` (or `first_name`/`last_name`), `bank_routing_number`, and `bank_account_number`. The rest are optional at the Spreedly level, and whether you want to collect them will depend on what your gateway requires.

Currently only US and Canadian bank accounts are supported. For accounts issued by US banks, the `bank_routing_number` must be a valid [US ABA Number](https://en.wikipedia.org/wiki/ABA_routing_transit_number). For accounts issued by Canadian banks, the `bank_routing_number` should be the nine-digit electronic routing number, beginning with a zero and followed by a valid [financial institution number](https://en.wikipedia.org/wiki/Routing_number_\(Canada\)#Financial_institution_numbers).

Valid values for `bank_account_type` are `checking` and `savings`, and valid values for `bank_account_holder_type` are `personal` and `business`.

<br />

The settlement process for ACH transactions is different from credit card transaction settlements.

## Redirect Pattern

Alternatively, a custom transparent redirect form can be used like so:

```javascript
<form accept-charset="UTF-8" action="https://core.spreedly.com/v1/payment_methods" method="POST">
  <fieldset>
    <input name="redirect_url" type="hidden" value="http://example.com/transparent_redirect_complete" />
    <input name="environment_key" type="hidden" value="C7cRfNJGODKh4Iu5Ox3PToKjniY" />
    <input name="utf8" type="hidden" value="✓" />

    <input name="payment_method_type" type="hidden" value="bank_account" />

    <label for="full_name">Name</label>
    <input id="full_name" name="full_name" type="text" />

    <label for="bank_name">Bank Name</label>
    <input id="bank_name" name="bank_name" type="text" />

    <label for="bank_routing_number">Bank Routing Number</label>
    <input id="bank_routing_number" name="bank_routing_number" type="text" />

    <label for="bank_account_number">Account Number</label>
    <input id="bank_account_number" name="bank_account_number" type="text" />

    <label for="bank_account_type">Account Type</label>
    <select id="bank_account_type" name="bank_account_type">
      <options value="checking" />
      <options value="savings" />
    </select>

    <label for="bank_account_holder_type">Account Holder</label>
    <select id="bank_account_holder_type" name="bank_account_holder_type">
      <options value="personal" />
      <options value="business" />
    </select>

    <button type='submit'>Submit Payment</button>
  </fieldset>
</form>

```

```http
http://example.com/transparent_redirect_complete?token=OpUmh75ttxO1TxEg7nPhEMeiqZ6
```

## Payment Method Information

A bank account looks like this when you pull it back out:

```xml
curl https://core.spreedly.com/v1/payment_methods/OpUmh75ttxO1TxEg7nPhEMeiqZ6.xml \
  -u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
  -H 'Content-Type: application/xml'
```

```xml
<payment_method>
  <token>VX0ackf05WGJwvjkl0epp1852CL</token>
  <created_at type="dateTime">2017-07-27T17:51:37Z</created_at>
  <updated_at type="dateTime">2017-07-27T17:51:37Z</updated_at>
  <email nil="true"/>
  <data nil="true"/>
  <storage_state>cached</storage_state>
  <test type="boolean">true</test>
  <full_name>Bob Smith</full_name>
  <bank_name>First Bank of Elbonia</bank_name>
  <account_type>checking</account_type>
  <account_holder_type>personal</account_holder_type>
  <routing_number_display_digits>021</routing_number_display_digits>
  <account_number_display_digits>3210</account_number_display_digits>
  <first_name>Bob</first_name>
  <last_name>Smith</last_name>
  <address1 nil="true"/>
  <address2 nil="true"/>
  <city nil="true"/>
  <state nil="true"/>
  <zip nil="true"/>
  <country nil="true"/>
  <phone_number nil="true"/>
  <company nil="true"/>
  <payment_method_type>bank_account</payment_method_type>
  <errors>
  </errors>
  <routing_number>021*</routing_number>
  <account_number>*3210</account_number>
</payment_method>
```

## Example Purchase

Once you have a bank account payment method, you can run a purchase like so:

```xml
curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/purchase.xml \
  -u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
  -H 'Content-Type: application/xml' \
  -d '<transaction>
        <payment_method_token>VX0ackf05WGJwvjkl0epp1852CL</payment_method_token>
        <amount>100</amount>
        <currency_code>USD</currency_code>
    </transaction>'
```

```xml
<transaction>
  <on_test_gateway type="boolean">true</on_test_gateway>
  <created_at type="dateTime">2017-07-27T17:53:07Z</created_at>
  <updated_at type="dateTime">2017-07-27T17:53:07Z</updated_at>
  <succeeded type="boolean">true</succeeded>
  <state>succeeded</state>
  <token>Bsj7WKWGvkADanTqndkDTZbYW76</token>
  <transaction_type>Purchase</transaction_type>
  <order_id nil="true"/>
  <ip nil="true"/>
  <description nil="true"/>
  <email nil="true"/>
  <merchant_name_descriptor nil="true"/>
  <merchant_location_descriptor nil="true"/>
  <gateway_specific_fields nil="true"/>
  <gateway_specific_response_fields>
  </gateway_specific_response_fields>
  <gateway_transaction_id>45</gateway_transaction_id>
  <gateway_latency_ms type="integer">0</gateway_latency_ms>
  <amount type="integer">100</amount>
  <currency_code>USD</currency_code>
  <retain_on_success type="boolean">false</retain_on_success>
  <payment_method_added type="boolean">false</payment_method_added>
  <message key="messages.transaction_succeeded">Succeeded!</message>
  <gateway_token>T11bJAANtTWnxl36GYjKWvbNK0g</gateway_token>
  <shipping_address>
    <name nil="true"/>
    <address1 nil="true"/>
    <address2 nil="true"/>
    <city nil="true"/>
    <state nil="true"/>
    <zip nil="true"/>
    <country nil="true"/>
    <phone_number nil="true"/>
  </shipping_address>
  <response>
    <success type="boolean">true</success>
    <message>Successful purchase</message>
    <avs_code nil="true"/>
    <avs_message nil="true"/>
    <cvv_code nil="true"/>
    <cvv_message nil="true"/>
    <pending type="boolean">false</pending>
    <result_unknown type="boolean">false</result_unknown>
    <error_code></error_code>
    <error_detail nil="true"/>
    <cancelled type="boolean">false</cancelled>
    <fraud_review nil="true"/>
    <created_at type="dateTime">2017-07-27T17:53:07Z</created_at>
    <updated_at type="dateTime">2017-07-27T17:53:07Z</updated_at>
  </response>
  <api_urls>
  </api_urls>
  <payment_method>
    <token>FUbGgOeOdo1mT7j7Tndmz6zfdRg</token>
    <created_at type="dateTime">2017-07-27T17:53:06Z</created_at>
    <updated_at type="dateTime">2017-07-27T17:53:06Z</updated_at>
    <email nil="true"/>
    <data nil="true"/>
    <storage_state>cached</storage_state>
    <test type="boolean">true</test>
    <full_name>Bob Smith</full_name>
    <bank_name>First Bank of Elbonia</bank_name>
    <account_type>checking</account_type>
    <account_holder_type>personal</account_holder_type>
    <routing_number_display_digits>021</routing_number_display_digits>
    <account_number_display_digits>3210</account_number_display_digits>
    <first_name>Bob</first_name>
    <last_name>Smith</last_name>
    <address1 nil="true"/>
    <address2 nil="true"/>
    <city nil="true"/>
    <state nil="true"/>
    <zip nil="true"/>
    <country nil="true"/>
    <phone_number nil="true"/>
    <company nil="true"/>
    <payment_method_type>bank_account</payment_method_type>
    <errors>
    </errors>
    <routing_number>021*</routing_number>
    <account_number>*3210</account_number>
  </payment_method>
</transaction>
```

<br />

## ACH gateways

You can add bank accounts as payment methods in Spreedly to be used with a gateway’s ACH service. We currently support ACHs at the following gateways:

| Supported gateways:                                                                 |
| :---------------------------------------------------------------------------------- |
| [Adyen](https://developer.spreedly.com/docs/adyen-gateway-guide)                                                    |
| [Authorize.net](https://developer.spreedly.com/docs/authorize-net-gateway-guide)                                    |
| [BluePay](https://developer.spreedly.com/docs/blue-pay-gateway-guide)                                               |
| [BlueSnap](https://developer.spreedly.com/docs/blue-snap-gateway-guide)                                             |
| [Braintree](https://developer.spreedly.com/docs/braintree-gateway-guide)                                            |
| [BridgePay](https://developer.spreedly.com/docs/bridge-pay-gateway-guide)                                           |
| [CardConnect](https://developer.spreedly.com/docs/card-connect-gateway-guide)       |
| [CyberSource](https://developer.spreedly.com/docs/cyber-source-gateway-guide)                                       |
| [CyberSource REST](https://developer.spreedly.com/docs/cyber-source-rest-gateway-guide)                             |
| [Diamond Mind](https://developer.spreedly.com/docs/diamond-mind-gateway-guide)                                      |
| [Elavon](https://developer.spreedly.com/docs/elavon-gateway-guide)                  |
| [Forte](https://developer.spreedly.com/docs/forte-gateway-guide)                                                    |
| [Heartland Payment Systems](https://developer.spreedly.com/docs/hps-gateway-guide)                                  |
| [iATS Payments](https://developer.spreedly.com/docs/iats-payments-gateway-guide)                                    |
| [Vantiv eCommerce](https://developer.spreedly.com/docs/litle-gateway-guide)                                         |
| [Vantiv Express](https://developer.spreedly.com/docs/element-gateway-guide)                                         |
| [NMI](https://developer.spreedly.com/docs/nmi-gateway-guide)                                                        |
| [Orbital](https://developer.spreedly.com/docs/orbital-gateway-guide)                                                |
| [PayConex](https://developer.spreedly.com/docs/pay-conex-gateway-guide)                                             |
| [PayFabric](https://developer.spreedly.com/docs/payfabric-gateway-guide)                                            |
| [PayTrace](https://developer.spreedly.com/docs/pay-trace-gateway-guide)                                             |
| [Payeezy](https://developer.spreedly.com/docs/payeezy-gateway-guide)                                                |
| [Rapyd](https://developer.spreedly.com/docs/rapyd-gateway-guide)                                                    |
| [Sage Payment Solutions](https://developer.spreedly.com/docs/sage-gateway-guide)                                    |
| [Stripe](https://developer.spreedly.com/docs/stripe-gateway-guide)                                                  |
| [Stripe Payment Intents](https://developer.spreedly.com/docs/stripe-payment-intents-gateway-guide)                  |
| [Spreedly Test](https://developer.spreedly.com/docs/test-gateway-guide)                                             |
| [TransFirst](https://developer.spreedly.com/docs/trans-first-gateway-guide)                                         |
| [TransFirst Transaction Express](https://developer.spreedly.com/docs/trans-first-transaction-express-gateway-guide) |
| [TrustCommerce](https://developer.spreedly.com/docs/trust-commerce-gateway-guide)                                   |
| [USA ePay](https://developer.spreedly.com/docs/usa-epay-gateway-guide)                                              |
| [Vanco](https://developer.spreedly.com/docs/vanco-gateway-guide)                                                    |
| [Worldpay](https://developer.spreedly.com/docs/worldpay-gateway-guide)              |
| [Worldpay REST](https://developer.spreedly.com/docs/worldpay-rest-gateway-guide)    |
| [WorldPay US](https://developer.spreedly.com/docs/worldpay-us-gateway-guide)                                        |