card.added - Finogates API Documentation

The card.added event is sent when a user has successfully added a new card to their account. At this stage, the card may require additional steps, such as image uploads or verification, before it becomes fully usable.

Example Payload

{
  "event": "card.added",
  "id": "3ba04a02-cc0f-4e0e-b46b-ed62da75df73",
  "data": {
    "user_id": "3ba04a02-cc0f-4e0e-b46b-ed62da75df73",
    "card_id": "a9ee8f8f-eefd-447e-8d70-ed7343025743",
    "status": "pending_image_upload"
  },
  "eventGeneratedTime": 1756729948.128641
}

Data Fields

string

Unique identifier of the user who added the card.

string

Unique identifier of the newly added card.

string

Current card status. For example, pending_image_upload.

Handling the Event

Use this event to:

Record the addition of a new card
Prompt the user to complete required card verification steps
Track card onboarding progress
Restrict card usage until verification is complete

​Example Payload

​Data Fields

​Handling the Event

Example Payload

Data Fields

Handling the Event