Create an ACH token

United States

The Automated Clearing House (ACH) is an electronic network for processing electronic payments between banks. To process secure ACH payments, use the API source token along with an OAuth token to complete the Ecommerce API flow.

Prerequisite

Generate an Ecommerce API key or apiAccessKey.

Steps

  1. Send a POST request to the /v1/tokens endpoint.
  2. Enter information in the required fields:
  • bank_account_number—Customer's bank account number.
  • bank_routing_number—Customer's bank routing number. A 9-digit code that identifies the transaction source of any financial institution (FI).
  • check_type —Indicates whether a bank account is a personal or a business account.
  • account_type—Indicates whether a bank account is a checking or a savings account.
  • customer_id_type—Indicates the type of customer identification document.
    Example: driver_license, ssn, tax_id, or miilitary_id
  • customer_id_state—State indicated on the customer ID, for example, NJ driver license.
  • customer_id—Value or details of the customer ID, for example, driver license number.
  • first_name—First name on the check. Required for personal check.
  • last_name—Last name on the check.
  • business_name—Business name on the check. Required for corporate check.
  • email—Customer’s email address.
  • phone—Customer’s phone number.
  • address_line1—First line of the address. Can include the street address, PO box, or company name.
  • address_city—City of the customer address. Can include district, suburb, town, or village.
  • address_state—State of the customer address. Can include county, province, or region.
  • address_zip—Postal or ZIP code of the customer address.
  • agreement—Agreement-related information.
    Note: Use the generic id for the sandbox: 2c74dcc0-61ad-4f08-8764-a29aeb98f4a4
    or for production: 4f77df6d-70c9-4f36-af1d-f8ad1ad7b0cc
  1. In the apikey header, enter the apiAccessKey from the PAKMS endpoint.
    A single-use ACH token is returned. The token is alphanumeric and begins with clv\_. Example: clv_1ABCDefgHI23jKL4m5nOPqR
  2. Use the ACH token for a single payment for charge or pay for an order.

Request and Response example—Create an ACH token

curl --request POST \
     --url 'https://token-sandbox.dev.clover.com/v1/tokens' \
     --header 'apikey: xxx' 
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
        "ach": {
                "bank_account_number": "1234567891",
                "bank_routing_number": "123456789",
                "check_type": "personal_check",
                "account_type": "checking",
                "customer_id_type": "driver_license",
                "customer_id_state": "CA",
                "customer_id": "10981111",
                "first_name": "John",
                "last_name": "Doe",
                "address_line1": "1800 Amphibious Blvd",
                "address_city": "Mountain View",
                "address_state": "CA",
                "address_zip": "94045",
                "phone": "0005550001",
                "email": "[email protected]",
                "agreement": {
                	"agreement_id": "2c74dcc0-61ad-4f08-8764-a29aeb98f4a4",
                	"type": "E_CHECK_GENERIC",
                	"locale": "en_US",
                	"template_data": "firstName:John"
                }
        },
}'
{"id": "clv_1ABCDefgHI23jKL4m5nOPQrS", "object": "token", "ach": {"account_last4": "7891", "routing_last4": "6789"}}

Related topic