yaml for new version, plus deprecation

models/intermediate/core/schema.yml

@@ -819,12 +819,16 @@ models:
           date before a starting date.
 
   - name: int_core__verification_payments
+    latest_version: 1
     description: >-
       A simplified table that holds guest journey payments with details around
       when they happen, what service was being paid, what was the related
       verification request, etc.
 
       Currency rates are converted to GBP with our simple exchange rates view.
+
+      Guest taxes get calculated here. You can find out more about Guest Tax
+      calculation here: https://www.notion.so/knowyourguest-superhog/Guest-Services-Taxes-How-to-calculate-a5ab4c049d61427fafab669dbbffb3a2?pvs=4
     columns:
       - name: id_verification_to_payment
         data_type: bigint
@@ -884,14 +888,14 @@ models:
         data_type: bigint
       - name: verification_payment_type
         data_type: character varying
-      - name: amount_in_txn_currency
-        data_type: numeric
-        tests:
-          - not_null
       - name: currency
         data_type: character varying
         tests:
           - not_null
+      - name: amount_in_txn_currency
+        data_type: numeric
+        tests:
+          - not_null
       - name: amount_in_gbp
         data_type: numeric
         tests:
@@ -900,7 +904,74 @@ models:
         data_type: character varying
       - name: notes
         data_type: character varying
+    versions:
+      - v: 1
+        deprecation_date: 2024-10-06 00:00:00.00+00:00
 
+      - v: 2
+        columns:
+          - name: total_amount_in_txn_currency
+            data_type: numeric
+            description: |
+              The total amount due created by the interaction, in the currency 
+              of the transaction.
+
+              Should we refund the payment, this is also the amount we will give
+              back to the guest.
+            tests:
+              - not_null
+          - name: total_amount_in_gbp
+            data_type: numeric
+            description: |
+              The total amount due created by the interaction, in GBP.
+
+              Should we refund the payment, this is also the amount we will give
+              back to the guest.
+            tests:
+              - not_null
+          - name: tax_amount_in_txn_currency
+            data_type: numeric
+            description: |
+              The tax amount applicable to this transaction, in the currency of 
+              the transaction.
+
+              If the transaction accrues no taxes, will be 0.
+            tests:
+              - not_null
+          - name: tax_amount_in_gbp
+            data_type: numeric
+            description: |
+              The tax amount applicable to this transaction, in GBP.
+
+              If the transaction accrues no taxes, will be 0.
+            tests:
+              - not_null
+          - name: amount_without_taxes_in_txn_currency
+            data_type: numeric
+            description: |
+              The total amount minus taxes, in the currency of the transaction.
+
+              This is what should be considered net-of-taxes revenue for 
+              Superhog.
+
+              If the transaction accrues no taxes, will be equal to the field
+              total_amount_in_txn_currency.
+            tests:
+              - not_null
+          - name: amount_without_taxes_in_gbp
+            data_type: numeric
+            description: |
+              The total amount minus taxes, in GBP.
+
+              This is what should be considered net-of-taxes revenue for 
+              Superhog.
+
+              If the transaction accrues no taxes, will be equal to the field
+              total_amount_in_txn_currency.
+            tests:
+              - not_null
+          - include: all
+            exclude: [amount_in_txn_currency, amount_in_gbp]
   - name: int_core__country
     description: |
       This model contains information regarding countries, such as codes,