Payments API

Fetch a Payment

fetchPayment

GET /billing/{tenantLocator}/payments/{locator}

Request Parameters:

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

Response:PaymentResponse
Security Group:payments   Permission:read

Fetch Multiple Payments

fetchMultiplePayments

GET /billing/{tenantLocator}/payments/list

Request Parameters:

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

Response:PaymentListResponse
Security Group:payments   Permissions:read,list

PaymentListResponse

required
listCompleted boolean
items PaymentResponse[]

PaymentResponse

required
locator string
currency string
paymentState Enum draft | validated | posted | reversed | discarded
amount number
type string
createdAt datetime
createdBy uuid
shortfallCreditLocators string[]
targets CreditItem[]

optional
accountLocator string?
externalCashTransactionLocator string?
postedAt datetime?
remainingAmount number?
reversalReason string?
reversedAt datetime?
validationResult ValidationResult?
data map<string,object>?

CreditItem

required
containerLocator string
containerType Enum invoice | account

optional
amount number?

Create a Payment

createPayment

POST /billing/{tenantLocator}/payments

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required

Request:PaymentCreateRequest
Response:PaymentResponse
Security Group:payments   Permission:write

PaymentCreateRequest

required
amount number
type string
useDefaultFinancialInstrument boolean
data map<string,object>
targets CreditItem[]

optional
accountLocator string?
financialInstrumentLocator string?
currency string?
transactionMethod Enum? ach | cash | eft | standard | wire
transactionNumber string?

Update a Payment

updatePayment

PATCH /billing/{tenantLocator}/payments/{locator}

Request Parameters:

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

Request:PaymentUpdateRequest
Response:PaymentResponse
Security Group:payments   Permission:write

PaymentUpdateRequest

required
addTargets CreditItem[]
removeData map<string,object>
removeTargets string[]
setData map<string,object>

optional
accountLocator string?
financialInstrumentLocator string?
currency string?
amount number?
transactionMethod Enum? ach | cash | eft | standard | wire
transactionNumber string?
type string?
useDefaultFinancialInstrument boolean?

Update a Payment (overwrite extension data)

updatePaymentOverwriteData

PUT /billing/{tenantLocator}/payments/{locator}

Request Parameters:

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

Request:PaymentCreateRequest
Response:PaymentResponse
Security Group:payments   Permission:write

Validate a Payment

validatePayment

PATCH /billing/{tenantLocator}/payments/{locator}/validate

Request Parameters:

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

Response:PaymentResponse
Security Group:payments   Permission:write

Post a Payment

postPayment

PATCH /billing/{tenantLocator}/payments/{locator}/post

Request Parameters:

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

Response:PaymentResponse
Security Group:payments   Permission:write

Reverse a Posted Payment

reversePayment

PATCH /billing/{tenantLocator}/payments/{locator}/reverse

Request Parameters:

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

Request:CreditDistributionReverseRequest
Response:PaymentResponse
Security Group:payments   Permission:write

Reset a Validated Payment Back to Draft State

resetPayment

PATCH /billing/{tenantLocator}/payments/{locator}/reset

Request Parameters:

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

Response:PaymentResponse
Security Group:payments   Permission:write

Discard a Payment

discardPayment

PATCH /billing/{tenantLocator}/payments/{locator}/discard

Request Parameters:

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

Response:PaymentResponse
Security Group:payments   Permission:write

Fetch Payments for an Invoice

fetchPaymentsForAnInvoice

GET /billing/{tenantLocator}/invoices/{locator}/payments/list

Request Parameters:

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

Response:PaymentListResponse
Security Group:invoices   Permissions:read,list

Fetch Invoices Targeted By a Payment

fetchInvoicesTargetedByAPayment

GET /billing/{tenantLocator}/payments/{locator}/invoices/list

Request Parameters:

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

Response:InvoiceListResponse
Security Group:payments   Permissions:read,list

See Also

• Payments