Authorizations
Includes an API key in the HTTP headers to authenticate the client.
Includes an API secret in the HTTP headers to authenticate the client.
Body
- Option 1
- Option 2
Request to create a new customer. Use onboardingFlow to specify the verification method: "direct" for full API-managed onboarding or "kyb_link" for third-party verification link.
The legal name of the business
1The country where the business is located
direct Basic business information required for customer creation
{
"businessTradeName": "Acme Corp",
"industry": "Technology",
"entityType": "Bank",
"website": "https://acme.com",
"registeredDate": "2024-01-01T00:00:00.000Z",
"email": "contact@acme.com",
"phone": "+1234567890",
"taxIdentificationNumber": "123456789",
"taxClassification": "LLC",
"businessEntityId": "BE001",
"naicsCode": "NAIS001",
"isFinancialInstitution": false,
"registeredAddress": {
"streetLine1": "123 Business St",
"streetLine2": "Suite 100",
"city": "New York",
"state": "NY",
"postalCode": "10001",
"country": "USA"
},
"operatingAddress": {
"streetLine1": "456 Office Ave",
"city": "New York",
"state": "NY",
"postalCode": "10002",
"country": "USA"
},
"mailingAddress": {
"streetLine1": "789 Mailing Rd",
"city": "New York",
"state": "NY",
"postalCode": "10003",
"country": "USA"
},
"isSubsidiary": false,
"isOperating": true,
"entityTaxedAs": "C-Corporation",
"anticipatedMonthlyVolume": {
"ach": { "incoming": 100000, "outgoing": 80000 },
"wire": { "incoming": 50000, "outgoing": 30000 },
"check": { "incoming": 10000, "outgoing": 5000 }
},
"expectedAverageDailyBalance": 250000,
"regulatorName": "SEC",
"hasAdvisor": true,
"businessDescription": "Provider of industrial widgets and services",
"businessEntityType": "Corporation",
"isStockExchangeListed": false,
"accountPurpose": "Payroll/ Employee Payouts",
"higRiskIndustry": "Third-party / OBO payments",
"hasNestedFlows": true,
"keyGeographicBusinessCountries": ["USA", "CAN"],
"anticipatedTransactionsVolume": 1500,
"usesBlockChainWallets": false,
"sourceOfFunds": "Sales Revenue",
"isGeneratingRevenues": true,
"hasInstitutionalInvestors": true,
"runwayDurationMonths": 12,
"cashOnHandUsd": 500000
}client Response
The created object
- Option 1
- Option 2
Customer creation response. Response shape depends on the onboardingFlow used in the request. Customer creation response for KYB link flow
kyb_link 1A valid Customer ID
"cus_2ofTA13AD0xBtbEvBl20aEb1hEu"
1
