Credit Distribution API

Credit Distributions are used to apply customer credits from a Credit Balance to invoices or for disbursements.

Endpoint Index

Action	Endpoint
Fetch Credit Distribution	GET /billing/{tenantLocator}/creditDistributions/{locator}
Fetch Credit Distributions for an Invoice	GET /billing/{tenantLocator}/invoices/{locator}/creditDistributions/list
Fetch Multiple Credit Distributions	GET /billing/{tenantLocator}/creditDistributions/list
Create Credit Distribution	POST /billing/{tenantLocator}/creditDistributions
Update Credit Distribution	PATCH /billing/{tenantLocator}/creditDistributions/{locator}
Create Or Replace Credit Distribution	PUT /billing/{tenantLocator}/creditDistributions/{locator}
Validate Credit Distribution	PATCH /billing/{tenantLocator}/creditDistributions/{locator}/validate
Execute Credit Distribution	PATCH /billing/{tenantLocator}/creditDistributions/{locator}/execute
Reverse Credit Distribution	PATCH /billing/{tenantLocator}/creditDistributions/{locator}/reverse
Reset Credit Distribution	PATCH /billing/{tenantLocator}/creditDistributions/{locator}/reset
Discard Credit Distribution	PATCH /billing/{tenantLocator}/creditDistributions/{locator}/discard
Fetch Invoices Targeted By a Credit Distribution	GET /billing/{tenantLocator}/creditDistributions/{locator}/invoices/list

Fetch

Fetch Credit Distribution

fetchCreditDistribution

GET /billing/{tenantLocator}/creditDistributions/{locator}

Request Parameters:

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

Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:read

Fetch Credit Distributions for an Invoice

fetchCreditDistributionsForAnInvoice

GET /billing/{tenantLocator}/invoices/{locator}/creditDistributions/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:CreditDistributionListResponse
Security Group:invoices   Permissions:read,list

Fetch Multiple Credit Distributions

fetchMultipleCreditDistributions

GET /billing/{tenantLocator}/creditDistributions/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:CreditDistributionListResponse
Security Group:credit-distributions   Permissions:read,list

CreditDistributionListResponse

required
listCompleted boolean
items CreditDistributionResponse[]

CreditDistributionResponse

required
locator string
currency string
creditDistributionState Enum draft | validated | executed | reversed | discarded
amount number
createdAt datetime
createdBy uuid
shortfallCreditLocators string[]
sources CreditItem[]
targets CreditItem[]

optional
accountLocator string?
executedAt datetime?
reversalReason string?
reversedAt datetime?
validationResult ValidationResult?

Creation and Update

Create Credit Distribution

createCreditDistribution

POST /billing/{tenantLocator}/creditDistributions

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required

Request:CreditDistributionCreateRequest
Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

CreditDistributionCreateRequest

required
amount number
sources CreditItem[]
targets CreditItem[]

optional
accountLocator string?
currency string?

Update Credit Distribution

updateCreditDistribution

PATCH /billing/{tenantLocator}/creditDistributions/{locator}

Request Parameters:

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

Request:CreditDistributionUpdateRequest
Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

CreditDistributionUpdateRequest

required
addSources CreditItem[]
addTargets CreditItem[]
removeSources string[]
removeTargets string[]

optional
accountLocator string?
currency string?
amount number?

Create Or Replace Credit Distribution

createOrReplaceCreditDistribution

PUT /billing/{tenantLocator}/creditDistributions/{locator}

Request Parameters:

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

Request:CreditDistributionPutRequest
Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

CreditDistributionPutRequest

required
amount number
sources CreditItem[]
targets CreditItem[]

optional
accountLocator string?
currency string?

Execution

Validate Credit Distribution

validateCreditDistribution

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

Request Parameters:

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

Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

Execute Credit Distribution

executeCreditDistribution

PATCH /billing/{tenantLocator}/creditDistributions/{locator}/execute

Request Parameters:

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

Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

Reversal

Reverse Credit Distribution

reverseCreditDistribution

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

Request Parameters:

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

Request:CreditDistributionReverseRequest
Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

CreditDistributionReverseRequest

required
reversalType string

Reset and Discard

Reset Credit Distribution

resetCreditDistribution

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

Request Parameters:

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

Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

Discard Credit Distribution

discardCreditDistribution

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

Request Parameters:

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

Response:CreditDistributionResponse
Security Group:credit-distributions   Permission:write

Invoices

Fetch Invoices Targeted By a Credit Distribution

fetchInvoicesTargetedByACreditDistribution

GET /billing/{tenantLocator}/creditDistributions/{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:credit-distributions   Permissions:read,list