# astrada.co

> AI-optimized mirror of astrada.co containing 157 pages totalling 90,708 words of clean markdown content, structured data, and semantic HTML. Original source: https://astrada.co. Last updated: 2026-07-18T07:21:20.799Z.

Each page is available as HTML (with JSON-LD structured data) and Markdown (text-only, ideal for LLMs and RAG).

## Homepage

- [Astrada Status](/content/status/index.html) (19 words)
- [Astrada](/content/docs/index.html) (8 words)
- [Astrada — The Data Layer for Autonomous Finance](/content/site-root.html): Finance platforms in the age of AI need real-time clean, structured data from every card and every bank account. Astrada connects directly to card networks and integrates bank data — enabling your platform to fully categorize, reconcile, and close the books. (238 words)

## Articles & Blog Posts

- [data-processing-addendum/index.html](/content/data-processing-addendum/index.html) (2,917 words)
- [Mastercard BIN Lookup](/content/docs/docs/mastercard-bin-lookup/index.html): Easily check what features your Mastercard card program is eligible for. (336 words)
- [[In-Development] Enrichments](/content/docs/docs/enrichments/index.html): 
Introduction
Enrichments provides incremental detail on top of the standard data provided in a transaction. Standard card transaction data – also known as Level 1 (L1) data – consists of basic information about the transaction, such as the amount, merchant, time and card number. Depending on its ty… (812 words)
- [Issuer Guide - Visa Bulk Enrollment](/content/docs/page/issuer-guide-visa-bulk-enrollment/index.html) (1,357 words)
- [Issuer Guide - Mastercard Bulk Enrollment](/content/docs/page/mastercard-astrada-file-delivery-configuration/index.html) (722 words)
- [Card Enrollment SDK Playground](/content/sdk/v1/playground-html.html) (37 words)
- [Unified Enrollment SDK](/content/docs/docs/unified-enrollment-sdk/index.html): What you get
One embedded flow for every way a card gets enrolled. The Unified Enrollment SDK drops a single script on your page and handles all three Astrada enrollment rails behind one integration:
Card number. The cardholder types their card and 3DS verification activates it (Visa, Mastercard). B… (2,937 words)
- [Direct-API Card Enrollment Integration](/content/docs/docs/direct-api-card-enrollment-integration/index.html): Introduction
This page is the direct-API integration reference for partners who have been granted permission to enroll cards without using the Astrada Card Enrollment SDK. If you are not sure whether your integration qualifies for direct-API access, talk to your Astrada contact before relying on thi… (1,610 words)
- [Error States & Remediation](/content/docs/docs/error-states-and-remediation/index.html): Introduction
The canonical reference for every enrollment outcome: how to handle errors, the complete error-code list, what the cardholder sees, and what success looks like. SDK troubleshooting: Unhappy Paths · tier behavior: Verification Risk Tiers .
How to handle errors
Four rules cover every case… (1,944 words)
- [Real-World Transaction Scenarios](/content/docs/docs/real-world-transaction-scenario/index.html): Introduction
This page offers practical illustrations of real transaction data, showcasing how it aligns with corresponding data objects in real-world transaction scenarios. These illustrations are intended to help you understand the key data elements for your application and how they will be delive… (1,022 words)
- [Bank Linking Webhooks & Events](/content/docs/docs/bank-linking-webhooks-and-events/index.html): Introduction
Bank linking adds no new webhook types to integrate . Bank-observed money movement rides the same transactionmessage.created , transaction.created , and transaction.updated events you already handle: same schema, same handlers. On top of that, the banking service emits six dedicated eve… (1,479 words)
- [Quick Start: Bank Linking](/content/docs/docs/quick-start-bank-linking/index.html): Introduction
Bank linking unifies a cardholder's card and bank activity into one transaction stream. Once a cardholder connects their bank, the transactionmessage.created , transaction.created , and transaction.updated webhooks you already operate start carrying bank-side activity (fees, transfers, … (1,395 words)
- [Quick Start: Card Enrollment](/content/docs/docs/quick-start-card-enrollment/index.html): Introduction
This is the fastest path to enrolling a card with Astrada end to end: authenticate, point a card at a subaccount, verify the cardholder with 3DS, and activate. Each step links to the detailed guide so you can go as deep as you need.
New here? If you only read one page, read this one. It… (1,505 words)
- [Cards, Subscriptions, and Verifications](/content/docs/docs/cards/index.html): Introduction
In the Astrada ecosystem, three core resources manage the lifecycle of card enrollment and data sharing: Cards , Card Subscriptions , and Verifications .
A Card represents the physical or virtual payment card identity. A Card Subscription models the data-sharing relationship between a C… (760 words)
- [Error Page](/content/docs/docs/error-page/index.html): List of errors returned by our SDK. (1,890 words)
- [Transaction Message](/content/docs/docs/transaction-message/index.html): Introduction
Transaction Messages provide a granular insight into the behind-the-scenes activities of the payments ecosystem and correlate with specific card network messages. When a user pays for goods or services on a linked card, Astrada captures the transaction message and sends this to you in r… (494 words)
- [Verification Risk Tiers](/content/docs/docs/verification-risk-tiers/index.html): Introduction
When a cardholder links a card, Astrada verifies that they own it. You can choose how strict that verification is per subaccount, using a risk tier . A higher tier adds stronger proof of ownership at the cost of more cardholder interaction; a lower tier optimizes for conversion.
This pa… (1,617 words)
- [FAQ](/content/docs/docs/faq/index.html): This document covers the most common questions we receive from Astrada integration partners and end users. If your issue is not addressed below, please start by visiting docs.astrada.co for full technical documentation, then post in your dedicated Slack channel if needed, or reach out to our support… (1,570 words)
- [Unified Card & Bank Feeds](/content/docs/docs/unified-card-and-bank-feeds/index.html): Introduction
Astrada represents every enrolled card the same way, whether it is a Visa, Mastercard, or American Express card: a card with a durable cardId , a card subscription that announces the enrollment, and transactions that carry that cardId . What differs per network is the transport. Visa an… (823 words)
- [Test Cards & Sandbox Testing](/content/docs/docs/sandbox-testing/index.html): Introduction
Sandbox mode lets you exercise card verification (success, 3DS challenge, declines, and the HIGHEST two-hold flow ) deterministically and with no real money movement , against the production API. You enable it per subaccount, then enroll known test cards .
How it works
On a sandbox-enab… (1,372 words)
- [Installation](/content/docs/docs/web-sdk/index.html): Integration
To integrate the Card Enrollment SDK into your web application, follow these steps:
1. Loading the JS file
Begin by loading the JavaScript file provided by us. You can find it at the following URL:
<script type="text/javascript" src="https://sdk.astrada.co/v1/cardEnrollmentSdk.js" data-i… (896 words)
- [Linking Cards to Bank Accounts](/content/docs/docs/linking-cards-to-bank-accounts/index.html): Introduction
Linking a card to a connected bank account is what turns on earlier settlement for that card: when a card authorization matches a posted bank transaction on the account, the transaction flips PENDING→SETTLED on the bank's evidence, typically within hours of the swipe rather than days.
L… (896 words)
- [Network Bulk Enrollment](/content/docs/docs/network-bulk-enrollment/index.html): Network Bulk Enrollment simplifies the onboarding process for commercial card programs by allowing a company's administrator to enroll all related cards through Mastercard's Smart Data platform requiring specific setup steps to ensure data flow and continuous card management. (1,611 words)
- [Amex Bulk Enrollment Setup Guide for Corporates](/content/docs/docs/amex-bulk-enrollment-setup-guide-for-corporate/index.html): Introduction
This guide walks you through the process of setting up an American Express corporate card data feed to Astrada in order to enroll your card portfolio and share card and transaction data with your Spend Management Provider.
Step 1: Download and complete required documents Step 2: Send co… (634 words)
- [Verification Attempt Lockout](/content/docs/docs/verification-attempt-lockout/index.html): Introduction
The verification attempt lockout is an opt-in, account-scoped safeguard that throttles a card after repeated hard verification failures. It applies across every network .
This is not the HIGHEST lockout This page covers the cross-network attempt lockout for the LOW / MEDIUM / HIGH tiers… (584 words)
- [Data Sharing Consent](/content/docs/docs/data-sharing-consent/index.html): The Guiding Principle
The owner of transaction data must always provide clear and informed consent to how their data is used.
“Informed consent” means the transaction data owner, whether it be an individual cardholder or a corporate administrator, is fully informed about what data will be collected,… (913 words)
- [Webhooks](/content/docs/docs/webhooks-1/index.html): Introduction
Astrada uses webhooks to automatically notify your application when relevant events occur in your account. Webhooks can be utilized as an alternative or complement to direct API requests, in situations where you would prefer to programmatically receive information pushed to you in real-… (676 words)
- [Mastercard Bulk Enrollment Setup Guide for Corporates](/content/docs/docs/setup-guide-for-corporates/index.html): Introduction
This guide walks you through the process of setting up a Mastercard Smart Data corporate card feed to Astrada in order to bulk enroll your cards and share transaction related data with your Spend Management Provider.
Step 1 : Contact your Issuing Bank relationship manager and request yo… (1,029 words)
- [HIGHEST Verification (Two-Hold)](/content/docs/docs/highest-verification/index.html): Introduction
HIGHEST is the strictest verification risk tier . It proves card ownership with two factors :
A 3DS challenge . If the issuer challenges the cardholder, that alone is sufficient and enrollment completes. A two-hold confirmation . If the issuer instead approves frictionlessly (no challen… (578 words)
- [[Astrada - Incident Notice] Visa Single-Enrollment Service Disruption — Active Outage - Astrada Status](/content/status/incidents/01ktapn6pyy0py5k52q36t9npc/index.html) (282 words)
- [Card Enrollment Controls](/content/docs/docs/card-enrollment-controls/index.html): Configure card enrollment controls to enforce card acceptance policies at the subaccount level, including card type, funding source, and country restrictions. (514 words)
- [Single Card Enrollment: API Reference](/content/docs/docs/single-card-enrollment/index.html): Introduction
Customers with personal cards or business cards can add their cards individually. Cardholders are required to complete a verification process to ensure they are the owner of the card when they link it.
Enrollment is done with Astrada's pre-built Card Enrollment SDK . See Get the SDK and… (832 words)
- [Mastercard Upcoming Maintenance Schedule Window: - Astrada Status](/content/status/incidents/01kwj1eze53hhvs0cwq6f700ry/index.html) (175 words)
- [Week Ending 2026-07-03](/content/docs/changelog/week-ending-2026-07-03/index.html): 🚀 Now live: Astrada Sandbox (GA) — external testers can run the full enrollment → verification → transaction flow against a dedicated sandbox with test credentials, without touching production.


Sandbox environment (new)
Now live: the Astrada Sandbox is available to onboarded testers. You can now … (358 words)
- [Week Ending 2026-07-10](/content/docs/changelog/week-ending-2026-07-10/index.html): transaction.created + transaction.updated webhooks
Newly-created accounts now receive the enriched transaction payload by default. The _embedded.messages[] projection — the per-network clearing/authorization message detail behind each transaction — is now included on transaction.created and transact… (339 words)
- [Visa Bulk Enrollment Setup Guide for Corporates](/content/docs/docs/visa-data-platform-setup-guide-for-corporates/index.html): Introduction
This guide walks you through the process of setting up a corporate card data feed to Astrada in order to enroll your card portfolio and share card and transaction data with your Spend Management Provider.
Step 1: Contact your Issuing Bank relationship manager and request to set up a cor… (784 words)
- [Degraded performance on Card and Card Subscription endpoints - Astrada Status](/content/status/incidents/01kxjaxkvhtdc2hdssdpvrmava/index.html) (118 words)
- [Authentication](/content/docs/docs/authentication/index.html): Astrada uses OAuth 2.0 with two separate sets of client credentials , each scoped for a specific purpose:
Credential Set Purpose Used By API Credentials Backend API operations (subaccounts, webhooks, transactions, cards) Your server SDK Credentials Card enrollment via the Web SDK Your server + the S… (608 words)
- [Account & Subaccount Configuration](/content/docs/docs/account-and-subaccount-configuration/index.html): Two levels
Your Astrada Account is the tenant Astrada provisions for your organization, configured by Astrada based on your commercial contract. Every Subaccount you create (see Core Resources ) operates within it. The account level isn't something you call an endpoint to change yourself, but unders… (597 words)
- [Mastercard Upcoming Maintenance Schedule Window: - Astrada Status](/content/status/incidents/01ks3ncqjgg1p3zb7a6fbdr7nx/index.html) (157 words)
- [Bank Linking](/content/docs/docs/bank-linking/index.html): Introduction
Bank linking connects a cardholder's bank account (via Plaid) so their bank activity flows into the same transaction stream as their card spend . It gives you three things: net-new bank-only events (fees, transfers, payroll, loan payments, foreign-exchange markup), earlier settlement of… (482 words)
- [Transaction occurrence date on the transaction entity and webhooks](/content/docs/changelog/updated-transaction-resource/index.html): Added a new field, transactionOccurrenceDate , to indicate the date when the transaction took place, to the transaction entity and to the transaction.created and transaction.updated webhooks.
Changes
Added
transactionOccurrenceDate added to the transaction entity and to the transaction.created and t… (15 words)
- [New error returned by the SDK](/content/docs/changelog/new-error-returned-by-the-sdk/index.html): We have added a new error to the SDK Enrollment errors to indicate when a card should be enrolled via the network bulk enrollment flow.
Changes
Added
Added error Unprocessable Entity - Card should be network-bulk enrolled by the Issuer to the SDK enrollment errors

For more details, visit our SDK En… (29 words)
- [Network bulk feed resource](/content/docs/changelog/network-bulk-feed-resource/index.html): We have introduced a new resource to associate a network’s reference - like a MasterCard SmartData DeliveryID - to the subaccount. This will allow our customers to autonomously manage those associations.
Changes
Added
POST /network-bulk-feeds endpoint to create a new network bulk feed networkReferen… (154 words)
- [Troubleshooting Guide](/content/docs/docs/error-scenarios-and-troubleshooting-guide/index.html): In this guide, we cover some known errors when integrating with our SDK and the potential causes for each. (280 words)
- [Cardholder individual enrollment walkthrough](/content/docs/docs/single-card-enrollment-walkthrough/index.html): Steps in Cardholder individual enrollment via the SDK
1. Customer Introduction
The first stage we recommend in any card enrollment journey is to clearly outline to your customers the scope of the data sharing they are about to consent to and any important information about how their data will be use… (541 words)
- [New header in Webhook delivery](/content/docs/changelog/new-header-in-webhook-invocation/index.html): We have added a new header webhook-subaccount-id to the HTTP request made on each Webhook delivery. The value is the subaccountId to which the event relates.
Changes
Added
webhook-subaccount-id to every Webhook delivery (33 words)
- [Geographic Coverage ](/content/docs/docs/geographic-coverage/index.html): 
Geographic Coverage by Enrollment Method & Card Network
The following represents Astrada's current geographic coverage. Astrada has global connections with the card networks and is continually expanding its offering to new markets. If you are interested in a market that is not currently supported, … (327 words)
- [Acceptor details on  the transaction entity and webhooks](/content/docs/changelog/acceptor-information-on-the-transaction-entity/index.html): Added a new field, acceptor , which contains details relating to the acceptor (merchant) from the latest transaction message, to the transaction entity and to the transaction.created and transaction.updated webhooks.
Changes
Added
acceptor added to the transaction entity and to the transaction.creat… (15 words)
- [Visual Customization](/content/docs/docs/sdk-customization/index.html): Visual Customization
The Card Enrollment SDK supports visual customization through CSS custom properties. You can adjust colors for buttons, inputs, checkboxes, links, and overlays to match your brand.
Customization is applied using the CardEnrollmentSdk.setStyle() method, which is called independen… (289 words)
- [New field on Cardholder resource](/content/docs/changelog/corporateid-new-field-on-cardholder-resource/index.html): We've added a new field corporate.id to the Cardholder resource (only availale for bulk-enrolled cards). On Smartdata cards, the value of the field maps to the " CorporationNumber " attribute of the " CorporateEntity ".
Changes
Added
corporate.id added to the Cardholder resource. (31 words)
- [New field enrollmentGuidance returned by the SDK](/content/docs/changelog/new-field-enrollmentguidance-returned-by-the-sdk/index.html): We have added a new field to the onSuccess callback on card enrollment SDK.
Changes
Added
Added field enrollmentGuidance to the onSuccess callback on card enrollment SDK, with the following structure "enrollmentGuidance": { "availableEnrollmentMethods": [ "cardholder-single", "network-bulk" ] }
For … (33 words)
- [New link on Card Subscription resource](/content/docs/changelog/new-link-on-card-subscription-resource/index.html): We've added a new link networkBulkFeed to the Card Subscription resource.
The new link is available when a card subscription has been created via bulk enrollment, and a network bulk feed is available.
Changes
Added
networkBulkFeed link added to the Card Subscription resource. (10 words)
- [Subaccounts](/content/docs/docs/sub-accounts/index.html): Introduction
Subaccounts are a resource that allows customers to create segregations of Cards within an account and define the configurations of the Cards of those groupings.
As a Platform, our API is used by many different customers. Customers are owners of Account(s). Accounts are the primary reso… (526 words)
- [Core Resources](/content/docs/docs/core-resources/index.html): Introduction
This page maps the resource model behind the Astrada API: what each resource represents and how it relates to the others. For field-by-field contracts, see each resource's page under API Reference in the navigation.
Account
Your Account is the tenant Astrada provisions for your organiza… (642 words)
- [Enrolling Cards](/content/docs/docs/card-enrollment/index.html): Introduction
Astrada offers several methods for you to enroll cards to access transaction data. In this document, we will go through the available methods and the Astrada features and functionalities they can enable.
Enrollment Options
1. Cardholder Individual Enrollment:
Cardholder individual enrol… (436 words)
- [Cardholder Enrollment SDK](/content/docs/docs/card-enrollment-sdk/index.html): Customers with commercial cards can add their cards individually. Cardholders are required to complete a verification process to ensure they are the owner of the card when they link it.
This can be done using Astrada's pre-built Card Enrollment SDK.
This section walks you through the process and ste… (82 words)
- [Unhappy Paths](/content/docs/docs/unhappy-paths/index.html): List of unhappy paths during the enrollment journey through our SDK. (170 words)
- [Set up](/content/docs/discuss/69b749439335a9492a264d68/index.html): Hello Astrada Team,  
​My name is Alan. I have recently signed up and reviewed your API documentation. We are currently building an internal expense management tracking tool and need to start testing the Card Enrollment and Transaction flows.  
​As per your documentation, I am reaching out to request my Client ID, Client Secret, and Account ID.  
​My account email is: [alanwill@eaglearketing.co.site](mailto:alanwill@eaglearketing.co.site)  
​Could you please generate and provide these credentials so I can proceed with the integration testing?  
​Best regards,  
Alan (82 words)
- [New Discussion](/content/docs/discuss-new/index.html) (23 words)
- [Data Processing Addendum — Astrada](/content/legal/data-processing-addendum/index.html): Astrada's Data Processing Addendum (DPA). Details on how Astrada processes customer personal data in accordance with applicable data protection laws. (2,924 words)
- [Transaction](/content/docs/docs/transaction/index.html): Introduction
The Transaction is a holistic representation of a single card transaction. Unlike Transaction Messages, which offer a segmented view, the Transaction aims to provide a comprehensive overview of the entire lifecycle of a single card tap or swipe. It amalgamates all relevant messages and … (1,470 words)
- [Event Types](/content/docs/reference/event-types/index.html): Available Events
Event Name Trigger Content Sample Payload transactionmessage.created Whenever a new Transaction Message is registered in the Astrada system A complete understanding of the created Transaction Message object See here transaction.created Whenever a new Transaction is created in the As… (717 words)
- [Cookies Policy — Astrada](/content/legal/cookies-policy/index.html): Astrada's Cookies Policy. How we use cookies on www.astrada.co and how you can manage your preferences. (605 words)
- [Create subaccount](/content/docs/reference/createsubaccount/index.html): Creates a new subaccount, allowing you to set network and regional configurations.
Each network's countries can be set to either an array of specific ISO 3166 alpha-3 country codes, or the string "*" to inherit all countries from the parent account's capabilities for that network.
When using "*" , t… (1,331 words)
- [List bank transactions](/content/docs/reference/listbanktransactions/index.html): Returns a list of bank transactions for a subaccount. Bank transactions are synced from connected financial institutions. A movement may briefly appear as its pending posting until the posted transaction replaces it (the pending row is then removed from the feed).
By default, GET /bank-transactions/… (799 words)
- [List transaction matches](/content/docs/reference/listtransactionmatches/index.html): Returns a list of transaction matches for a subaccount. Each match represents a link between a bank transaction and a card transaction, along with a confidence score and the reasoning behind the match.
By default, matches are filtered to MEDIUM confidence and above. Use the minConfidence parameter t… (590 words)
- [Retrieve subaccount](/content/docs/reference/getsubaccount/index.html): Returns detailed information about a specific subaccount by its identifier, including configuration details and associated data. (1,462 words)
- [Update subaccount configurations](/content/docs/reference/updatesubaccount/index.html): Update a subaccount name and configurations. All updated configurations are validated against the capabilities of the main account to ensure compliance. It is possible to add new networks and/or regions but it is not possible to remove any configurations that were previously set.
Each network's coun… (1,725 words)
- [Retrieve bank account](/content/docs/reference/getbankaccount/index.html): Returns detailed information about a specific bank account by its identifier. (722 words)
- [List bank links](/content/docs/reference/listbanklinks/index.html): Returns a list of bank links under the account.
By default, GET /bank-links returns bank links ordered by the latest createdAt .
This endpoint supports cursor-based pagination. (731 words)
- [Retrieve bank transaction](/content/docs/reference/getbanktransaction/index.html): Returns detailed information about a specific bank transaction by its identifier, including match status and transaction metadata. (592 words)
- [List bank accounts](/content/docs/reference/listbankaccounts/index.html): Returns a list of bank accounts under the account. Bank accounts are created automatically when a bank link enrollment is completed.
By default, GET /bank-accounts returns bank accounts ordered by the latest createdAt .
This endpoint supports cursor-based pagination. (861 words)
- [Retrieve transaction match](/content/docs/reference/gettransactionmatch/index.html): Returns detailed information about a specific transaction match, including the confidence level, numeric score, and a breakdown of the scoring factors. (538 words)
- [Card Data. Bank Data. You Need Both. | Astrada Blog](/content/blog/card-data-bank-data-you-need-both/index.html): Card data gives you granularity. Bank data gives you completeness. Spend platforms that unify both close the blind spots that matter most. (679 words)
- [List card subscriptions](/content/docs/reference/listcardsubscriptions/index.html): Returns all card subscriptions under the account.
By default, GET /card-subscriptions returns card subscriptions ordered by the latest updatedAt . The cardId and subaccountId filters are mutual exclusive. The cardId takes precedence over subaccountId .
This endpoint supports offset-based pagination … (683 words)
- [Complete bank link](/content/docs/reference/patchbanklink/index.html): Completes a bank link enrollment, transitioning it from pending to completed state. The request body must contain state: "completed" .
When a bank link is completed, the system exchanges the enrollment credentials with the provider, creates a bank subscription (connection), and discovers the associa… (224 words)
- [Retrieve transaction message](/content/docs/reference/gettransactionmessagebyid/index.html): Return a transaction message by its unique identifier, including details about the transaction's type and relevant transactional data. (888 words)
- [Why Payment Data Needs a Neutral Aggregator | Astrada Blog](/content/blog/why-payment-data-needs-a-neutral-aggregator/index.html): Card transaction data is issued like a bank record but distributed like acceptance. Only a neutral aggregator can deliver the completeness the market requires. (965 words)
- [Retrieve webhook](/content/docs/reference/getwebhook/index.html): Returns detailed information about a specific webhook by its identifier, including its configuration and event subscription details. (226 words)
- [List bank subscriptions](/content/docs/reference/listbanksubscriptions/index.html): Returns a list of bank subscriptions (active connections to financial institutions) under the account.
Bank subscriptions are created automatically when a bank link enrollment is completed. Each subscription represents a connection to a single financial institution.
By default, GET /bank-subscriptio… (394 words)
- [List transactions](/content/docs/reference/gettransactions/index.html): Returns a list of all transactions under the account.
By default, GET /transactions returns transactions ordered by the latest createdAt . You can combine the different filters as documented.
This endpoint supports cursor-based pagination . (777 words)
- [List a card's 3DS verifications](/content/docs/reference/cardverificationlist/index.html): List the 3DS verifications for a card, most recent first. Use the optional state filter (e.g. state=failed ) to retrieve only failed verifications — each failed verification carries a failureReason explaining why it failed. This includes cards declined synchronously at creation (the POST returned 40… (604 words)
- [Retrieve 3DS verification](/content/docs/reference/getcardverification/index.html): Returns the current status and detailed information of a specific 3DS verification by its identifier. (742 words)
- [Trigger bank transaction webhooks](/content/docs/reference/triggerbanktransactionwebhooks/index.html): Manually triggers webhook delivery for specified bank transactions. This can be used to re-emit webhooks that may have been missed or to force re-matching of transactions.
You can specify which webhook event types to emit: banktransaction.created for transaction data or transaction.match.created for… (433 words)
- [List subaccounts](/content/docs/reference/getsubaccounts/index.html): Returns a list of all subaccounts associated with the account.
This endpoint supports cursor-based pagination . (678 words)
- [How Astrada Empowers CFOs and Businesses with Bring Your Own Card | Astrada Blog](/content/blog/how-astrada-empowers-cfos-and-businesses-with-bring-your-own-card.html): BYOC gives employees flexibility while maintaining CFO oversight. Learn how Astrada's unified API enables real-time expense tracking with any card. (337 words)
- [Astrada Raises Seed Round to Build the Data Layer for Autonomous Finance | Astrada Blog](/content/blog/astrada-seed-round-announcement/index.html): Bain Capital Ventures, QED Investors, and Nyca Partners lead the $3.8 million round, with strategic investment from Visa and Mastercard. (317 words)
- [Protect Your Company from the Rise of AI Receipt Fraud | Astrada Blog](/content/blog/protect-your-company-from-the-rise-of-ai-receipt-fraud.html): AI-generated fake receipts are fooling expense systems. Learn why transaction-based verification is replacing receipt-based validation. (322 words)
- [Why On-Time Expense Reports Matter to Finance Teams | Astrada Blog](/content/blog/why-on-time-expense-reports-matter-to-finance-teams.html): Timely expense reporting isn't just about efficiency — it's critical for cash flow, compliance, and strategic decision-making. (382 words)
- [The Case for Decoupling Spend Management from Card Issuance | Astrada Blog](/content/blog/decoupling-spend-management-from-card-issuance/index.html): The industry is shifting from bundled card-and-software models to flexible, decoupled solutions. Here's why — and what it means for spend platforms. (370 words)
- [List network bulk feed](/content/docs/reference/listnetworkbulkfeeds/index.html): Returns all network bulk feeds under the account.
By default, GET /network-bulk-feeds returns network bulk feeds ordered by the latest createdAt .
This endpoint supports offset-based pagination . (463 words)
- [Retrieve card subscription](/content/docs/reference/getcardsubscription/index.html): Returns detailed information about a specific card subscription by its identifier, including its data-sharing state. (597 words)
- [The Exciting New Applications of Transaction Data | Astrada Blog](/content/blog/the-exciting-new-applications-of-transaction-data/index.html): Transaction data extends beyond spending records — it's a catalyst for automation, fraud detection, and financial insights. (311 words)
- [Update card subscription](/content/docs/reference/updatecardsubscription/index.html): Updates an existing card subscription, allowing changes to its data-sharing state. Subscriptions that were enrolled in bulk, and where enrollmentType = 'network-bulk' cannot be updated.
Note: setting a card subscription to a deactivated state is a final action that cannot be undone. (643 words)
- [Update bank subscription webhook](/content/docs/reference/updatebanksubscriptionwebhook/index.html): Updates the webhook URL for a bank subscription. Webhook events for transactions and matches associated with this subscription will be delivered to the specified URL.
After updating, the webhook status will be set to pending until the provider acknowledges the new URL, at which point it transitions … (198 words)
- [Astrada Joins Mastercard's Start Path Program to Drive Fintech Innovation | Astrada Blog](/content/blog/astrada-joins-mastercards-start-path-program-to-drive-fintech-innovation.html): Astrada has been selected for Mastercard's Start Path New Networks program. Program alumni include Revolut, Thought Machine, and Airwallex. (131 words)
- [Retrieve a network bulk feed](/content/docs/reference/getnetworkbulkfeed/index.html): Returns detailed information about a specific network bulk feed by its identifier. (341 words)
- [Link enrolled cards to bank accounts (admin backfill)](/content/docs/reference/linkenrolledcards/index.html): Admin backfill/retry for immediate mask-linking: matches the subaccount's ENROLLED cards against its credit bank accounts by mask (an enrolled card's last 4 digits) and links each exact match. The same exactly-one-or-skip rules as completion-time linking apply — a mask matching multiple cards, or mu… (167 words)
- [Retrieve bank link](/content/docs/reference/getbanklink/index.html): Returns detailed information about a specific bank link by its identifier.
If the bank link is in pending state and the hosted link URL has expired, this endpoint will automatically refresh the URL and return the updated link. (179 words)
- [List cards](/content/docs/reference/listcards/index.html): Returns a list of all cards linked to the account.
By default, GET /cards returns cards ordered by the latest updatedAt. You can combine the different filters as documented.
This endpoint supports offset-based pagination . (232 words)
- [Update webhook](/content/docs/reference/updatewebhook/index.html): Updates the configuration of an existing webhook, allowing changes to the event subscriptions or notification URL. (289 words)
- [List webhooks](/content/docs/reference/listwebhooks/index.html): Returns all webhooks configured under the account, optionally filtered by subaccount, including details on the events each webhook is subscribed to.
This endpoint supports cursor-based pagination . (298 words)
- [Retrieve bank subscription by connection](/content/docs/reference/getbanksubscriptionbyconnection/index.html): Returns a bank subscription by its provider connection identifier (e.g. Plaid item ID).
This is useful when you have the provider's connection ID and need to look up the corresponding subscription. (78 words)
- [Create bank link](/content/docs/reference/createbanklink/index.html): Creates a new bank link to initiate a bank enrollment. The response includes a hostedLink URL where the user can connect their bank account via Plaid.
The hosted link expires after 4 hours. If the link expires before the user completes enrollment, retrieve the bank link via GET /bank-links/{bankLink… (250 words)
- [Refresh bank account](/content/docs/reference/refreshbankaccount/index.html): Triggers a refresh of bank account data from the financial institution. If the account requires re-authentication, the response will include a new hosted link URL for the user to complete re-authentication. (137 words)
- [Sync bank link](/content/docs/reference/syncbanklink/index.html): Triggers a manual sync of transactions for the bank link's associated subscription. This fetches the latest transactions from the financial institution.
Transaction syncs also occur automatically via provider webhooks and scheduled jobs. Use this endpoint to force an immediate sync when needed. (210 words)
- [Update bank link webhook](/content/docs/reference/updatebanklinkwebhook/index.html): Updates the webhook URL for a bank link. Webhook events related to this bank link and its associated resources will be delivered to the specified URL.
After updating, the webhook status will be set to pending until the provider acknowledges the new URL, at which point it transitions to confirmed . (234 words)
- [Create network bulk feed](/content/docs/reference/createnetworkbulkfeed/index.html): Registers a new feed for network bulk (248 words)
- [Delete bank account](/content/docs/reference/deletebankaccount/index.html): Deletes a bank account and all associated bank transactions and transaction matches.
Note: This action is irreversible. (135 words)
- [Retrieve card](/content/docs/reference/getcard/index.html): Returns detailed information about a specific card by its identifier. (370 words)
- [Delete bank link](/content/docs/reference/deletebanklink/index.html): Deletes a bank link and all associated resources, including the bank subscription, bank accounts, and bank transactions.
Note: This action is irreversible and will revoke access to the connected financial institution. (182 words)
- [Create webhook](/content/docs/reference/createwebhook/index.html): Registers a new webhook for capturing event notifications. (206 words)
- [API Responses](/content/docs/reference/base-api-responses/index.html): Our API returns standard HTTP status codes.
Successful requests
We use Hypertext Application Language (HAL) ( application/hal+json ) for successful responses ( 2xx ).
HAL is a standard that establishes conventions for expressing hypermedia controls, specifically through the use of _links and _embedd… (571 words)
- [Update cardholder information](/content/docs/reference/updatecardholder/index.html): Updates cardholder information for a specific card. Use this endpoint to simulate cardholder data that would typically be received through a Network Bulk Feed. This is useful for testing your integration against bulk-enrolled cards without waiting for actual network feed data.
Note: This endpoint re… (353 words)
- [The account does not support the card type](/content/docs/reference/errors-account_blocking_card_type/index.html): Description
The Card cannot be enrolled because the account does not support its type.
{ "detail": "This card type is not supported (CONSUMER card)", "title": "Forbidden", "type": "https://docs.astrada.co/reference/errors-account_blocking_card_type", "errorCode": "card_subscription.account_blocking_… (41 words)
- [Retrieve the raw transaction message](/content/docs/reference/getrawtransactionmessagebyid/index.html): Return a raw transaction message by the transaction message unique identifier. (223 words)
- [Getting Started](/content/docs/docs/getting-started-1/index.html): Getting Started
The fastest path from zero to your first transaction, and a map of how each business event becomes an API call and a webhook. Every step links out to the guide with the detail.
How enrollment works, in one picture
However a card is enrolled, it becomes the same thing: a durable cardI… (693 words)
- [Pagination](/content/docs/reference/pagination/index.html): Across our API, we provide endpoints that allow you to "list" core resources. We use cursor-based pagination and offset-based pagination. These are managed via the path parameters on the request.
As we are using Hypertext Language Application (HAL), although we have two distinct types of pagination,… (371 words)
- [The subaccount does not support the card type](/content/docs/reference/errors-subaccount_blocking_card_type/index.html): Description
The Card cannot be enrolled because the subaccount does not support its type.
{ "detail": "This card type is not supported (CONSUMER card)", "title": "Forbidden", "type": "https://docs.astrada.co/reference/errors-subaccount_blocking_card_type", "errorCode": "card_subscription.subaccount_… (42 words)
- [Card must be network-bulk enrolled by the Issuer](/content/docs/reference/errors-card_must_be_network_bulk_enrolled/index.html): Description
The Card is network-bulk eligible and can't be enrolled via the single enrollment flow.
{ "title": "Card cannot be enrolled", "detail": "Card should be network-bulk enrolled by the Issuer.", "errorCode": "card_subscription.card_must_be_network_bulk_enrolled", "type": "https://docs.astrad… (59 words)
- [The subaccount does not support the card's country of issuance](/content/docs/reference/errors-subaccount_blocking_card_country/index.html): Description
The Card cannot be enrolled because the subaccount does not support its country of issuance.
{ "detail": "The card country of issuance (CHN) is not supported", "title": "Forbidden", "type": "https://docs.astrada.co/reference/errors-subaccount_blocking_card_country", "errorCode": "card_su… (46 words)
- [The account does not support the card funding type](/content/docs/reference/errors-account_blocking_card_funding_type/index.html): Description
The Card cannot be enrolled because the account does not support its funding type.
{ "detail": "This card funding type is not supported (DEBIT card)", "title": "Forbidden", "type": "https://docs.astrada.co/reference/errors-account_blocking_card_funding_type", "errorCode": "card_subscript… (44 words)
- [Unlock a card's verification attempt lockout](/content/docs/reference/cardverificationattemptlockoutunlock/index.html): Clear the cross-network verification attempt lockout for a card, identified by its cardId . This re-enables verification attempts for the card after it has been throttled by too many recent hard failures — the account-scoped, cross-network throttle that protects the non-HIGHEST tiers (Visa/Stripe, M… (165 words)
- [Lookup card information by BIN](/content/docs/reference/binlookup/index.html): Retrieve card information such as network, type, and issuing bank by providing the card's BIN (Bank Identification Number). (156 words)
- [Authentication](/content/docs/reference/authentication/index.html): We use the OAuth 2.0 protocol for authentication and authorization, supporting the common OAuth 2.0 scenario of web server applications. This guide outlines the OAuth 2.0 client credentials flow for secure authentication, managing access tokens, and ensuring client credentials are securely maintaine… (258 words)
- [The subaccount does not support the card funding type](/content/docs/reference/errors-subaccount_blocking_card_funding_type/index.html): Description
The Card cannot be enrolled because the subaccount does not support its funding type.
{ "detail": "This card funding type is not supported (DEBIT card)", "title": "Forbidden", "type": "https://docs.astrada.co/reference/errors-subaccount_blocking_card_funding_type", "errorCode": "card_sub… (44 words)
- [List the available enrollment methods given a card BIN (BETA)](/content/docs/reference/enrollmentmethods/index.html): 🚧 Beta — This endpoint is in beta. Its results may not be accurate, so don't rely on it as a fully-supported endpoint yet.
List the available enrollment methods given a card BIN. (190 words)
- [Authorization Expiry](/content/docs/docs/authorization-expiry/index.html): Overview
Astrada does not receive real-time authorization expiry information, and the standards for expiry vary by both processor and network. Based on industry observations, we have compiled a heuristic guide to help you determine when it is safe to consider an authorization as expired in 99.9% of … (181 words)
- [Astrada Status](/content/status/history/index.html) (150 words)
- [Changelog](/content/docs/changelog/index.html) (328 words)
- [Product Coverage](/content/docs/docs/product-coverage/index.html): Astrada supports Visa and Mastercard credit and debit cards in the US, Canada, the UK, and select EU countries, but does not support non-reloadable prepaid cards, closed-loop cards, government-administered prepaid cards, or certain transaction types like indirect payments and balance transfers. (317 words)
- [Home](/content/docs/docs/home/index.html): Welcome to Astrada
Astrada is a bridge between developers and the complex world of payment data. It connects directly to major card networks for real-time transaction visibility, and to financial institutions via Plaid for bank account data. Once a card is enrolled or a bank account is connected, tr… (178 words)
- [docs/docs/index-2.html](/content/docs/docs/index-2.html) (178 words)
- [Discussions](/content/docs/discuss/index.html) (87 words)
- [Retrieve transaction](/content/docs/reference/gettransactionbyid/index.html): Returns a transaction by its unique identifier, including details about the transaction's state and relevant transactional data. (794 words)
- [Legal — Astrada](/content/legal/index.html): Astrada's Privacy Policy. Learn how we collect, store, process, and protect your personal information. (2,385 words)
- [Retrieve bank subscription](/content/docs/reference/getbanksubscription/index.html): Returns detailed information about a specific bank subscription by its identifier, including the connection state and webhook configuration. (333 words)
- [Bulk Enrollment Done Right: Inside Astrada's White Glove Process | Astrada Blog](/content/blog/bulk-enrollment-done-right-inside-astradas-white-glove-process.html): Why bulk enrollment requires more than a network connection - and how Astrada's white glove process handles bank coordination, issuer setup, and go-live. (785 words)
- [BYOC vs. Open Banking — Card Network Data vs. Bank Account Access | Astrada](/content/compare/byoc-vs-open-banking/index.html): Compare Bring Your Own Card with open banking. BYOC delivers real-time card transaction data from the network. Open banking connects to bank accounts. Different mechanisms, different strengths. (503 words)
- [Travel Management — Real-Time Card Data for Every Booking | Astrada](/content/use-cases/travel-management/index.html): Nearly half of business travel is invisible to your platform. Astrada lets travelers enroll any card — personal or corporate — and delivers real-time transaction data at authorization. (553 words)
- [Card Data vs. Bank Feeds — Real-Time Network Data vs. Aggregated Files | Astrada](/content/compare/card-data-vs-bank-feeds/index.html): Compare real-time card network data with traditional bank feed pipelines. See why structured transaction data from Visa and Mastercard delivers faster, richer data than SFTP-based bank feeds. (546 words)
- [Blog — Insights on Card Data, BYOC & Spend Management | Astrada](/content/blog/index.html): Insights on real-time card data, Bring Your Own Card, auto-reconciliation, and the future of spend management infrastructure. (285 words)
- [Security — Astrada](/content/security/index.html): Astrada is built on enterprise-grade security infrastructure. PCI DSS v4 Level 1 certified, GDPR and CCPA compliant, with end-to-end encryption on all communications. (411 words)
- [Expense Management — Real-Time Card Data from Every Card | Astrada](/content/use-cases/expense-management/index.html): Real-time card transaction data from major card networks, through a single API. Personal, commercial, and corporate credit cards — through a single integration. (494 words)
- [Introduction](/content/docs/reference/api-basics/index.html): Our API uses REST and authenticate with OAuth 2.0 access tokens. It accepts application/json request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, and verbs.
https://api.astrada.co (45 words)
- [Accounting & ERP — Zero-Day Close Requires Zero-Day Data | Astrada](/content/use-cases/accounting-erp/index.html): Real-time card data from Visa and Mastercard through a single API. Replace the bank feed pipeline with structured transaction data at authorization — not settlement. (857 words)
- [What Navan's S-1 Reveals About the Future of BYOC | Astrada Blog](/content/blog/what-navans-s1-reveals-about-the-future-of-byoc/index.html): What Navan's IPO filing reveals about the economics, infrastructure, and strategic logic behind Bring Your Own Card — and why it matters for every travel and expense platform. (1,461 words)
- [The Benefits of Bring Your Own Card for Corporations | Astrada Blog](/content/blog/the-benefits-of-bring-your-own-card-for-corporations.html): BYOC lets organizations keep existing banking relationships while choosing their preferred spend management software. (274 words)

## Products

- [Transaction Data API — Real-Time Card Data | Astrada](/content/product/transaction-data/index.html): Connect your platform directly to card networks. Get structured, real-time transaction data from any enrolled card — personal or corporate, any issuer. 10+ standard fields per transaction. (820 words)
- [Enrichment — Merchant Data & Risk Signals | Astrada](/content/product/enrichment/index.html): Astrada Enrichment resolves every card transaction to a verified merchant — persistent identity, clean names and logos, precise categories, exact location, and risk signals, delivered in real time. (733 words)
- [Auto-Reconciliation — Automated Card-to-Bank Matching | Astrada](/content/product/auto-reconciliation/index.html): Automated card-to-bank matching using structured data fields. 10+ fields per transaction make high-accuracy reconciliation possible without manual review. (495 words)

## About Pages

- [About Astrada — The Data Layer for Autonomous Finance](/content/company/about/index.html): Astrada exists because finance is going autonomous — and the platforms building it need a data layer that can keep up. Real-time, structured card transaction data from any card. (404 words)
- [Contact Astrada — Sales, Partnerships & Support](/content/company/contact/index.html): Get in touch with Astrada. Talk to sales about integrating real-time card data, apply for early access programs, or reach our support team. (223 words)

## Resources

- [Full Page Index](/index.html): Browse all cached pages with rich metadata
- [About This Cache](/content/about.html): Methodology, technical details, and usage guidelines
- [XML Sitemap](/sitemap.xml): Machine-readable sitemap for crawler discovery
- [Robots.txt](/robots.txt): Crawler directives