fix: include support for REFUND and CREDIT in TransactionSubType for refunds and credit reversals

PiperOrigin-RevId: 530464856

google/cloud/paymentgateway/issuerswitch/v1/common_fields.proto

@@ -321,6 +321,9 @@ enum ApiType {
 
   // Voucher confirmation API. Maps to UPI's `VoucherConfirmation` API.
   VOUCHER_CONFIRMATION = 14;
+
+  // Activation API. Maps to UPI's `Activation` API.
+  ACTIVATION = 15;
 }
 
 // The type of a transaction. Every transaction processed by the issuer switch
@@ -429,6 +432,14 @@ enum TransactionType {
   // Validate customer transaction type. This is associated with
   // `VALIDATE_CUSTOMER` API type. Maps to UPI's `ValCust` type.
   TRANSACTION_TYPE_VALIDATE_CUSTOMER = 25;
+
+  // Activation international transaction type. This is associated with
+  // 'ACTIVATION' API type. Maps to UPI's `International` type.
+  TRANSACTION_TYPE_ACTIVATION_INTERNATIONAL = 26;
+
+  // Activation UPI services transaction type. This is associated with
+  // 'ACTIVATION' API type. Maps to UPI's `UPI Services` type.
+  TRANSACTION_TYPE_ACTIVATION_UPI_SERVICES = 27;
 }
 
 // XmlApiType specifies the API type of the request or response as specified in
@@ -532,4 +543,10 @@ enum XmlApiType {
   // Transaction confirmation response API type. Maps to UPI's
   // `RespTxnConfirmation` API.
   RESP_TXN_CONFIRMATION = 30;
+
+  // Activation request API type. Maps to UPI's `ReqActivation` API.
+  REQ_ACTIVATION = 31;
+
+  // Activation response API type. Maps to UPI's `RespActivation` API.
+  RESP_ACTIVATION = 32;
 }

google/cloud/paymentgateway/issuerswitch/v1/transactions.proto

@@ -448,12 +448,12 @@ service IssuerSwitchTransactions {
   // 1. `StartDate`
   //     * **Min Length** - 10 characters
   //     * **Max Length** - 10 characters
-  //     * **Description** - The start date of the mandate in `YYYY-MM-DD`
+  //     * **Description** - The start date of the mandate in `DD-MM-YYYY`
   //     format.
   // 1. `EndDate`
   //     * **Min Length** - 10 characters
   //     * **Max Length** - 10 characters
-  //     * **Description** - The end date of the mandate in `YYYY-MM-DD` format.
+  //     * **Description** - The end date of the mandate in `DD-MM-YYYY` format.
   // 1. `AmountRuleType`
   //     * **Description** - The amount rule of the mandate. The value will be
   //     of the
@@ -710,6 +710,11 @@ message TransactionInfo {
     // with the transaction type as `TRANSACTION_TYPE_CREDIT` when the payment
     // was initiated in response to a refund.
     REFUND = 6;
+
+    // Credit subtype. This is used in a `SETTLE_PAYMENT` API type transaction,
+    // with the transaction type as `TRANSACTION_TYPE_REVERSAL` when the
+    // original payment was a credit request.
+    CREDIT = 7;
   }
 
   // Common metadata about an API transaction.
@@ -1186,12 +1191,6 @@ message ListFinancialTransactionsRequest {
   // The following fields in the `FinancialTransaction` are eligible for
   // filtering:
   //
-  //   * `transactionType` - The transaction type of the financial
-  //   transaction. Must be one of
-  //   [TransactionType][google.cloud.paymentgateway.issuerswitch.v1.TransactionType]
-  //   values. For financial transactions, only valid transaction types are
-  //   `TRANSACTION_TYPE_CREDIT`, `TRANSACTION_TYPE_DEBIT` and
-  //   `TRANSACTION_TYPE_REVERSAL`. Allowed comparison operators: `=`.
   //   * `transactionID` - The UPI transaction ID of the financial
   //   transaction. Allowed comparison operators: `=`.
   //   * `RRN` - The retrieval reference number of the transaction. Allowed
@@ -1204,20 +1203,10 @@ message ListFinancialTransactionsRequest {
   //      transaction. Allowed comparison operators: `=`.
   //   * `payeeMobileNumber` - The mobile number of the payee in a financial
   //      transaction. Allowed comparison operators: `=`.
-  //   * `payeeMerchantId` - The merchant id of the payee in a financial
-  //      transaction. Allowed comparison operators: `=`.
   //   * `createTime` - The time at which the transaction was created
   //   (received) by the issuer switch. The value should be in
   //   the format `YYYY-MM-DDTHH:MM:SSZ`. Allowed comparison operators: `>`,
   //   `<`.
-  //   * `state` - The state of the transaction. Must be one of
-  //   [TransactionInfo.State][google.cloud.paymentgateway.issuerswitch.v1.TransactionInfo.State]
-  //   values. Allowed comparison operators: `=`.
-  //   * `errorCode` - Use this filter to list financial transactions which
-  //   have failed a particular error code. Allowed comparison operators: `=`.
-  //   * `adapterRequestID` - Adapter request ID used when invoking the Bank or
-  //   Card Adapter API for fulfilling a transaction request. Allowed comparison
-  //   operators: `=`.
   //
   // You can combine multiple expressions by enclosing each expression in
   // parentheses. Expressions are combined with AND logic. No other logical
@@ -1225,12 +1214,11 @@ message ListFinancialTransactionsRequest {
   //
   // Here are a few examples:
   //
-  //   * `transactionType = CREDIT` - The transaction type is _CREDIT_.
-  //   * `state = SUCCEEDED` - The transaction's state is _SUCCEEDED_.
-  //   * `payerVpa = example@okbank` - The VPA of the payer is the string
-  //   _example@okbank_.
-  //   * `(transactionType = DEBIT) AND (createTime < "2021-08-15T14:50:00Z")`
-  //   - The transaction type is _DEBIT_ and the transaction was received
+  //   * `rrn = 123456789123` - The RRN is _123456789123_.
+  //   * `payerVpa = example@goog` - The VPA of the payer is the string
+  //   _example@goog_.
+  //   * `(payeeVpa = example@goog) AND (createTime < "2021-08-15T14:50:00Z")`
+  //   - The VPA of the payee is _example@goog_ and the transaction was received
   //   before _2021-08-15 14:50:00 UTC_.
   //   * `createTime > "2021-08-15T14:50:00Z" AND createTime <
   //   "2021-08-16T14:50:00Z"` - The transaction was received between