Altan
HomeDiscordStatus
HomeDiscordStatus
  1. Payments
  • What is Altan?
  • Support Options
  • Projects
    • Create Your First Project
    • App Navigation & Settings
    • Building Tips
    • The Art of Prompting
    • Publishing Your App
    • Rollback and Checkpoints
    • Instantly Resolve Errors
  • Databases
    • Introduction
    • Security
    • Technical Overview
  • AI Agents
    • What is an AI Agent?
    • Create your first AI Agent
    • Tools
    • Interacting with Your AI Agent
    • Technical Overview
    • Altan Frontend SDK
      • Altan Frontend SDK
  • Flows
    • Create your first Flow
    • Automation basics
    • Adding modules
    • Types of modules
    • Passing data
    • Filters
    • Debugging
    • Retrigger events
    • Version History
    • Overwrite connection
    • Task credits
  • Integration
    • Magic Link
    • Altan Integrator
    • Create your integration
  • Authentication
    • Authentication
  • Payments
    • Checkout Session
    • Object Storage
  • Media
    • Media
  • Partner Program
    • Who are our Partners?
    • Partner Program Benefits
    • How to import projects into Altan
    • How to export projects from Altan
    • Work collaboratively
    • How to start on Altan
    • Become an Altan Partner
  • API Reference
    • account
      • Create Account
      • Get Account Gq
      • Get Account Public
      • Get Account Usage
      • Patch Account
      • Delete Account
      • Get Account Users
      • Create Custom Webhook
      • Create Media
      • Create Media From Url
      • Create Multiple Media
      • Create Token
      • Create Agent
      • Upsert Flow
      • Fetch User Account Notifications
      • Create Altaner
      • Get Selected Template Version
      • Get Latest Template Version
      • Get Template Version
      • Invite User
      • Create Interface
      • Get Members
      • Get Account Connections
      • Get Apikey
      • Delete Apikey
    • project
      • Get Altaner
      • Create Project V2
      • Update Altaner
      • Delete Altaner
      • Get Altaner Flows
      • Clone Altaner
      • Update Altaner Positions
      • Create Altaner Component
      • Update Altaner Component
      • Get Altaner Component
      • Atomic Update Altaner Component
      • Delete Altaner Component
      • Duplicate Altaner
      • Create Idea
    • interface
      • Start Dev Server
      • Get Dev Status
      • Send Dev Error To Agent
      • Revise Interface
      • Get Dev Errors
      • Log Error
      • Create Or Overwrite File
      • Update File
      • Create Multiple Files
      • Read File
      • Read Multiple Files
      • Delete File
      • Rename File
      • Update Files Pattern
      • Search In Files
      • Search And Replace
      • Preview Updates
      • Install Libraries
      • List Tree
      • List Tree Json
      • Get Repo Status
      • List Branches
      • Create Branch
      • Delete Branch
      • Switch Branch
      • Clone Repo
      • Merge Branch
      • Commit Changes
      • Get Diff Changes
      • Accept Changes
      • Discard Changes
      • Push Changes
      • Pull Changes
      • Reset Repo
      • Get Repo Log
      • Restore Main
      • Get Public Interface
      • Get Interface By Name
      • Get Interface
      • Update Interface
      • Delete Interface
      • Get Interface Screenshot
      • Update Interface With Ai
      • Publish Interface
      • Vercel Webhook
      • Get Deployment Status
      • Add Collaborator
      • Get Deployment Logs
      • Fix Deployment With Ai
      • Add Domain
      • Get Domains
      • Remove Domain
      • Verify Domain
      • Add Env Variables
      • Get Env Variables
      • Delete Env Variable
      • Sync Env Variables
      • Rollback Deployment
      • Get Commit Details
      • Restore To Commit
    • flows
      • modules
        • Fetch Module
        • Update Flow Module
        • Delete Module
        • Fetch Graph Module
        • Rename Module
        • Update Position In Canvas
        • Update In Edge Filter
        • Update Route Condition Filter
        • Add Condition
        • Get Available Variables For Mappings
      • hooks
        • Get Webhook
        • Update Hook
      • executions
        • Get File Signed Url
        • Stream Execution
      • Fetch Flow Execution
      • Fetch Flow
      • Update Flow
      • Delete Flow
      • Get Latest Execution
      • Fetch Flow Schema
      • Get Flow From Hook
      • Get Flow Hook
      • Fetch Flow Executions
      • Fetch Flow Executions
      • Upsert Flow Module
      • Add Flow Module
      • Create Flow Duplicate
      • Clone Flow Modules
      • Paste Flow Modules
      • Delete Modules
      • Update Edge
    • media
      • Get Media Url
      • Delete Media
      • Get Multiple Media
      • Get 3D Media
      • Delete Model
      • Create 3D Model
    • agents
      • tools
        • Patch Tool
        • Patch Tool
      • authorizaiton requests
        • Create Authorization Request
        • List Authorization Requests
        • Get Authorization Request
        • Delete Authorization Request
        • Reject Authorization Request
      • Get Altan Agents
      • List Voices
      • Get Agent
      • Update Agent
      • Delete Agent
      • Get Agent
      • Create And Add Tool To Agent
      • Remove Tool And Space
      • Get User Agent Dm Room
      • Get Agent Gate
      • Get Agent Member Usage
  1. Payments

