Week Ending 2026-10-30
22 days ago
🚀 Now available: Unified Enrollment SDK v2: every session starts on the card number and the SDK routes each card by its program and by who is on the page. v2 is served from /unified/v2; /unified/v1 keeps serving v1, so you move when you choose.
Production
Cardholder
GET /cards/{cardId}/cardholder, expand=cardholder + cardholder.updated webhook
GET /cards/{cardId}/cardholder, expand=cardholder + cardholder.updated webhook- Amex bulk-enrolled cards now carry their Company ID as
corporate.idin production. The 6-digit Corporation ID from the Amex card file is now set on the cardholder in every environment (previously sandbox only). Rows without a valid ID leavecorporate.idout.
Card Transactions
- Visa push credits now settle at the credited amount instead of
0. A push credit arrives as a positive request confirmed by a matching negative return; the pair was netting to a settled amount of0. It now settles as a single transaction with a negative settled amount equal to the credit, whatever your refund-correlation setting. This applies to new transactions going forward. Visa return messages are also now timestamped at the end of the day they are received, the same convention as other clearing messages, so they sort after the purchase they reverse.
POST /enrollment-methods
POST /enrollment-methods- 6-digit Mastercard BINs are graded again. Since mid-October, lookups with a 6-digit Mastercard BIN were rejected before reaching Mastercard, so they were graded
bulkLikelihood: noneor returned an error. 6- and 7-digit BINs are now sent as-is; up to 11 digits are still used when you send them. - When Mastercard BIN data is unavailable, you now get a degraded answer instead of an error. The lookup is retried once, then graded from static BIN data with
bulkLikelihoodcapped atmedium(aprovenprogram staysproven). When nothing can decide the grade, the response is a200withbulkLikelihoodomitted, a new optionalunavailablefield listing it,singleEligible: trueand onlycardholder-singleoffered. Anonegrade is only returned when it was actually established.
GET /bin-lookup
GET /bin-lookup- Two Mastercard BINs are now correctly classified as corporate credit. They were labeled consumer in the reference data;
typeandcardCategorynow returnCORPORATE.
Network Bulk Enrollments
POST /network-bulk-enrollments
POST /network-bulk-enrollments- The bulk enrollment kickoff accepts an idempotency key, a card count and new dedicated scopes. An optional
requestId(uuid, unique per account) makes retries safe: repeating a request with arequestIdyou already used returns the stored enrollment with200instead of creating a second one. An optionalcardCount(1 to 1,000,000) sets the storedcardCountBandfor you; sending onlycardCountBandstill works. The kickoff now accepts thenetwork-bulk-enrollments:writeandnetwork-bulk-enrollments:readscopes, and tokens holding only thenetwork-bulk-feedsscopes are still accepted.
Network Bulk Feeds
- A feed's
updatedAtnow reflects its last change.GET, the feed list and thenetworkbulkfeed.statechangedwebhook previously kept reporting the creation time. Existing feeds update on their next change. A late failure event also no longer puts a staleerrorReasonon a feed that is alreadyACTIVE. - Re-registering a Visa file-based program after its previous feed failed or was deactivated now works. The new feed was being handed the old feed's inactive link, so its files were held and the feed never activated. The link is now re-pointed at the new feed, and files held while it was inactive are released straight away.
Banking
POST /bank-links
POST /bank-links- Refused bank link creates now carry a stable
code, and an unknown subaccount is refused. AsubaccountIdthat is not one of your account's subaccounts now returns404SUBACCOUNT_NOT_FOUNDand nothing is created; previously such a create could succeed with default settings.400and403refusals now include acodeyou can branch on (for examplePROVIDER_NOT_ENABLED_FOR_ACCOUNT,PROVIDER_NOT_SUPPORTED_FOR_COUNTRY,INVALID_LINK_FILTERS,PLAID_EC_NOT_PROVISIONED) instead of matching onmessage; status codes and messages are unchanged. The create also accepts an optionallanguage(a BCP 47 tag such asenorsv-SE) for the hosted screens. For now the screens stay in English unless Astrada has turned the language on, and the request still succeeds.
Unified Enrollment SDK v2
- SDK v2 starts every session on the card number and picks the route for you. The user types the first 8 to 11 digits and presses Continue. The welcome screen, the chooser and the v1 bulk screens are gone, and the full card number is typed only on the card form, which opens with those digits filled in. On admin pages (
persona: "admin";personahas no default, andopen()refuses a session without it), a card from a program Astrada has bulk-enrolled before opens a program screen leading to the bulk kickoff; a program that is likely bulk-capable gets an Ask Astrada to confirm callout alongside Enroll this card now; an Amex card goes to its bank link when bank linking serves Amex; other cards go to the bank link, the card form or "This card can't be enrolled here", as your settings allow. Withpersona: "cardholder"(employee pages) bulk is never shown. New events includeroute-decided,bin-disputed,company-connection-neededandbulk-confirmation-requested, andonSuccesscarriesnext. A new optionallocaleoption is accepted (English is the only language today). The kickoff sends arequestId, so a retried kickoff never creates a second request. Load v2 withhttps://sdk.astrada.co/unified/v2/unifiedEnrollmentSdk.js; never load v1 and v2 on the same page. Try it in sandbox first, fromhttps://sdk.sandbox.astrada.co/unified/v2/; your SDK client needs thenetwork-bulk-enrollments:writescope for the kickoff and the confirm request. Ask your Astrada contact for the v2 migration guide.
GET /webhooks
GET /webhooks- Listing webhooks filtered by
subaccountIdno longer times out on accounts with many webhooks. Unfiltered listing, ordering, limits and the cursor format are unchanged, and existing cursors keep working.
Sandbox
POST /simulate/ingestion/vcf
POST /simulate/ingestion/vcf- VCF simulation now finds your feed from the
networkReferenceyou created it with. A feed created with a zero-padded reference was stored without the leading zeros, so sending the original value returned400"No active feed". Both forms now resolve.
