Card to Account

Astra’s Card to Account Payment Solution

Astra’s Card to Account payment solution entails the pulling or debiting of funds from a source debit card and the crediting of funds to a client-owned destination bank account (either an omnibus account or per-user direct deposit account). Designed specifically for programs without debit cards or non-compatible debit or credit cards for instant account funding, Astra’s card-to-account solution is perfect for the following same day payment use cases: account funding, charge card pre-funding, and/or credit card balance payoffs.

📘

Note: To learn more about Same Day timelines, please reference the following NACHA guide.

Basic Setup:

Below is an outline of the basic steps for standing up a me-to-me, card-to-account transaction. In this example, we’ll describe how to connect an external debit account (Debit Card A - the “Source”) and how to register your client-issued bank account (Bank Account B - the “Destination”) to create a Card-to-Account routine. To learn more about Cards and Accounts, please reference the following chapters in our documentation:

• Cards
• Accounts

Obtain an Active Authorization:

Obtain an active authorization from each end-user through the Authorization step in our OAuth Module. This step will yield a temporary Authorization code that must be exchanged for an access_token for further API requests to Astra.

Debit Card A: Externally Linked:

For all external Debit Cards, use our OAuth Module and guide the end–user to the cards/connect screen at https://app.astra.finance/cards/connect?client_id=your_client_id&redirect_uri=your_redirect_uri to collect their Debit Card information. Astra is PCI compliant and certified.

📘

Note: Source debit cards cannot be client-issued debit cards. They must be externally linked (e.g. a User’s Chase debit card).

Bank Account B: Client-Issued

All client-issued bank accounts must be registered with Astra by way of the Create Account by Account & Routing Number endpoint. The resulting API response will include an Astra Account ID for the User’s client-issued bank account. Please see the Additional Requirements section at the end of this Guide for additional information.

📘

Note: Destination bank accounts must be client-owned. They cannot be externally linked bank accounts (e.g. connected via Plaid).

GET the IDs for Debit Card A and Bank Account B:

Retrieve the ID of Debit Card A and Bank Account B through the following endpoints:

• GET v1/cards endpoint
• GET /v1/accounts endpoint

POST a Routine:

Request POST/routines:

curl -X POST '<https://secure.api-sandbox.astra.finance/v1/routines/card-to-account'>  
  -H 'Content-Type: application/json'  
  -H 'Accept: application/json'  
  -H 'Authorization: Bearer your_access_token'  
  --data-raw '{  
    "name": "My Card-to-Account Transfer",  
    "amount": 100,  
    "client_correlation_id": “your_client_correlation_id”,  
    "source_id": "your_source_card_id",  
    "destination_id": "your_destination_account_id"  
    "debit_fee_percent": 1.25
  }'

Additional Requirements:

• Astra will need to create an FBO Account for your business at our Partner Bank.
  Fees:
  • Whether a fee is a subtractive or additive, you must clearly display to the User the fees that will be applied and the total amount they’ll be sending or receiving depending on the fee structure.
  • Notify Astra that you plan to apply fees and the date with which you plan to go-live with fees.
  • Share the percentage fee amount(s).
  • Provide Astra with a screenshot from your application's user interface, demonstrating how fees are displayed and communicated to the User.