@naturalpay/sdk 0.2.1 → 0.4.0

package/src/resources/transactions.ts

@@ -7,11 +7,11 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 /**
- * Payment and transaction operations
+ * Transaction activity and history operations
  */
 export class Transactions extends APIResource {
   /**
-   * List transactions visible to the authenticated party and its delegated agents.
+   * List transactions visible to your party.
    */
   list(
     params: TransactionListParams | null | undefined = {},
@@ -32,7 +32,7 @@ export class Transactions extends APIResource {
   }
 
   /**
-   * Get a single transaction visible to the authenticated party.
+   * Get a single transaction visible to your party.
    */
   get(
     transactionID: string,
@@ -85,24 +85,11 @@ export namespace TransactionListResponse {
      * Resource attributes
      */
     export interface Attributes {
-      /**
-       * Agent that initiated this transaction. Null when initiated by a human user.
-       */
-      agentId: string | null;
-
       /**
        * Amount in cents
        */
       amount: number;
 
-      /**
-       * Classification from the authenticated party's perspective. Derived from
-       * transactionType + direction: "sent"/"received" for wallet-to-wallet payments
-       * (OUTBOUND/INBOUND), "deposit"/"withdrawal" for external transfers
-       * (INBOUND/OUTBOUND).
-       */
-      category: 'sent' | 'received' | 'deposit' | 'withdrawal';
-
       /**
        * When this transaction was created
        */
@@ -113,11 +100,6 @@ export namespace TransactionListResponse {
        */
       currency: string;
 
-      /**
-       * Customer name if delegated
-       */
-      customerName: string | null;
-
       /**
        * Payment description
        */
@@ -129,34 +111,10 @@ export namespace TransactionListResponse {
       direction: 'INBOUND' | 'OUTBOUND';
 
       /**
-       * Active dispute ID when a dispute has been filed for this transaction
-       */
-      disputeId: string | null;
-
-      /**
-       * Pending escalation ID when this transaction requires approval
-       */
-      escalationId: string | null;
-
-      /**
-       * Display name of the user or agent that initiated this transaction
-       */
-      initiatorName: string | null;
-
-      /**
-       * True if this is a delegated customer payment
+       * Projected funds-available time for transfers. Null when no projection exists and
+       * null for payments.
        */
-      isDelegated: boolean;
-
-      /**
-       * Recipient display name
-       */
-      recipientName: string | null;
-
-      /**
-       * Sender display name
-       */
-      senderName: string | null;
+      expectedAvailableAt: string | null;
 
       /**
        * Transaction status
@@ -184,19 +142,21 @@ export namespace TransactionListResponse {
       destinationParty: Relationships.DestinationParty;
 
       /**
-       * Destination wallet
+       * Source party
        */
-      destinationWallet: Relationships.DestinationWallet;
+      sourceParty: Relationships.SourceParty;
 
       /**
-       * Source party
+       * Payment that produced this transaction. Present only when the authenticated
+       * caller can access the payment resource.
        */
-      sourceParty: Relationships.SourceParty;
+      payment?: Relationships.Payment;
 
       /**
-       * Source wallet
+       * Transfer that produced this transaction. Present only when the authenticated
+       * caller can access the transfer resource.
        */
-      sourceWallet: Relationships.SourceWallet;
+      transfer?: Relationships.Transfer;
     }
 
     export namespace Relationships {
@@ -225,16 +185,16 @@ export namespace TransactionListResponse {
       }
 
       /**
-       * Destination wallet
+       * Source party
        */
-      export interface DestinationWallet {
+      export interface SourceParty {
         /**
          * Related resource identifier
          */
-        data: DestinationWallet.Data | null;
+        data: SourceParty.Data | null;
       }
 
-      export namespace DestinationWallet {
+      export namespace SourceParty {
         /**
          * Related resource identifier
          */
@@ -249,16 +209,17 @@ export namespace TransactionListResponse {
       }
 
       /**
-       * Source party
+       * Payment that produced this transaction. Present only when the authenticated
+       * caller can access the payment resource.
        */
-      export interface SourceParty {
+      export interface Payment {
         /**
          * Related resource identifier
          */
-        data: SourceParty.Data | null;
+        data: Payment.Data;
       }
 
-      export namespace SourceParty {
+      export namespace Payment {
         /**
          * Related resource identifier
          */
@@ -273,16 +234,17 @@ export namespace TransactionListResponse {
       }
 
       /**
-       * Source wallet
+       * Transfer that produced this transaction. Present only when the authenticated
+       * caller can access the transfer resource.
        */
-      export interface SourceWallet {
+      export interface Transfer {
         /**
          * Related resource identifier
          */
-        data: SourceWallet.Data | null;
+        data: Transfer.Data;
       }
 
-      export namespace SourceWallet {
+      export namespace Transfer {
         /**
          * Related resource identifier
          */
@@ -340,24 +302,11 @@ export namespace TransactionGetResponse {
      * Resource attributes
      */
     export interface Attributes {
-      /**
-       * Agent that initiated this transaction. Null when initiated by a human user.
-       */
-      agentId: string | null;
-
       /**
        * Amount in cents
        */
       amount: number;
 
-      /**
-       * Classification from the authenticated party's perspective. Derived from
-       * transactionType + direction: "sent"/"received" for wallet-to-wallet payments
-       * (OUTBOUND/INBOUND), "deposit"/"withdrawal" for external transfers
-       * (INBOUND/OUTBOUND).
-       */
-      category: 'sent' | 'received' | 'deposit' | 'withdrawal';
-
       /**
        * When this transaction was created
        */
@@ -368,11 +317,6 @@ export namespace TransactionGetResponse {
        */
       currency: string;
 
-      /**
-       * Customer name if delegated
-       */
-      customerName: string | null;
-
       /**
        * Payment description
        */
@@ -384,34 +328,10 @@ export namespace TransactionGetResponse {
       direction: 'INBOUND' | 'OUTBOUND';
 
       /**
-       * Active dispute ID when a dispute has been filed for this transaction
-       */
-      disputeId: string | null;
-
-      /**
-       * Pending escalation ID when this transaction requires approval
-       */
-      escalationId: string | null;
-
-      /**
-       * Display name of the user or agent that initiated this transaction
-       */
-      initiatorName: string | null;
-
-      /**
-       * True if this is a delegated customer payment
+       * Projected funds-available time for transfers. Null when no projection exists and
+       * null for payments.
        */
-      isDelegated: boolean;
-
-      /**
-       * Recipient display name
-       */
-      recipientName: string | null;
-
-      /**
-       * Sender display name
-       */
-      senderName: string | null;
+      expectedAvailableAt: string | null;
 
       /**
        * Transaction status
@@ -439,19 +359,21 @@ export namespace TransactionGetResponse {
       destinationParty: Relationships.DestinationParty;
 
       /**
-       * Destination wallet
+       * Source party
        */
-      destinationWallet: Relationships.DestinationWallet;
+      sourceParty: Relationships.SourceParty;
 
       /**
-       * Source party
+       * Payment that produced this transaction. Present only when the authenticated
+       * caller can access the payment resource.
        */
-      sourceParty: Relationships.SourceParty;
+      payment?: Relationships.Payment;
 
       /**
-       * Source wallet
+       * Transfer that produced this transaction. Present only when the authenticated
+       * caller can access the transfer resource.
        */
-      sourceWallet: Relationships.SourceWallet;
+      transfer?: Relationships.Transfer;
     }
 
     export namespace Relationships {
@@ -480,16 +402,16 @@ export namespace TransactionGetResponse {
       }
 
       /**
-       * Destination wallet
+       * Source party
        */
-      export interface DestinationWallet {
+      export interface SourceParty {
         /**
          * Related resource identifier
          */
-        data: DestinationWallet.Data | null;
+        data: SourceParty.Data | null;
       }
 
-      export namespace DestinationWallet {
+      export namespace SourceParty {
         /**
          * Related resource identifier
          */
@@ -504,16 +426,17 @@ export namespace TransactionGetResponse {
       }
 
       /**
-       * Source party
+       * Payment that produced this transaction. Present only when the authenticated
+       * caller can access the payment resource.
        */
-      export interface SourceParty {
+      export interface Payment {
         /**
          * Related resource identifier
          */
-        data: SourceParty.Data | null;
+        data: Payment.Data;
       }
 
-      export namespace SourceParty {
+      export namespace Payment {
         /**
          * Related resource identifier
          */
@@ -528,16 +451,17 @@ export namespace TransactionGetResponse {
       }
 
       /**
-       * Source wallet
+       * Transfer that produced this transaction. Present only when the authenticated
+       * caller can access the transfer resource.
        */
-      export interface SourceWallet {
+      export interface Transfer {
         /**
          * Related resource identifier
          */
-        data: SourceWallet.Data | null;
+        data: Transfer.Data;
       }
 
-      export namespace SourceWallet {
+      export namespace Transfer {
         /**
          * Related resource identifier
          */