Quick Start - Commercial Revolving Credit
Before diving into this setup, we recommend reviewing the following guides to ensure a smooth start:
- Commercial Revolving Credit Cards - Overview
- Configure Your Commercial Revolving Credit Card Program
Once you're ready, your implementations specialist will work with you to configure the right Credit Product to fit your use case. Lithic provides a robust suite of configuration options including interest categories, billing periods, fees, credit limits and much more.
You will complete the following steps in this guide:
- Enroll a business customer
- Set the credit configuration for that business account
- Enroll employees in that business
- Issue credit cards to those employees
- Transact
- Generate a statement
- Perform a management operation
- Make a payment
1. Enroll business customer
When your API key is provisioned and your program is set up, Lithic automatically creates a default account and ISSUING
financial accounts for your program.
To add business clients, start by creating a Business Account Holder. This step generates an associated account and an ISSUING
financial account specifically for that business.
For more details on Lithic's KYC and KYB processes, see our guides on Account Holders (Individuals) and Account Holders (Businesses).
Send a POST
request to Create Business Account Holder:
curl https://api.lithic.com/v1/account_holders
-X POST \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '
{
"workflow": "KYB_BYO",
"tos_timestamp": "2025-01-13T00:00:00Z",
"business_entity": {
"legal_business_name": "New Coffee Shop",
"government_id": "000003333",
"address": {
"address1": "456 Main Street",
"city": "New York",
"state": "NY",
"postal_code": "10128",
"country": "USA"
},
"phone_numbers": ["+15555555555"]
},
"website_url": "newcoffeeshop.com",
"kyb_passed_timestamp": "2025-01-14T00:00:00Z",
"nature_of_business":"Retail store selling coffee gear",
"control_person": {
"first_name": "Johnny",
"last_name": "AppleSeed",
"dob": "1990-06-28",
"phone_number": "+15555555555",
"email": "[email protected]",
"government_id": "000003333",
"address": {
"address1": "123 Main Street",
"postal_code": "10128",
"city": "New York",
"state": "NY",
"country": "USA"
}
},
"beneficial_owner_individuals": [
{
"first_name": "Mary",
"last_name": "AppleSeed",
"dob": "1991-06-28",
"phone_number": "+15555555556",
"email": "[email protected]",
"government_id": "000004444",
"address": {
"address1": "789 Main Street",
"postal_code": "10128",
"city": "New York",
"state": "NY",
"country": "USA"
}
}
]
}
'
Below is a sample response:
{
"account_token": "80aad00c-26e4-48d8-beaa-1d5adbb22ad5",
"status": "ACCEPTED",
"status_reasons": [],
"token": "e95ac4e2-2905-492e-9e27-88a15ed97bc9",
"created": "2025-05-23T18:38:17.471790",
"required_documents": []
}
2. Set Credit Configuration to Client’s Business Account
At this point, the issuing financial account for the business client has been created. You can view this account by sending a GET
request to List Financial Accounts.
You are now ready to associate the credit configuration to the business account you just created. You will need:
- the credit product token you received from your implementations specialist
- the credit tier you want to associate with this business, defined in the credit configuration. For this guide we will associate TIER_1 with this business account.
- credit limit you want to set for this business
To link credit configurations to the business account send a POST
request to the financial account:
curl https://api.lithic.com/v1/financial_accounts/:financial_account_token/credit_configuration
-X POST \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '
{
"credit_limit": 1000,
"credit_product_token": "2nqUhyNoCAovReAIa6HNFCsWroH",
"tier": "TIER_1"
}
'
Response:
{
"account_token": "6617a88e-d8b1-42e7-a4da-9ce4cb8923c5",
"credit_limit": 1000,
"external_bank_account_token": null,
"credit_product_token": "2nqUhyNoCAovReAIa6HNFCsWroH",
"tier": "TIER_1",
"financial_account_state": "CURRENT",
"is_spend_blocked": null
}
Notice, the financial account status is now CURRENT
. A financial account will remain PENDING
until the credit configuration is associated with the financial account.
3. Enroll Employees
Before you can issue cards, you will enroll the business's employees and link them to the business using the business_account_token
. To keep this guide simple lets assume you will enroll customer KYC exempt. You will work with you implementation specialist to support the right KYC approach for your specific use case.
Send a POST
request to Create Account Holder:
curl https://api.lithic.com/v1/account_holders
-X POST \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '
{
"workflow": "KYC_EXEMPT",
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE"
},
"business_account_token": "80aad00c-26e4-48d8-beaa-1d5adbb22ad5",
"email": "[email protected]",
"first_name": "Tom",
"kyc_exemption_type": "AUTHORIZED_USER",
"last_name": "Bombadil",
"phone_number": "+12124007676"
}
'
Response:
{
"account_token": "fabcc209-1ce8-4183-bd61-2f8c9327ec99",
"status": "ACCEPTED",
"status_reasons": [],
"token": "089834e8-5229-4f39-ae3a-914643f145a6",
"created": "2025-05-23T19:24:51.823475"
}
4. Issue credit cards to those employees
Now that you have enrolled your business customer in the program, set the credit card product config to the business account and enroll individual account holders. You can now issue cards to those account holders (employees of your business customer).
Create a card for that account holder so that they can start spending on their company credit card. All card transactions taking place on physical and virtual cards associated with the employee’s account will count against the credit limit of the overall business. Individual employees do not have their own credit limit. Instead, individual account holder spend can be managed with Lithic's spend limits Auth Rules and ASA.
Send a POST
request to Create Card to create a virtual card:
curl https://api.lithic.com/v1/cards \
-X POST \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '
{
"type": "VIRTUAL",
"memo": "New Card",
"spend_limit": 1000,
"spend_limit_duration": "TRANSACTION",
"state": "OPEN",
"account_token": "fabcc209-1ce8-4183-bd61-2f8c9327ec99" ,
}
'
Below is a sample response:
{
"created": "2025-05-23T19:28:20Z",
"token": "7b9e7666-1b54-4577-b75b-53a48052c18f",
"last_four": "4713",
"hostname": "",
"memo": "New Card",
"type": "VIRTUAL",
"exp_month": "10",
"exp_year": "2030",
"spend_limit": 1000,
"spend_limit_duration": "TRANSACTION",
"state": "OPEN",
"funding": null,
"auth_rule_tokens": [],
"replacement_for": null,
"replacement_account_token": null,
"card_program_token": "2nqUhyNoCAovReAIa6HNFCsWroH",
"account_token": "8b143846-d7a2-49cb-9163-94a3e8178e5e",
"product_id": null,
"digital_card_art_token": null,
"cardholder_currency": "USD",
"pin_status": "NOT_SET",
"pending_commands": []
}
5. Transact
As employees transact with their cards, you can view a list of transactions that have occurred with Financial Transactions. A financial transaction tells you the state of a transaction as it moves through its lifecycle and transaction events occur.
Let’s take a closer look at Financial Transactions. Assume the following events have occurred with one of your end-users:
- June 15: $20 was authorized at Merchant ABC
- June 15: $70 was authorized at Merchant XYZ
- June 16: $70 was cleared at Merchant XYZ (i.e., the transaction’s final amount was $70)
Send a GET
request to List Financial Transactions to retrieve all transactions between June 14 and June 16 2023:
curl https://api.lithic.com/v1/financial_accounts/c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6/financial_transactions?begin=2023-06-14T00%3A00%3A00&end=2023-06-17T00%3A00%3A00 \
-H "Authorization: YOUR_API_KEY"
This should return a response with two results. The first result would be the $20 authorization at Merchant ABC. It has a state of PENDING
and the pending_amount
is the full $20. The settled_amount
remains at $0 until the transaction has been finalized by the merchant.
{
"data": [
{
"category": "CARD",
"status": "PENDING",
"result": "APPROVED",
"token": "c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"settled_amount": 0,
"pending_amount": -2000,
"currency": "USD",
"events": [
{
"amount": -2000,
"type": "CARD_AUTHORIZATION",
"result": "APPROVED",
"created": "2025-06-15T17:48:48Z",
"token": "99945678-aa69-4cbc-af4p-30d90181b111"
}
],
"descriptor": "Merchant ABC",
"created": "2023-06-15T17:48:48Z",
"updated": "2023-06-15T17:48:48Z"
},
{
"category": "CARD",
"status": "SETTLED",
"result": "APPROVED",
"token": "9b8497cb-6ff7-413e-a5a8-a09c906b2b12",
"pending_amount": 0,
"settled_amount": -7000,
"currency": "USD",
"events": [
{
"amount": -7000,
"type": "AUTHORIZATION",
"result": "APPROVED",
"created": "2025-06-15T18:48:48Z",
"token": "11145678-aa69-4cbc-a946-30d90181cccc"
},
{
"amount": -7000,
"type": "CLEARING",
"result": "APPROVED",
"created": "2023-06-16T17:48:48Z",
"token": "8d4f88f0-16e9-4755-832e-b09f00c587fc"
}
],
"descriptor": "Merchant XYZ",
"created": "2023-06-15T17:48:48Z",
"updated": "2023-06-16T17:48:48Z"
}
],
"has_more": false
}
For more information on the different states of a transaction, please refer to our Financial Transactions guide. For more details on the card transaction lifecycle, please refer to our Transaction Flow guide.
As the spend occurs on the cards, it will accumulate a balance. You can check the balance of the business client's issuing financial account using Get Balances:
curl https://api.lithic.com/v1/financial_accounts/12345678-aa69-4cbc-a946-30d90181b621/balances \
-H "Authorization: YOUR_API_KEY"
Below is a sample response:
{
"data": [
{
"financial_account_type": "ISSUING",
"financial_account_token": "c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"currency": "USD",
"available_amount": 9000,
"pending_amount": -2000,
"total_amount": 7000,
"created": "2025-06-10T17:48:48Z",
"updated": "2025-06-13T17:48:48Z",
"last_transaction_token": "9b8497cb-6ff7-413e-a5a8-a09c906b2b12",
"last_transaction_event_token": "8d4f88f0-16e9-4755-832e-b09f00c587fc"
}
],
"has_more": false,
}
The available balance of -$90 indicates $90 of the $1000K credit limit has been utilized. The total amount of -$70 indicates the total settled amount that would be repaid via auto-collections
6. Generate Statements
Lithic provides the ability for customers to request statements via API. Statements are immutable. Any updates to transactions, such as a clearing of a payment, after statement has already generated will reflect in the following periods balances. For a statement to be generated the billing period needs to have elapsed.
Assume this business client is on a rolling billing period configuration. Lithic generates the data needed for you to create a statement for the business client at the end of the billing period.
To retrieve the summary details for statements, send a GET
request to List Statements:
curl https://api.lithic.com/v1/financial_accounts/c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6/statements \
-H "Authorization: YOUR_API_KEY"
Below is a sample response:
{
"token": "2jySUy6WudynALA8hvCiBXYgV3K",
"financial_account_token": "c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"statement_start_date": "2025-06-15",
"statement_end_date": "2025-07-14",
"payment_due_date": "2025-07-19",
"days_in_billing_cycle": 30,
"credit_limit": 100000,
"available_credit": 99930,
"starting_balance": 0,
"ending_balance": 0,
"amount_due": 7000,
"amount_past_due": 0,
"period_totals": {
"payments": 0,
"purchases": 70000,
"fees": 0,
"credits": 0,
"interest": 0,
"cash_advances": 0,
"balance_transfers": 0
},
"ytd_totals": {
"payments": 0,
"purchases": 70000,
"fees": 0,
"credits": 0,
"interest": 0,
"cash_advances": 0,
"balance_transfers": 0
},
"created": "2025-07-15T17:48:48Z",
"updated": "2025-07-15T17:48:48Z",
"credit_product_token": "string",
"account_standing": {
"state": "STANDARD",
"period_number": 0
}
}
Note: Lithic does not produce PDF’s of statement at this time.
7. Management Operations
Lithic gives you the ability to impact an account balance using following actions via management operations:
- charge a fee
- Issue credit (used to dispute a transactions)
- issue reward
- issue adjustment
Lets assume your customer has not paid the statement balance by the due date and you want to assess a late payment fee. Issue request below to access access the fee.
Request
{
"category": "MANAGEMENT_FEE",
"financial_account_token": "c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"amount": 100,
"effective_date": "2025-08-01",
"event_type": "LATE_PAYMENT",
"direction": "DEBIT",
"token": "21345678-aa69-4cbc-a946-30d90181cckk",
"user_defined_id": "1234"
}
Response:
{
"data": [
{
"token": "21345678-aa69-4cbc-a946-30d90181cckk",
"result": "APPROVED",
"category": "MANAGEMENT_FEE",
"status": "REVERSED",
"settled_amount": 0,
"pending_amount": 0,
"currency": "USD",
"events": [
{
"amount": -321,
"type": "CURRENCY_CONVERSION",
"subtype": "FX CAD to USD",
"result": "APPROVED",
"detailed_results": [
"APPROVED"
],
"created": "2025-10-25T15:17:36Z",
"token": "0fe33440-dc81-5c80-81f2-dce5833fddbe",
"memo": "FX fee from CAD to USD",
"effective_date": "2024-09-09"
},
{
"amount": 321,
"type": "CURRENCY_CONVERSION_REVERSAL",
"subtype": "FX CAD to USD",
"result": "APPROVED",
"detailed_results": [
"APPROVED"
],
"created": "2025-10-25T15:17:38Z",
"token": "68144c24-8a5d-5351-9bd7-8f268e526487",
"memo": "Reversed Management Fee Operation from 80e33e89-861a-554e-ad5a-32400a3f2c90",
"effective_date": "2024-09-09"
}
],
"created": "2025-10-25T15:17:36Z",
"updated": "2025-10-25T15:17:38Z",
"user_defined_id": null,
"financial_account_token": "80e33e89-861a-554e-ad5a-32400a3f2c90",
"direction": "DEBIT"
}
],
"has_more": false
}
Note: Lithic’s engineering team is currently hard at working building configuration based automated fee assessment. Expected to be launched late Q4 2024.
8. Payments
Lithic supports both native ACH rails or the ability for you to post updates to the ledger using your own payment processing capabilities. For this guide we are assuming you are using our own ACH rails to process customer card payments and you utilize Lithic’s External Payment API to update account balances.
Request
{
"category":"EXTERNAL_ACH",
"financial_account_token":"c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"amount":100,
"effective_date":"2025-09-04",
"payment_type":"DEPOSIT",
"user_defined_id": "1234"
}
Response:
{
"token": "de664ec9-547e-46ae-a65f-a8ec833985e5",
"result": "APPROVED",
"category": "EXTERNAL_ACH",
"status": "PENDING",
"settled_amount": 0,
"pending_amount": 100,
"currency": "USD",
"events": [
{
"amount": 100,
"type": "EXTERNAL_ACH_INITIATED",
"result": "APPROVED",
"detailed_results": [
"APPROVED"
],
"created": "2025-10-28T17:23:06Z",
"token": "8964eb43-8087-511b-9f79-d26f122a4f21",
"memo": "External Ach Payment to c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"effective_date": "2024-09-04"
}
],
"created": "2025-10-28T17:23:06Z",
"updated": "2025-10-28T17:23:06Z",
"user_defined_id": "1234",
"financial_account_token": "c9e61cdc-83d3-5ed5-b0a3-cf298e279ed6",
"payment_type": "DEPOSIT"
}
Congratulations & Moving Forward!
Congratulations on setting up your revolving credit program with Lithic! You’ve configured a tailored credit solution that empowers your customers and gives you full control over program settings. As your credit program grows, Lithic’s flexible platform is here to support you with ongoing adjustments, new features, and comprehensive documentation.
For any additional guidance, don’t hesitate to reach out to your implementation specialist or explore our resources for ongoing support.
Updated about 1 hour ago