docusign

# NOTE: This class is auto generated by the swagger code generator program.
# https://github.com/swagger-api/swagger-codegen.git
# Do not edit the class manually.

defmodule DocuSign.Api.Payments do
  @moduledoc """
  API calls for all endpoints tagged `Payments`.
  """

  alias DocuSign.Connection
  import DocuSign.RequestBuilder

  @doc """
  Gets billing payment information for a specific payment.
  Retrieves the information for a specified payment.   Privileges required: account administrator 

  ## Parameters

  - connection (DocuSign.Connection): Connection to server
  - account_id (String.t): The external account number (int) or account ID Guid.
  - payment_id (String.t): 
  - opts (KeywordList): [optional] Optional parameters

  ## Returns

  {:ok, %DocuSign.Model.Payments{}} on success
  {:error, info} on failure
  """
  @spec billing_payments_get_payment(Tesla.Env.client(), String.t(), String.t(), keyword()) ::
          {:ok, DocuSign.Model.Payments.t()} | {:error, Tesla.Env.t()}
  def billing_payments_get_payment(connection, account_id, payment_id, _opts \\ []) do
    %{}
    |> method(:get)
    |> url("/v2/accounts/#{account_id}/billing_payments/#{payment_id}")
    |> Enum.into([])
    |> (&Connection.request(connection, &1)).()
    |> decode(%DocuSign.Model.Payments{})
  end

  @doc """
  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.   Privileges required: account administrator 

  ## Parameters

  - connection (DocuSign.Connection): Connection to server
  - account_id (String.t): The external account number (int) or account ID Guid.
  - opts (KeywordList): [optional] Optional parameters
    - :from_date (String.t): Specifies the date/time of the earliest payment in the account to retrieve.
    - :to_date (String.t): Specifies the date/time of the latest payment in the account to retrieve.

  ## Returns

  {:ok, %DocuSign.Model.BillingPaymentsResponse{}} on success
  {:error, info} on failure
  """
  @spec billing_payments_get_payment_list(Tesla.Env.client(), String.t(), keyword()) ::
          {:ok, DocuSign.Model.BillingPaymentsResponse.t()} | {:error, Tesla.Env.t()}
  def billing_payments_get_payment_list(connection, account_id, opts \\ []) do
    optional_params = %{
      from_date: :query,
      to_date: :query
    }

    %{}
    |> method(:get)
    |> url("/v2/accounts/#{account_id}/billing_payments")
    |> add_optional_params(optional_params, opts)
    |> Enum.into([])
    |> (&Connection.request(connection, &1)).()
    |> decode(%DocuSign.Model.BillingPaymentsResponse{})
  end

  @doc """
  Posts a payment to a past due invoice.
  Posts a payment to a past due invoice.   ###### Note: This can only be used if the `paymentAllowed` value for a past due invoice is true. This can be determined calling [ML:GetBillingInvoicesPastDue].  The 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.  Privileges required: account administrator

  ## Parameters

  - connection (DocuSign.Connection): Connection to server
  - account_id (String.t): The external account number (int) or account ID Guid.
  - opts (KeywordList): [optional] Optional parameters
    - :billing_payment_request (BillingPaymentRequest): 

  ## Returns

  {:ok, %DocuSign.Model.BillingPaymentResponse{}} on success
  {:error, info} on failure
  """
  @spec billing_payments_post_payment(Tesla.Env.client(), String.t(), keyword()) ::
          {:ok, DocuSign.Model.BillingPaymentResponse.t()} | {:error, Tesla.Env.t()}
  def billing_payments_post_payment(connection, account_id, opts \\ []) do
    optional_params = %{
      billingPaymentRequest: :body
    }

    %{}
    |> method(:post)
    |> url("/v2/accounts/#{account_id}/billing_payments")
    |> add_optional_params(optional_params, opts)
    |> Enum.into([])
    |> (&Connection.request(connection, &1)).()
    |> decode(%DocuSign.Model.BillingPaymentResponse{})
  end
end