Improved
Week Ending 2026-11-06
19 days ago
🚀 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
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 onGET /cards/{cardId}/cardholder, onexpand=cardholderfor transactions, and on thecardholder.updatedwebhook.legalEntityonly appears when the bank's file includes the company hierarchy. It is absent otherwise, nevernull. corporate.idis 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) theCin 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
GET /card-subscriptions- Filter card subscriptions by company and legal entity. New query parameters
companyId,legalEntityIdandlegalEntityNamematch the cardholder'scorporate.id,corporate.legalEntity.idandcorporate.legalEntity.nameas they are now, not the values when the subscription was created. Each is an exact, case-sensitive match, so copy the values fromGET /card-subscriptions?expand=cardholderorGET /cards/{cardId}/cardholder. A transaction'sexpand=cardholdershows 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 exampleGET /card-subscriptions?networkBulkFeedId=<feed>&legalEntityId=<id>&state=active. URL-encode the name (for example, spaces as%20and&as%26). These filters need thecardholder:readscope; without it the request returns403.
Card Transactions
GET /transactions and transaction webhooks
GET /transactions and transaction webhooks- ⚠️ Breaking:
companyIdhas been removed from transactions and from thetransaction.created/transaction.updatedwebhooks. Useexpand=cardholderto 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.
VOIDEDis not final: a clearing can still follow a full reversal at any merchant, and the transaction then moves toSETTLED. The FAQ and the transaction messagedateTimedescription now also list the Visa and Amex messages that carry an end-of-day23:59:59Zvalue.
Sandbox
POST /simulate/transaction/scenario, POST /simulate/transactions and POST /simulate/transactions/{transactionId}
POST /simulate/transaction/scenario, POST /simulate/transactions and POST /simulate/transactions/{transactionId}- Visa message timestamps now match production. Visa
dateTimevalues now carry theZsuffix, and Visa settlements and reversals are stamped23:59:59Zon their UTC date, as production does. Before, every Visa message carried the request time with noZ. Mastercard is unchanged.
