create_seller
Create a new seller identity in Finix with complete underwriting data including business details, contact information, and financial processing requirements.
Instructions
This tool creates a new Seller Identity in Finix with full underwriting data.
Required arguments:
email (str): The email address of the seller.
first_name (str): The first name of the primary contact.
last_name (str): The last name of the primary contact.
business_name (str): The legal business name.
business_type (str): The business type (e.g., INDIVIDUAL_SOLE_PROPRIETORSHIP, CORPORATION, etc.).
business_description (str): Description of the business for underwriting.
Optional arguments include extensive business and underwriting data fields. See the schema for complete field descriptions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ach_max_transaction_amount | No | ||
| annual_ach_volume | No | ||
| annual_card_volume | No | ||
| average_ach_transfer_amount | No | ||
| average_card_transfer_amount | No | ||
| business_address | No | ||
| business_description | Yes | Description of the business for underwriting | |
| business_name | Yes | The legal business name | |
| business_phone | No | ||
| business_tax_id | No | ||
| business_type | Yes | The business type | |
| card_volume_distribution | No | ||
| credit_check_allowed | No | ||
| credit_check_ip_address | No | ||
| credit_check_timestamp | No | ||
| credit_check_user_agent | No | ||
| default_statement_descriptor | No | ||
| dob | No | ||
| doing_business_as | No | ||
| Yes | The email address of the seller | ||
| first_name | Yes | The first name of the primary contact | |
| has_accepted_credit_cards_previously | No | ||
| incorporation_date | No | ||
| last_name | Yes | The last name of the primary contact | |
| max_transaction_amount | No | ||
| mcc | No | ||
| merchant_agreement_accepted | No | ||
| merchant_agreement_ip_address | No | ||
| merchant_agreement_timestamp | No | ||
| merchant_agreement_user_agent | No | ||
| ownership_type | No | ||
| personal_address | No | ||
| phone | No | ||
| principal_percentage_ownership | No | ||
| refund_policy | No | ||
| tags | No | ||
| tax_id | No | ||
| title | No | ||
| url | No | ||
| volume_distribution_by_business_type | No |
Input Schema (JSON Schema)
{
"properties": {
"ach_max_transaction_amount": {
"type": "number"
},
"annual_ach_volume": {
"type": "number"
},
"annual_card_volume": {
"type": "number"
},
"average_ach_transfer_amount": {
"type": "number"
},
"average_card_transfer_amount": {
"type": "number"
},
"business_address": {
"properties": {
"city": {
"description": "City",
"type": "string"
},
"country": {
"default": "USA",
"type": "string"
},
"line1": {
"description": "Address line 1",
"type": "string"
},
"line2": {
"type": "string"
},
"postal_code": {
"description": "Postal/ZIP code",
"type": "string"
},
"region": {
"description": "State/Region (e.g., CA)",
"type": "string"
}
},
"required": [
"line1",
"city",
"region",
"postal_code"
],
"type": "object"
},
"business_description": {
"description": "Description of the business for underwriting",
"type": "string"
},
"business_name": {
"description": "The legal business name",
"type": "string"
},
"business_phone": {
"type": "string"
},
"business_tax_id": {
"type": "string"
},
"business_type": {
"description": "The business type",
"enum": [
"INDIVIDUAL_SOLE_PROPRIETORSHIP",
"CORPORATION",
"LIMITED_LIABILITY_COMPANY",
"PARTNERSHIP",
"ASSOCIATION",
"GOVERNMENT_AGENCY",
"OTHER"
],
"type": "string"
},
"card_volume_distribution": {
"properties": {
"card_present_percentage": {
"description": "Card present percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"ecommerce_percentage": {
"description": "Ecommerce percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"mail_order_telephone_order_percentage": {
"description": "MOTO percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"required": [
"card_present_percentage",
"mail_order_telephone_order_percentage",
"ecommerce_percentage"
],
"type": "object"
},
"credit_check_allowed": {
"type": "boolean"
},
"credit_check_ip_address": {
"type": "string"
},
"credit_check_timestamp": {
"type": "string"
},
"credit_check_user_agent": {
"type": "string"
},
"default_statement_descriptor": {
"type": "string"
},
"dob": {
"properties": {
"day": {
"description": "Birth day (1-31)",
"maximum": 31,
"minimum": 1,
"type": "integer"
},
"month": {
"description": "Birth month (1-12)",
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"year": {
"description": "Birth year",
"type": "integer"
}
},
"required": [
"year",
"month",
"day"
],
"type": "object"
},
"doing_business_as": {
"type": "string"
},
"email": {
"description": "The email address of the seller",
"type": "string"
},
"first_name": {
"description": "The first name of the primary contact",
"type": "string"
},
"has_accepted_credit_cards_previously": {
"type": "boolean"
},
"incorporation_date": {
"properties": {
"day": {
"description": "Incorporation day (1-31)",
"maximum": 31,
"minimum": 1,
"type": "integer"
},
"month": {
"description": "Incorporation month (1-12)",
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"year": {
"description": "Incorporation year",
"type": "integer"
}
},
"required": [
"year",
"month",
"day"
],
"type": "object"
},
"last_name": {
"description": "The last name of the primary contact",
"type": "string"
},
"max_transaction_amount": {
"type": "number"
},
"mcc": {
"type": "string"
},
"merchant_agreement_accepted": {
"type": "boolean"
},
"merchant_agreement_ip_address": {
"type": "string"
},
"merchant_agreement_timestamp": {
"type": "string"
},
"merchant_agreement_user_agent": {
"type": "string"
},
"ownership_type": {
"enum": [
"PRIVATE",
"PUBLIC"
],
"type": "string"
},
"personal_address": {
"properties": {
"city": {
"description": "City",
"type": "string"
},
"country": {
"default": "USA",
"type": "string"
},
"line1": {
"description": "Address line 1",
"type": "string"
},
"line2": {
"type": "string"
},
"postal_code": {
"description": "Postal/ZIP code",
"type": "string"
},
"region": {
"description": "State/Region (e.g., CA)",
"type": "string"
}
},
"required": [
"line1",
"city",
"region",
"postal_code"
],
"type": "object"
},
"phone": {
"type": "string"
},
"principal_percentage_ownership": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"refund_policy": {
"enum": [
"NO_REFUNDS",
"REFUNDS_WITH_RESTOCKING_FEE",
"MERCHANDISE_EXCHANGE_ONLY",
"FULL_REFUNDS",
"OTHER"
],
"type": "string"
},
"tags": {
"type": "string"
},
"tax_id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"volume_distribution_by_business_type": {
"properties": {
"business_to_business_volume_percentage": {
"description": "B2B percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"business_to_consumer_volume_percentage": {
"description": "B2C percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"consumer_to_consumer_volume_percentage": {
"description": "C2C percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"other_volume_percentage": {
"description": "Other percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"person_to_person_volume_percentage": {
"description": "P2P percentage",
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"required": [
"business_to_business_volume_percentage",
"business_to_consumer_volume_percentage",
"consumer_to_consumer_volume_percentage",
"person_to_person_volume_percentage",
"other_volume_percentage"
],
"type": "object"
}
},
"required": [
"email",
"first_name",
"last_name",
"business_name",
"business_type",
"business_description"
],
"type": "object"
}