Account Number Object

An Account Number object represents the unique bank account details assigned to a customer, facilitating ACH and wire transfers.

{
  "id": "account_number_xyz123",
  "created_at": "ISO-8601",
  "updated_at": "ISO-8601",
  "status": "unassigned | active | inactive | canceled",
  "account_number": "string",
  "routing_number": "string",
  "account_id": "account_xyz123",
  "client_customer_id": "string",
  "entity_id": "entity_xyz123",
  "metadata": {}
}

Attributes

• id (string): Unique identifier for this Account Number object within Kredete's system.
• created_at (string): Timestamp indicating when the account number was created, formatted in ISO 8601.
• updated_at (string): Timestamp of the most recent update to the account number, in ISO 8601 format.
• status (enum): Current state of the account number. Possible values:
  • unassigned: Account number created but not yet linked to a customer; transfers are not permitted.
  • active: Account number assigned to a customer and eligible for transfers.
  • inactive: Temporarily ineligible for transfers; may be reactivated.
  • canceled: Permanently closed; cannot be reactivated or used for transfers.
• account_number (string): The numeric account number provided for ACH and wire transfers, typically a 12-digit value assigned by Kredete.
• routing_number (string): The routing number associated with the account, necessary for processing transfers.
• account_id (string): Identifier of the account linked to this account number for settlement purposes.
• client_customer_id (string): Your system's customer identifier, corresponding to the customer in your records.
  Note: Only one ofclient_customer_id or entity_id should be set when activating an account number.
• entity_id (string): Kredete's internal identifier for the customer entity associated with this account number.
  Note: Only one ofclient_customer_id or entity_id should be set when activating an account number.
• metadata (object): A set of key-value pairs for storing additional information related to this account number.

Account Number Statuses and Lifecycle

• unassigned: The account number is created but not yet linked to a customer; transfers are not permitted.
• active: The account number is assigned to a customer and is eligible for transfers.
• inactive: The account number has been deactivated, either by the client or by Kredete's internal policies; transfers are not permitted.
• canceled: The account number is permanently closed and cannot be reactivated or used for transfers.

Understanding the attributes and lifecycle of account numbers is essential for effective management and integration with Kredete's API services.

For more information, please refer to Kredete's API documentation or contact our support team at [email protected].