com.docusign.esign.api

Class BillingApi

java.lang.Object

com.docusign.esign.api.BillingApi

public class BillingApi
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BillingApi.GetPlanOptions
class	BillingApi.ListInvoicesOptions
class	BillingApi.ListPaymentsOptions
class	BillingApi.UpdatePlanOptions

Constructor Summary

Constructors

Constructor and Description
BillingApi()
BillingApi(ApiClient apiClient)

Method Summary

Modifier and Type	Method and Description
ApiClient	getApiClient()
BillingPlanResponse	getBillingPlan(String billingPlanId) Get the billing plan details.
BillingInvoice	getInvoice(String accountId, String invoiceId) Retrieves a billing invoice.
BillingPaymentItem	getPayment(String accountId, String paymentId) Gets billing payment information for a specific payment.
AccountBillingPlanResponse	getPlan(String accountId) Get Account Billing Plan Retrieves the billing plan information for the specified account, including the current billing plan, successor plans, billing address, and billing credit card.\n\nBy default the successor plan and credit card information is included in the response.
AccountBillingPlanResponse	getPlan(String accountId, BillingApi.GetPlanOptions options) Get Account Billing Plan Retrieves the billing plan information for the specified account, including the current billing plan, successor plans, billing address, and billing credit card.\n\nBy default the successor plan and credit card information is included in the response.
BillingPlansResponse	listBillingPlans() Gets the list of available billing plans.
BillingInvoicesResponse	listInvoices(String accountId) Get a List of Billing Invoices Retrieves a list of invoices for the account.
BillingInvoicesResponse	listInvoices(String accountId, BillingApi.ListInvoicesOptions options) Get a List of Billing Invoices Retrieves a list of invoices for the account.
BillingInvoicesSummary	listInvoicesPastDue(String accountId) Get a list of past due invoices.
BillingPaymentsResponse	listPayments(String accountId) Gets payment information for one or more payments.
BillingPaymentsResponse	listPayments(String accountId, BillingApi.ListPaymentsOptions options) Gets payment information for one or more payments.
BillingPaymentResponse	makePayment(String accountId, BillingPaymentRequest billingPaymentRequest) Posts a payment to a past due invoice.
void	purchaseEnvelopes(String accountId, PurchasedEnvelopesInformation purchasedEnvelopesInformation) Reserverd: Purchase additional envelopes.
void	setApiClient(ApiClient apiClient)
BillingPlanUpdateResponse	updatePlan(String accountId, BillingPlanInformation billingPlanInformation) Updates the account billing plan.
BillingPlanUpdateResponse	updatePlan(String accountId, BillingPlanInformation billingPlanInformation, BillingApi.UpdatePlanOptions options) Updates the account billing plan.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BillingApi

public BillingApi()

BillingApi

public BillingApi(ApiClient apiClient)

Method Detail

getApiClient

public ApiClient getApiClient()

setApiClient

public void setApiClient(ApiClient apiClient)

listInvoices

public BillingInvoicesResponse listInvoices(String accountId)
                                     throws ApiException

Get a List of Billing Invoices Retrieves a list of invoices for the account. If the from date or to date queries are not specified, the response returns invoices for the last 365 days.\n\nPrivileges required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

Returns:

BillingInvoicesResponse

Throws:

ApiException

listInvoices

public BillingInvoicesResponse listInvoices(String accountId,
                                            BillingApi.ListInvoicesOptions options)
                                     throws ApiException

Get a List of Billing Invoices Retrieves a list of invoices for the account. If the from date or to date queries are not specified, the response returns invoices for the last 365 days.\n\nPrivileges required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.ListInvoicesOptions - Options for modifying the method behavior.

Returns:

BillingInvoicesResponse

Throws:

ApiException

getInvoice

public BillingInvoice getInvoice(String accountId,
                                 String invoiceId)
                          throws ApiException