Object Storage

Stripe Object Storage Requirements#

When to use this instruction: When ANY Stripe objects (Products, Prices, Customers, Subscriptions, Payment Intents, etc.) are created or referenced in the application.
As the Database Agent, you are responsible for maintaining complete synchronization between Stripe objects and your database tables. You MUST ensure that all Stripe object IDs are properly stored and tracked in the database to maintain data consistency and provide audit trails.

Core Database Agent Responsibilities#

1.
Stripe ID Tracking: Create and maintain database columns to store all Stripe object IDs
2.
Table Synchronization: Ensure existing UI-backed tables include Stripe object references
3.
Relationship Management: Establish proper foreign key relationships between Stripe objects and application data
4.
Status Monitoring: Track payment status and lifecycle events in the database
5.
Data Consistency: Maintain real-time synchronization between Stripe and database state
You must notify Altan Pay when a Stripe Object field in the database has been update and you must update the database when a Stripe Object has been updated

Required Database Schema Updates#

When Stripe objects are involved, you MUST add the following fields to relevant tables:
For Product-Related Tables:
stripe_product_id (singleLineText) - Store Stripe Product ID
stripe_price_id (singleLineText) - Store Stripe Price ID
stripe_metadata (json) - Store additional Stripe product metadata
For Customer-Related Tables:
stripe_customer_id (singleLineText) - Store Stripe Customer ID
stripe_payment_method_id (singleLineText) - Store default payment method ID
For Subscription-Related Tables:
stripe_subscription_id (singleLineText) - Store Stripe Subscription ID
stripe_subscription_status (singleSelect) - Track subscription status
stripe_current_period_start (dateTime) - Subscription period start
stripe_current_period_end (dateTime) - Subscription period end
For Payment-Related Tables:
stripe_payment_intent_id (singleLineText) - Store Payment Intent ID
stripe_payment_status (singleSelect) - Track payment status
stripe_amount (currency) - Store payment amount
stripe_currency (singleLineText) - Store payment currency
YOU MUST ONLY STORE VALUES EXACTLY AS PROVIDED BY ALTAN PAY FROM STRIPE. DO NOT INVENT, GUESS, OR MODIFY ANY VALUES. STRICT ADHERENCE TO THIS RULE IS MANDATORY—ANY DEVIATION IS STRICTLY FORBIDDEN.
Implementation Rules:
1.
Immediate Schema Updates: Add Stripe ID fields to existing tables that need payment integration
2.
Foreign Key Relationships: Establish proper relationships between Stripe objects and application entities
3.
Status Tracking: Use singleSelect fields to track Stripe object statuses (active, canceled, past_due, etc.)
4.
Metadata Storage: Use JSON fields to store additional Stripe object metadata
Modified at 2025-08-05 11:13:11
Previous
Checkout Session
Next
Media
Built with