orb-billing/resources/customers/balance-transactions.d.ts

The official TypeScript library for the Orb API

import { APIResource } from "../../resource.js";
import * as Core from "../../core.js";
import * as Shared from "../shared.js";
import { Page, type PageParams } from "../../pagination.js";
export declare class BalanceTransactions extends APIResource {
    /**
     * Creates an immutable balance transaction that updates the customer's balance and
     * returns back the newly created transaction.
     */
    create(customerId: string, body: BalanceTransactionCreateParams, options?: Core.RequestOptions): Core.APIPromise<BalanceTransactionCreateResponse>;
    /**
     * ## The customer balance
     *
     * The customer balance is an amount in the customer's currency, which Orb
     * automatically applies to subsequent invoices. This balance can be adjusted
     * manually via Orb's webapp on the customer details page. You can use this balance
     * to provide a fixed mid-period credit to the customer. Commonly, this is done due
     * to system downtime/SLA violation, or an adhoc adjustment discussed with the
     * customer.
     *
     * If the balance is a positive value at the time of invoicing, it represents that
     * the customer has credit that should be used to offset the amount due on the next
     * issued invoice. In this case, Orb will automatically reduce the next invoice by
     * the balance amount, and roll over any remaining balance if the invoice is fully
     * discounted.
     *
     * If the balance is a negative value at the time of invoicing, Orb will increase
     * the invoice's amount due with a positive adjustment, and reset the balance to 0.
     *
     * This endpoint retrieves all customer balance transactions in reverse
     * chronological order for a single customer, providing a complete audit trail of
     * all adjustments and invoice applications.
     */
    list(customerId: string, query?: BalanceTransactionListParams, options?: Core.RequestOptions): Core.PagePromise<BalanceTransactionListResponsesPage, BalanceTransactionListResponse>;
    list(customerId: string, options?: Core.RequestOptions): Core.PagePromise<BalanceTransactionListResponsesPage, BalanceTransactionListResponse>;
}
export declare class BalanceTransactionListResponsesPage extends Page<BalanceTransactionListResponse> {
}
export interface BalanceTransactionCreateResponse {
    /**
     * A unique id for this transaction.
     */
    id: string;
    action: 'applied_to_invoice' | 'manual_adjustment' | 'prorated_refund' | 'revert_prorated_refund' | 'return_from_voiding' | 'credit_note_applied' | 'credit_note_voided' | 'overpayment_refund' | 'external_payment' | 'small_invoice_carryover';
    /**
     * The value of the amount changed in the transaction.
     */
    amount: string;
    /**
     * The creation time of this transaction.
     */
    created_at: string;
    credit_note: Shared.CreditNoteTiny | null;
    /**
     * An optional description provided for manual customer balance adjustments.
     */
    description: string | null;
    /**
     * The new value of the customer's balance prior to the transaction, in the
     * customer's currency.
     */
    ending_balance: string;
    invoice: Shared.InvoiceTiny | null;
    /**
     * The original value of the customer's balance prior to the transaction, in the
     * customer's currency.
     */
    starting_balance: string;
    type: 'increment' | 'decrement';
}
export interface BalanceTransactionListResponse {
    /**
     * A unique id for this transaction.
     */
    id: string;
    action: 'applied_to_invoice' | 'manual_adjustment' | 'prorated_refund' | 'revert_prorated_refund' | 'return_from_voiding' | 'credit_note_applied' | 'credit_note_voided' | 'overpayment_refund' | 'external_payment' | 'small_invoice_carryover';
    /**
     * The value of the amount changed in the transaction.
     */
    amount: string;
    /**
     * The creation time of this transaction.
     */
    created_at: string;
    credit_note: Shared.CreditNoteTiny | null;
    /**
     * An optional description provided for manual customer balance adjustments.
     */
    description: string | null;
    /**
     * The new value of the customer's balance prior to the transaction, in the
     * customer's currency.
     */
    ending_balance: string;
    invoice: Shared.InvoiceTiny | null;
    /**
     * The original value of the customer's balance prior to the transaction, in the
     * customer's currency.
     */
    starting_balance: string;
    type: 'increment' | 'decrement';
}
export interface BalanceTransactionCreateParams {
    amount: string;
    type: 'increment' | 'decrement';
    /**
     * An optional description that can be specified around this entry.
     */
    description?: string | null;
}
export interface BalanceTransactionListParams extends PageParams {
    'operation_time[gt]'?: string | null;
    'operation_time[gte]'?: string | null;
    'operation_time[lt]'?: string | null;
    'operation_time[lte]'?: string | null;
}
export declare namespace BalanceTransactions {
    export { type BalanceTransactionCreateResponse as BalanceTransactionCreateResponse, type BalanceTransactionListResponse as BalanceTransactionListResponse, BalanceTransactionListResponsesPage as BalanceTransactionListResponsesPage, type BalanceTransactionCreateParams as BalanceTransactionCreateParams, type BalanceTransactionListParams as BalanceTransactionListParams, };
}
//# sourceMappingURL=balance-transactions.d.ts.map