Routines

Create a new Routine

Changed on Nov 3, 2026

📘

You can place the bearer access_token for a specific user into the Authentication section of this documentation 👉.

📘

Use this Routine resource to request Card-to-Card and Account-to-Acccount (real-time, T+0, T+1, T+2, and T+4) payments.

🚧

Used for reconciliation purposes, the client_correlation_id is a custom, alphanumeric string which gets appended to the transactions description by way of the Debit or ACH addenda. The limits are as follows:

Debit Transactions: 8 Characters

ACH Transactions: 80 Characters

RTP / FedNow Transactions: 140 Characters

This endpoint creates a new Routine for a User.

A card used as the source or the destination must be on a network enabled for your client. Cards on Discover, Diners Club, UnionPay, Maestro and private-label networks, whose card numbers begin with 6, are rejected with a 403 for clients not configured for them, whether the card is the source or the destination.

post/v1/routines

Request

Base URL
https://api-sandbox.astra.finance
URL
https://api-sandbox.astra.finance/v1/routines
Auth
HTTP bearer

Headers

Idempotency-KeyIdempotencyKey (unresolved $ref)

Request body

type'one-time' | 'recurring' required

The type of Routine

namestring required

The name given for the Routine

payment_type'ach' | 'debit' | 'ledger' required

The type of payment

source_idstring required

The ID of the Source Account

destination_idstring required

The ID of the Destination Account

destination_user_idstring

The User ID associated with the Destination Account (required if the destination_id does not belong to the authenticating User)

amountnumber float required

The amount of the transfer in USD

start_datestring date-time

Optional. The date the Routine should start processing (Pacific Timezone). If not supplied, the start_date will default to the current day (in the Pacific Timezone). Debit start dates cannot be in the future.

preferred_settlement_speed'T+1' | 'T+2' | 'T+4'

The requested settlement speed for resulting transfers

frequency'weekly' | 'bi-weekly' | 'monthly'

The frequency a repeating Routine should process

client_correlation_idstring

An optional correlation id that will be added to ACH or Debit Addenda. This will also be included in the Transfer response.

customer_debit_fee_percent_overridenumber float

Optional parameter for applying a fee to a debit transfer through either an addition on the pull or a subtraction on the push. Contact your Astra admin to configure your clients to have this percentage fee be either additive or subtractive. For debit transfers only. Example amount: 1.25 = 1.25%

ultimate_receiver_idstring

The User ID of the ultimate receiver of the Routine

ultimate_sender_idstring

The User ID of the ultimate sender of the Routine

Response

Successful response

idstring

The unique ID of the Routine

type'one-time' | 'recurring'

The type of Routine

namestring

The name given for the Routine

payment_type'ach' | 'debit' | 'ledger'

The type of payment

source_idstring

The ID of the Source Account

destination_idstring

The ID of the Destination Account

destination_user_idstring

The User ID associated with the Destination Account (required if the destination_id does not belong to the authenticating User)

amountnumber float

The amount of the transfer (when explicitly defined like one-time or recurring)

start_datestring date-time

The date the Routine should start processing.

preferred_settlement_speed'T+1' | 'T+2' | 'T+4'

The requested settlement speed for resulting transfers

frequency'weekly' | 'bi-weekly' | 'monthly'

The frequency a repeating Routine should process

activeboolean

Whether the routine is active (True) or paused (False). Defaults to True.

statusstring

The Routine's status on the platform (see Routine Statuses)

createdstring date-time

The date the Routine was created