Improved

Week Ending 2026-11-06

🚀 Now live: legal entity on the cardholder (Visa VCF). Each cardholder from a Visa VCF network bulk feed now carries the legal entity it belongs to in corporate.legalEntity, alongside the company ID in corporate.id. ⚠️ Breaking: companyId has been removed from transactions and the transaction webhooks; see Card Transactions below.


Production

Card Subscriptions and Cardholders

GET /card-subscriptions/{cardSubscriptionId}?expand=card,cardholder

  • The cardholder now returns its legal entity, corporate.legalEntity (id, name), for Visa VCF feeds. It is the company in the bank's hierarchy that the card belongs to: the node directly under the root, for example one subsidiary of a group. It is also on GET /cards/{cardId}/cardholder, on expand=cardholder for transactions, and on the cardholder.updated webhook. legalEntity only appears when the bank's file includes the company hierarchy. It is absent otherwise, never null.
  • corporate.id is now documented as the company ID. It is the identifier the bank or card network gives the cardholder's company in the network bulk feed: for Visa (VCF and VBDS) the C in the feed's RPIC network reference, for Mastercard the company ID in the file (the corporation number), and for American Express the 6-digit corporate ID (CID). Every card from the same company has the same value.

GET /card-subscriptions

  • Filter card subscriptions by company and legal entity. New query parameters companyId, legalEntityId and legalEntityName match the cardholder's corporate.id, corporate.legalEntity.id and corporate.legalEntity.name as they are now, not the values when the subscription was created. Each is an exact, case-sensitive match, so copy the values from GET /card-subscriptions?expand=cardholder or GET /cards/{cardId}/cardholder. A transaction's expand=cardholder shows the cardholder as of the transaction date, which can be an earlier company or legal entity. They combine with each other and with the existing filters, for example GET /card-subscriptions?networkBulkFeedId=<feed>&legalEntityId=<id>&state=active. URL-encode the name (for example, spaces as %20 and & as %26). These filters need the cardholder:read scope; without it the request returns 403.

Card Transactions

GET /transactions and transaction webhooks

  • ⚠️ Breaking: companyId has been removed from transactions and from the transaction.created / transaction.updated webhooks. Use expand=cardholder to get the company (corporate.id) and the legal entity (corporate.legalEntity) instead.

Documentation

  • New Glossary for the account, card and bulk-enrollment terms used across the API: network reference, RPIC and PIC, company ID, legal entity, employee ID and delivery rail.
  • Clearer guidance on voided transactions and end-of-day timestamps. VOIDED is not final: a clearing can still follow a full reversal at any merchant, and the transaction then moves to SETTLED. The FAQ and the transaction message dateTime description now also list the Visa and Amex messages that carry an end-of-day 23:59:59Z value.

Sandbox

POST /simulate/transaction/scenario, POST /simulate/transactions and POST /simulate/transactions/{transactionId}

  • Visa message timestamps now match production. Visa dateTime values now carry the Z suffix, and Visa settlements and reversals are stamped 23:59:59Z on their UTC date, as production does. Before, every Visa message carried the request time with no Z. Mastercard is unchanged.