System Status

Invoices

An Invoice represents a statement of the amount owed by a customer. They are either generated one-off or periodically from a subscription. You can create, retrieve, update, open, void, and delete invoices.

Returns a list of invoices

get

Gets all invoices.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
endingBeforestringOptional

A cursor for use in pagination. The endingBefore parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with xyz your subsequent calls can include endingBefore=xyz in order to fetch the previous page of the list.

startingAfterstringOptional

A cursor for use in pagination. The startingAfter parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with xyz, your subsequent calls can include startingAfter=xyz in order to fetch the next page of the list.

limitinteger · min: 1 · max: 100Optional

A limit on the number of objects returned. Limit can range between 1 and 100, and the default is 10.

idsstring[]Optional

Only return objects with these IDs.

upstreamIdsstring[]Optional

Only return objects with these upstreamIds.

customerIdstringOptional

Only return invoices for this customer

applicationIdstringOptional

Only return checkouts for the given application

currencystringOptional

Only return invoices in this currency

statestringOptional

Only return invoices in this state

skuIdstringOptional

Only return invoices for this sku

Responses
200

200 OK

application/json
get
/invoices

Creates a new invoice

post

This request creates a new invoice object.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
customerIdstringRequired

The identifier of the invoiced customer.

Example: 5774321009
emailstring · emailOptional

The email address of the invoiced customer.

Example: [email protected]
sourceIdstringOptional

The unique identifier of a Source.

Example: src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37
currencystringRequired

A three-letter ISO 4217 currency code.

Example: USD
statestring · enumOptional

The state of the invoice.

Example: openPossible values:
chargeTypestring · enumOptional

Represents the charge type.

Example: merchant_initiatedPossible values:
descriptionstringOptional

An arbitrary string attached to the invoice.

localestringOptional

A designator that combines the two-letter ISO 639-1 language code with the ISO 3166-1 alpha-2 country code.

Example: en-US
customerTypestring · enumOptional

The type of customer.

Example: individualPossible values:
collectionPeriodDaysintegerOptional

The number of days that Digital River attempts to collect payment if billingOptimization is set to true. The default is 30 days.

Example: 30
billingOptimizationbooleanOptional

Indicates whether billing is optimized. The default is true.

Example: true
taxInclusivebooleanOptional

If true, indicates that the prices supplied are tax inclusive.

Example: true
upstreamIdstringOptional

The invoice identifier if it is different from the Digital River invoice identifier.

Example: 7765374748
applicationIdstringOptional

The identifier of the client application that created the checkout.

Example: 5774321009
Responses
post
/invoices

Gets an invoice by identifier

get

Retrieves the details of an invoice by supplying its unique identifier.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

The unique identifier of the Invoice.

Responses
200

OK.

application/json
get
/invoices/{id}

Updates an existing invoice

post

Updates an existing invoice.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

The unique identifier of the Invoice.

Body
Responses
200

200 OK

application/json
post
/invoices/{id}

Deletes an invoice

delete

This requrest deletes an invoice.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

The unique identifier of the Invoice.

Responses
delete
/invoices/{id}
No content

Opens an existing invoice

post

This request opens an invoice.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

The unique identifier of the Invoice.

Responses
200

200 OK

application/json
post
/invoices/{id}/open

Voids an existing invoice

post

This request voids an invoice.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired

The unique identifier of the invoice.

Responses
200

200 OK

application/json
post
/invoices/{id}/void
PreviousInventory levelsNextOrders

Last updated