Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.finogates.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
user_id
string
Unique identifier of the user who added the card.
​
card_id
string
Unique identifier of the newly added card.
​
status
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