Changelog
Published FINCI guide and API reference releases.
Guide
1.3.4
Status: Current guide version
Updated: October 30, 2026
What changed:
- Fixed webhook examples.
1.3.3
Status: Previous guide version
Updated: October 13, 2026
What changed:
- Corrected full-hold release when a matched presentment arrives.
- Clarified first and subsequent presentments for one approval.
- Aligned diagrams, the AI integration kit and partner tests with the clearing rule.
1.3.2
Status: Previous guide version
Updated: October 13, 2026
What changed:
- Fixed in-page example links in Authorization flow and Webhook amounts.
1.3.1
Status: Previous guide version
Updated: October 13, 2026
What changed:
- Generalized authorization amount-update guidance across merchant types.
- Aligned guides, diagrams and downloadable integration materials.
- Clarified partial approval and later authorization amount updates.
1.3.0
Status: Previous guide version
Updated: October 13, 2026
What changed:
- Added automatic linking guidance for related authorizations and reversals.
- Expanded clearing, refund, hold-expiry and late-event handling.
- Added reference tables for webhook amounts, FX and fees.
- Updated card issuance, status management and customer/account/card relationships.
- Added complete masked webhook downloads and interactive diagrams.
- Added an AI integration kit and partner implementation checklist.
- Clarified authorization decision responses.
- Improved Getting started, navigation, guide tables and search behavior.
1.2.0
Status: Previous guide version
Released: August 4, 2026
What changed:
Webhook handling: added the 1.10 webhook events and clarified their existing retry and idempotency expectationsSecurity and operational controls: added handling guidance for verification codes
1.1.0
Status: Previous guide version
Released: April 10, 2026
What changed:
Issuing cards: expanded theCard creation prerequisitessectionIssuing cards: clarified the setup sequence for person-based and company-based issuanceIssuing cards: added explanation of the account record and why it must exist before card creationIssuing cards: clarified identifier usage across account setup and card creation, including digit-only accountexternal_numberAuthorization flow: clarified that the account entity still exists even where balance is not used as the approval control during webhook decisioningAuthorization flow: clarified authorization outcome confirmation behavior and currentsuccess/errorresponse handling
1.0.0
Status: Previous guide version
Released: Initial developer portal publication
What changed: First publication of the FINCI Card API developer portal guides.
API references
1.11.0
Status: Current published API reference version
Released: October 6, 2026
Includes: Card API, Webhook events
Added
- optional
emailin client and employee create, update, and response models CardCumulativeas an overall card cumulative limit without a time window- optional
used_valuein card-limit update requests (the field remains in card-limit responses) - optional
original_authorization_idandoriginal_authorization_nrnin authorization webhook requests
Changed
- card-limit
used_valueis described as the current value, where applicable - the get-corporate success response is correctly labeled
Corporate info
1.10.0
Status: Previous API reference version
Released: August 4, 2026
Includes: Card API, Webhook events
Added
- added
used_valueto card-limit responses - added 3D Secure code, tokenization code, and tokenization event webhooks
Changed
- replaced the previous 3D Secure webhook path in the 1.10 reference with the new upstream 3D Secure code path
- corrected authorization
rrnto a string identifier - carried forward the enriched operation descriptions, authorization webhook guidance, and Card API validation metadata
1.9.0
Status: Previous API reference version
Released: Initial developer portal publication
Includes: Card API, Webhook events
Added
- published Card API reference in OpenAPI format
- published Webhook events reference in OpenAPI format
Changed
- API definitions migrated from Swagger to OpenAPI
- improved published Card API validation metadata for key customer, address, card, phone, and account fields