Start Here
/
Getting Started

Getting Started

FINCI Card API is for approved organizations that operate or support card programs on FINCI issuing infrastructure.

This portal is for the backend, product, and operations teams responsible for integrating those card capabilities into their own platforms or operating environments.

It is not a public self-service API. Access is available only within an approved FINCI program relationship.

In these guides, integrator means the approved organization implementing and operating the FINCI APIs and webhooks for a given program. Depending on the program model, the integrator may be a FINCI partner, a FINCI client, or another approved organization responsible for the integration.

Who this portal is for

This documentation is for organizations that use FINCI as their issuing and card-program infrastructure provider.

For the best reading path, review the target program model and supported services first, then move into the data model, issuance flow, and transaction handling guides.

Use this page for portal orientation and the implementation journey. Use the Program Models guide for program structures, platform capabilities, optional services, and responsibility split.

What this portal covers

This portal is written for FINCI card programs delivered on the same issuing and processing foundation, including BIN sponsorship, co-branded programs, crypto MiCA-compliant programs, and API-led commercial card programs.

Some guides apply across all supported program structures. Others become relevant only when the agreed scope includes capabilities such as physical issuance, wallets, 3D Secure, integrator-managed authorization decisioning, or Payments API-based reconciliation.

Review the Program Models guide first to confirm which parts of the portal apply to the target implementation.

Integration at a glance

FINCI acts as the issuing and program infrastructure platform.

  • FINCI exposes APIs for setup and lifecycle management.
  • FINCI delivers webhooks for authorization and transaction events.
  • Where integrator-managed decisioning is used, those webhooks also carry real-time authorization decision requests.
  • The integrator connects its own platform, controls, and operational processes around that core card infrastructure.

The detailed authorization guides describe the integrator-managed decisioning path first, because that is the default integration pattern for most API-led programs. Some programs may instead use FINCI-managed decisioning as part of the agreed decisioning model.

Integration surfaces

This portal separates the integration into two surfaces:

  • Card API Outbound REST requests from the integrator platform to FINCI for program setup, account management, and card lifecycle operations.
  • Webhooks Inbound webhooks from FINCI to the integrator for real-time authorization and transaction updates.

System overview

The diagram below reflects one API-driven integration pattern used across FINCI card programs.

FINCI integration flow

Implementation Journey

  1. Confirm the target program model, selected FINCI services, and operating split for the implementation.
  2. Start the non-technical onboarding process through https://www.finci.com/open/.
  3. Complete FINCI onboarding and compliance review for the target program.
  4. Receive sandbox access and authentication materials, and complete sandbox IP whitelisting for the integrator environment.
  5. Configure API authentication and webhook connectivity in the sandbox environment, with support from the FINCI integration team where needed.
  6. Implement the core setup flow for the target program and data model.
  7. Implement the agreed authorization flow and, where applicable, real-time decisioning through FINCI webhooks.
  8. Implement the transaction event handling required for the agreed program scope.
  9. Complete sandbox validation and confirm successful integration testing.
  10. Submit the signed production access confirmation document together with the required production IP whitelist details for live access.
  11. Receive production approval and live environment access from FINCI.

In FINCI internal process references, that production access confirmation document may be referred to as the Transfer Acceptance Note.

Synchronous versus asynchronous work

The integration combines two modes:

  • Synchronous Card API requests for setup and management actions.
  • Asynchronous Webhook deliveries for authorization decisions and transaction updates.
Built with