balance transaction docs

models/doc_blocks.md

@@ -27,3 +27,9 @@ A timestamp for when the event was pulled by Airbyte from the original data sour
 You can query the _airbyte_meta column to see which rows failed for content reasons, and why.
 
 {% enddocs %}
+
+{% docs dwh_extracted_at_date_desc %}
+
+A timestamp for when the event was pulled by Airbyte from the original data source.
+
+{% enddocs %}

models/staging/stripe/schema.yml

@@ -3,13 +3,63 @@ version: 2
 
 models:
   - name: stg_stripe__balance_transactions
-    description: "Balance transactions from all our Stripe balance accounts."
+    description: | 
+      Individual transactions happening in our different Stripe currency accounts.
+    
+      You can read more about this object here: https://docs.stripe.com/api/balance_transactions/object.
+        
     columns:
       - name: id
-        description: "The primary key for the transaction."
-        tests:
-          - unique
-          - not_null
+        data_type: character varying
+        description: "{{ doc('generic_id_desc') }}"
+      - name: fee
+        data_type: bigint
+        description: "Fees (in cents) paid for this transaction. Represented as a positive integer when assessed."
+      - name: net
+        data_type: bigint
+        description: "Net impact to a Stripe balance (in cents). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by amount - fee"
+      - name: type
+        data_type: character varying
+        description: "Transaction type: adjustment, advance, advance_funding, anticipation_repayment, application_fee, application_fee_refund, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, contribution, issuing_authorization_hold, issuing_authorization_release, issuing_dispute, issuing_transaction, obligation_outbound, obligation_reversal_inbound, payment, payment_failure_refund, payment_network_reserve_hold, payment_network_reserve_release, payment_refund, payment_reversal, payment_unreconciled, payout, payout_cancel, payout_failure, refund, refund_failure, reserve_transaction, reserved_funds, stripe_fee, stripe_fx_fee, tax_fee, topup, topup_reversal, transfer, transfer_cancel, transfer_failure, or transfer_refund. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, consider reporting_category instead."
+      - name: amount
+        data_type: bigint
+        description: "Gross amount of this transaction (in cents). A positive value represents funds charged to another party, and a negative value represents funds sent to another party."
+      - name: object
+        data_type: character varying
+        description: "Silly column. The value is always `balance_transaction`."
+      - name: source
+        data_type: character varying
+        description: "This transaction relates to the Stripe object indicated here. Can be different object types (charge, refund, payment, etc)."
+      - name: status
+        data_type: character varying
+        description: "The transaction’s net funds status in the Stripe balance, which are either available or pending."
+      - name: created_at_utc
+        data_type: bigint
+        description: "The timestamp at which the transaction object was created."
+      - name: currency
+        data_type: character varying
+        description: "{{ doc('stripe_currency_desc') }}"
+      - name: description
+        data_type: character varying
+        description: "An arbitrary string attached to the object. Often useful for displaying to users."
+      - name: fee_details
+        data_type: jsonb
+        description: "Detailed breakdown of fees (in cents) paid for this transaction."
+      - name: available_at_utc
+        data_type: bigint
+        description: "The timestamp at which the transaction’s net funds become available in the Stripe balance."
+      - name: exchange_rate
+        data_type: numeric
+        description: "If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the amount in currency A, multipled by the exchange_rate, equals the amount in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’s amount is 1000 and currency is eur. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’s amount is 1234, its currency is usd, and the exchange_rate is 1.234."
+      - name: sourced_transfers
+        data_type: jsonb
+        description: "{{ doc('field_docs_na_desc') }}"
+      - name: reporting_category
+        data_type: character varying
+        description: "Read more at https://stripe.com/docs/reports/reporting-categories."
+      - name: dwh_extracted_at_date
+        data_type: timestamp with time zone
+        description: "{{ doc('dwh_extracted_at_date_desc')}}"
   - name: stg_stripe__charges
     description: "Charges from all our Stripe accounts."
     columns: