Counterparties
Create a Counterparty
Getting Started
Master Accounts
Sub Account Holders
Sub Accounts
Counterparties
Card Holders
Cards
Transactions
- GETList all Transactions
- POSTSub Ledger a Transaction
- POSTOriginate an Intra Account Push
- POSTOriginate an Intra Account Pull
- POSTOriginate an ACH Push
- POSTOriginate an ACH Pull
- POSTOriginate a Domestic Wire
- POSTOriginate an International Wire
- POSTOriginate an RTP Push
- POSTOriginate a FedNow Push
- POSTOriginate a Debit Card Push
- POSTOriginate a Debit Card Pull
- POSTOriginate a Check Send
- POSTOriginate a Check Deposit
- GETRetrieve a Transaction
- PATCHUpdate a Transaction
Attachments
Webhooks
Counterparties
Create a Counterparty
Create a Counterparty
POST
/
v2
/
payments
/
counterparty
curl --request POST \
--url https://api.sandbox.solidfi.com/v2/payments/counterparty \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
"sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
"label": "Development Vendor",
"type": "person",
"person": {
"first_name": "John",
"last_name": "Doe",
"id_type": "ssn",
"id_number": "223902234",
"date_of_birth": "1974-01-25",
"phone": "+19418405843",
"email": "john.doe@gmail.com",
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
},
"intra_account": {
"sub_account_number": "95483674098723",
"sub_account_id": "sub_cda1e562657c41e553104b10aad3fe70"
},
"ach": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"rtp": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"domestic_wire": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo"
},
"international_wire": {
"account_number": "920020006167511",
"beneficiary_bank": {
"identifier_code": "ICICINBBNRI",
"name": "ICICI Bank",
"address": {
"line1": "256 Main St",
"line2": "",
"city": "Bengaluru",
"state": "KA",
"country": "IN",
"postal_code": "900009"
}
},
"correspondent_bank": {
"identifier_code": "SCBLUS33XXX",
"name": "STANDARD CHARTERED BANK",
"address": {
"line1": "1095 12th Ave",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
}
},
"purpose": "Offshore dev center",
"external_reference_id": "TW-9L1L2-UVV",
"metadata": {
"vendor_id": "VID-0987ACR"
}
}'
{
"id": "ctp_8e5541c8a9e50c3af3b0daacf9175130",
"client_id": "cli_64c6c87ee9d609f36a6f390dc378a4ce",
"master_account_holder_id": "mah_201e02c581a098a740456c5c19fcfcd6",
"master_account_id": "mas_743fa071316bc6beaf5dddfd05f49c30",
"sub_account_holder_id": "sah_5ccfeef0adf0cbe2aa0980d2c9505752",
"sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
"label": "Development Vendor",
"type": "person",
"person": {
"first_name": "John",
"last_name": "Doe",
"id_type": "ssn",
"id_number": "223902234",
"date_of_birth": "1974-01-25",
"phone": "+19418405843",
"email": "john.doe@gmail.com",
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
},
"intra_account": {
"sub_account_number": "95483674098723",
"sub_account_id": "sub_cda1e562657c41e553104b10aad3fe70"
},
"ach": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"domestic_wire": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo"
},
"international_wire": {
"account_number": "920020006167511",
"beneficiary_bank": {
"identifier_code": "ICICINBBNRI",
"name": "ICICI Bank",
"address": {
"line1": "256 Main St",
"line2": "",
"city": "Bengaluru",
"state": "KA",
"country": "IN",
"postal_code": "900009"
}
},
"correspondent_bank": {
"identifier_code": "SCBLUS33XXX",
"name": "STANDARD CHARTERED BANK",
"address": {
"line1": "1095 12th Ave",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
}
},
"rtp": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"fednow": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"check": {
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
},
"debit_card": {
"card_number": "tok_live_6GVyHuQR7aAjCZivYzLbuP_9990",
"last4": "9990",
"expiry_month": "10",
"expiry_year": "2024",
"cvv": "tok_live_6GVyHuQR7aAjCZivYzLbuP_9990",
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
},
"pull_enabled": true,
"push_enabled": true
},
"purpose": "Offshore dev center",
"external_reference_id": "TW-9L1L2-UVV",
"ofac": {
"status": "pass",
"last_updated_at": "2024-04-01T21:00:00Z"
},
"attachments": [
{
"label": "Dev Contract",
"id": "att_a8d2b191fa0e960d8e49a4bfd320e07b",
"created_at": "2024-04-01T21:00:00Z"
}
],
"metadata": {
"vendor_id": "VID-0987ACR"
},
"status": "activated",
"timestamps": {
"created_at": "2024-04-01T21:00:00Z",
"updated_at": "2024-04-01T21:00:00Z"
}
}
Headers
API key is required to call Solid APIs. You can view and manage your API keys in the Solid dashboard.
Example:
"{{api_key}}"
Body
application/json
Response
201
application/json
Create a Counterparty
The response is of type object
.
curl --request POST \
--url https://api.sandbox.solidfi.com/v2/payments/counterparty \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
"sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
"label": "Development Vendor",
"type": "person",
"person": {
"first_name": "John",
"last_name": "Doe",
"id_type": "ssn",
"id_number": "223902234",
"date_of_birth": "1974-01-25",
"phone": "+19418405843",
"email": "john.doe@gmail.com",
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
},
"intra_account": {
"sub_account_number": "95483674098723",
"sub_account_id": "sub_cda1e562657c41e553104b10aad3fe70"
},
"ach": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"rtp": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"domestic_wire": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo"
},
"international_wire": {
"account_number": "920020006167511",
"beneficiary_bank": {
"identifier_code": "ICICINBBNRI",
"name": "ICICI Bank",
"address": {
"line1": "256 Main St",
"line2": "",
"city": "Bengaluru",
"state": "KA",
"country": "IN",
"postal_code": "900009"
}
},
"correspondent_bank": {
"identifier_code": "SCBLUS33XXX",
"name": "STANDARD CHARTERED BANK",
"address": {
"line1": "1095 12th Ave",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
}
},
"purpose": "Offshore dev center",
"external_reference_id": "TW-9L1L2-UVV",
"metadata": {
"vendor_id": "VID-0987ACR"
}
}'
{
"id": "ctp_8e5541c8a9e50c3af3b0daacf9175130",
"client_id": "cli_64c6c87ee9d609f36a6f390dc378a4ce",
"master_account_holder_id": "mah_201e02c581a098a740456c5c19fcfcd6",
"master_account_id": "mas_743fa071316bc6beaf5dddfd05f49c30",
"sub_account_holder_id": "sah_5ccfeef0adf0cbe2aa0980d2c9505752",
"sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
"label": "Development Vendor",
"type": "person",
"person": {
"first_name": "John",
"last_name": "Doe",
"id_type": "ssn",
"id_number": "223902234",
"date_of_birth": "1974-01-25",
"phone": "+19418405843",
"email": "john.doe@gmail.com",
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
},
"intra_account": {
"sub_account_number": "95483674098723",
"sub_account_id": "sub_cda1e562657c41e553104b10aad3fe70"
},
"ach": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"domestic_wire": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo"
},
"international_wire": {
"account_number": "920020006167511",
"beneficiary_bank": {
"identifier_code": "ICICINBBNRI",
"name": "ICICI Bank",
"address": {
"line1": "256 Main St",
"line2": "",
"city": "Bengaluru",
"state": "KA",
"country": "IN",
"postal_code": "900009"
}
},
"correspondent_bank": {
"identifier_code": "SCBLUS33XXX",
"name": "STANDARD CHARTERED BANK",
"address": {
"line1": "1095 12th Ave",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
}
},
"rtp": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"fednow": {
"account_number": "98324502",
"routing_number": "121042882",
"account_type": "business_checking",
"bank_name": "Wells Fargo",
"verification_status": "pass"
},
"check": {
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
}
},
"debit_card": {
"card_number": "tok_live_6GVyHuQR7aAjCZivYzLbuP_9990",
"last4": "9990",
"expiry_month": "10",
"expiry_year": "2024",
"cvv": "tok_live_6GVyHuQR7aAjCZivYzLbuP_9990",
"address": {
"line1": "123 Main St",
"line2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postal_code": "10001"
},
"pull_enabled": true,
"push_enabled": true
},
"purpose": "Offshore dev center",
"external_reference_id": "TW-9L1L2-UVV",
"ofac": {
"status": "pass",
"last_updated_at": "2024-04-01T21:00:00Z"
},
"attachments": [
{
"label": "Dev Contract",
"id": "att_a8d2b191fa0e960d8e49a4bfd320e07b",
"created_at": "2024-04-01T21:00:00Z"
}
],
"metadata": {
"vendor_id": "VID-0987ACR"
},
"status": "activated",
"timestamps": {
"created_at": "2024-04-01T21:00:00Z",
"updated_at": "2024-04-01T21:00:00Z"
}
}