Financial Instruments and External Cash Transactions API

Financial Instruments

Fetch a Financial Instrument

fetchFinancialInstrument

GET /billing/{tenantLocator}/financialInstruments/{locator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required

Response:FinancialInstrumentResponse

Security Group:financial-instruments Permission:read

FinancialInstrumentResponse

¶

required
locator locator
isDefault boolean

optional
accountLocator locator?
institutionName string?
defaultTransactionMethod Enum? ach | cash | eft | standard | wire
expirationTime datetime?
externalAccountNumber string?
externalIdentifier string?
instrumentType Enum? checking | savings | creditCard | debitCard
nickname string?

Fetch Financial Instruments for a Tenant

¶

listFinancialInstruments

GET /billing/{tenantLocator}/financialInstruments/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
offset	query	int?	optional
count	query	int?	optional
extended	query	boolean?	optional

Response:FinancialInstrumentListResponse

Security Group:financial-instruments Permissions:read,list

FinancialInstrumentListResponse

¶

required
listCompleted boolean
items FinancialInstrumentResponse[]

Create a Financial Instrument

¶

createFinancialInstrument

POST /billing/{tenantLocator}/financialInstruments

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required

Request:FinancialInstrumentCreateRequest

Response:FinancialInstrumentResponse

Security Group:financial-instruments Permission:write

FinancialInstrumentCreateRequest

¶

optional
accountLocator locator?
institutionName string?
defaultTransactionMethod Enum? ach | cash | eft | standard | wire
expirationTime datetime?
externalAccountNumber string?
externalIdentifier string?
instrumentType Enum? checking | savings | creditCard | debitCard
nickname string?

Set the Default Financial Instrument for a Tenant

¶

setFinancialInstrumentAsDefault

POST /billing/{tenantLocator}/financialInstruments/{locator}/setAsDefault

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required
value	query	boolean?	optional

Response:FinancialInstrumentResponse

Security Group:financial-instruments Permission:write

Update a Financial Instrument

¶

updateFinancialInstrument

PATCH /billing/{tenantLocator}/financialInstruments/{locator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required

Request:FinancialInstrumentCreateRequest

Response:FinancialInstrumentResponse

Security Group:financial-instruments Permission:write

External Cash Transactions

Fetch an External Cash Transaction

¶

fetchExternalCashTransaction

GET /billing/{tenantLocator}/externalCashTransactions/{locator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required

Response:ExternalCashTransactionResponse

Security Group:external-cash-transactions Permission:read

ExternalCashTransactionResponse

¶

required
locator locator
transactionMethod Enum ach | cash | eft | standard | wire

optional
financialInstrumentLocator locator?
transactionNumber string?