Retrieves a billing invoice. Retrieves the specified invoice. \n\n###### Note: If the pdfAvailable property in the response is set to true, you can download a PDF version of the invoice. To download the PDF, make the call again and change the value of the Accept property in the header to Accept: application/pdf.\n\nPrivileges required: account administrator\n\nThe response returns a list of charges and information about the charges. Quantities are usually shown as ‘unlimited’ or an integer. Amounts are shown in the currency set for the account.\n\n**Response**\nThe following table provides a description of the different chargeName property values. The information will grow as more chargeable items are added to the system.\n\n| chargeName | Description |\n| — | — |\n| id_check | ID Check Charge |\n| in_person_signing | In Person Signing charge |\n| envelopes Included | Sent Envelopes for the account |\n| age_verify | Age verification check |\n| ofac | OFAC Check |\n| id_confirm | ID confirmation check |\n| student_authentication | STAN PIN authentication check |\n| wet_sign_fax | Pages for returning signed documents by fax |\n| attachment_fax | Pages for returning attachments by fax |\n| phone_authentication | Phone authentication charge |\n| powerforms | PowerForm envelopes sent |\n| signer_payments | Payment processing charge |\n| outbound_fax | Send by fax charge |\n| bulk_recipient_envelopes | Bulk Recipient Envelopes sent |\n| sms_authentications | SMS authentication charge |\n| saml_authentications | SAML authentication charge |\n| express_signer_certificate | DocuSign Express Certificate charge |\n| personal_signer_certificate | Personal Signer Certificate charge |\n| safe_certificate | SAFE BioPharma Signer Certificate charge |\n| seats | Included active seats charge |\n| open_trust_certificate | OpenTrust Signer Certificate charge |

Parameters:

accountId - The external account number (int) or account ID Guid.

invoiceId -

BillingApi.GetInvoiceOptions - Options for modifying the method behavior.

Returns:

BillingInvoice

Throws:

ApiException

listInvoicesPastDue

public BillingInvoicesSummary listInvoicesPastDue(String accountId)
                                           throws ApiException

Get a list of past due invoices. Returns a list past due invoices for the account and notes if payment can be made through the REST API. \n\nPrivileges Required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.ListInvoicesPastDueOptions - Options for modifying the method behavior.

Returns:

BillingInvoicesSummary

Throws:

ApiException

listPayments

public BillingPaymentsResponse listPayments(String accountId)
                                     throws ApiException

Gets payment information for one or more payments. Retrieves a list containing information about one or more payments. If the from date or to date queries are not used, the response returns payment information for the last 365 days. \n\nPrivileges required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

Returns:

BillingPaymentsResponse

Throws:

ApiException

listPayments

public BillingPaymentsResponse listPayments(String accountId,
                                            BillingApi.ListPaymentsOptions options)
                                     throws ApiException

Gets payment information for one or more payments. Retrieves a list containing information about one or more payments. If the from date or to date queries are not used, the response returns payment information for the last 365 days. \n\nPrivileges required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.ListPaymentsOptions - Options for modifying the method behavior.

Returns:

BillingPaymentsResponse

Throws:

ApiException

makePayment

public BillingPaymentResponse makePayment(String accountId,
                                          BillingPaymentRequest billingPaymentRequest)
                                   throws ApiException

Posts a payment to a past due invoice. Posts a payment to a past due invoice. \n\n###### Note: This can only be used if the paymentAllowed value for a past due invoice is true. This can be determined calling [ML:GetBillingInvoicesPastDue].\n\nThe response returns information for a single payment, if a payment ID was used in the endpoint, or a list of payments. If the from date or to date queries or payment ID are not used, the response returns payment information for the last 365 days. If the request was for a single payment ID, the nextUri and previousUri properties are not returned.\n\nPrivileges required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.MakePaymentOptions - Options for modifying the method behavior.

Returns:

BillingPaymentResponse

Throws:

ApiException

getPayment

public BillingPaymentItem getPayment(String accountId,
                                     String paymentId)
                              throws ApiException

Gets billing payment information for a specific payment. Retrieves the information for a specified payment. \n\nPrivileges required: account administrator

Parameters:

accountId - The external account number (int) or account ID Guid.

paymentId -

BillingApi.GetPaymentOptions - Options for modifying the method behavior.

Returns:

BillingPaymentItem

Throws:

ApiException

getPlan

public AccountBillingPlanResponse getPlan(String accountId)
                                   throws ApiException

Get Account Billing Plan Retrieves the billing plan information for the specified account, including the current billing plan, successor plans, billing address, and billing credit card.\n\nBy default the successor plan and credit card information is included in the response. This information can be excluded from the response by adding the appropriate optional query string with the setting set to false. \n\nResponse\n\nThe response returns the billing plan information, including the currency code, for the plan. The billingPlan and succesorPlans property values are the same as those shown in the [ML:Get Billing Plan Details] reference. the billingAddress and creditCardInformation property values are the same as those shown in the [ML:Update Billing Plan] reference.\n\n###### Note: When credit card number information is shown, a mask is applied to the response so that only the last 4 digits of the card number are visible.

Parameters:

accountId - The external account number (int) or account ID Guid.

Returns:

AccountBillingPlanResponse

Throws:

ApiException

getPlan

public AccountBillingPlanResponse getPlan(String accountId,
                                          BillingApi.GetPlanOptions options)
                                   throws ApiException

Get Account Billing Plan Retrieves the billing plan information for the specified account, including the current billing plan, successor plans, billing address, and billing credit card.\n\nBy default the successor plan and credit card information is included in the response. This information can be excluded from the response by adding the appropriate optional query string with the setting set to false. \n\nResponse\n\nThe response returns the billing plan information, including the currency code, for the plan. The billingPlan and succesorPlans property values are the same as those shown in the [ML:Get Billing Plan Details] reference. the billingAddress and creditCardInformation property values are the same as those shown in the [ML:Update Billing Plan] reference.\n\n###### Note: When credit card number information is shown, a mask is applied to the response so that only the last 4 digits of the card number are visible.

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.GetPlanOptions - Options for modifying the method behavior.

Returns:

AccountBillingPlanResponse

Throws:

ApiException

updatePlan

public BillingPlanUpdateResponse updatePlan(String accountId,
                                            BillingPlanInformation billingPlanInformation)
                                     throws ApiException

Updates the account billing plan. Updates the billing plan information, billing address, and credit card information for the specified account.

Parameters:

accountId - The external account number (int) or account ID Guid.

Returns:

BillingPlanUpdateResponse

Throws:

ApiException

updatePlan

public BillingPlanUpdateResponse updatePlan(String accountId,
                                            BillingPlanInformation billingPlanInformation,
                                            BillingApi.UpdatePlanOptions options)
                                     throws ApiException

Updates the account billing plan. Updates the billing plan information, billing address, and credit card information for the specified account.

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.UpdatePlanOptions - Options for modifying the method behavior.

Returns:

BillingPlanUpdateResponse

Throws:

ApiException

purchaseEnvelopes

public void purchaseEnvelopes(String accountId,
                              PurchasedEnvelopesInformation purchasedEnvelopesInformation)
                       throws ApiException

Reserverd: Purchase additional envelopes. Reserved: At this time, this endpoint is limited to DocuSign internal use only. Completes the purchase of envelopes for your account. The actual purchase is done as part of an internal workflow interaction with an envelope vendor.

Parameters:

accountId - The external account number (int) or account ID Guid.

BillingApi.PurchaseEnvelopesOptions - Options for modifying the method behavior.

Throws:

ApiException

listBillingPlans

public BillingPlansResponse listBillingPlans()
                                      throws ApiException

Gets the list of available billing plans. Retrieves a list of the billing plans associated with a distributor.

Parameters:

BillingApi.ListBillingPlansOptions - Options for modifying the method behavior.

Returns:

BillingPlansResponse

Throws:

ApiException

getBillingPlan

public BillingPlanResponse getBillingPlan(String billingPlanId)
                                   throws ApiException

Get the billing plan details. Retrieves the billing plan details for the specified billing plan ID.

Parameters:

billingPlanId - The ID of the billing plan being accessed.

BillingApi.GetBillingPlanOptions - Options for modifying the method behavior.

Returns:

BillingPlanResponse

Throws:

ApiException