@gofynd/fdk-client-javascript 1.4.14 → 1.4.15-beta.10

package/sdk/platform/Payment/PaymentPlatformModel.js

@@ -1,14 +1,14 @@
 const Joi = require("joi");
 
 /**
- * @typedef PaymentGatewayConfigDetails
- * @property {Object[]} [aggregators] - List of all speceific Payment options
- *   with their Details.
+ * @typedef PaymentGatewayConfigResponse
+ * @property {Object[]} [aggregators] - List of all config specific to the
+ *   aggregator with their Details.
  * @property {string} app_id - Application Id to which Payment config Mapped
- * @property {string[]} excluded_fields - List of all excluded options with their Details.
+ * @property {string[]} excluded_fields - List of all excluded config with their Details.
  * @property {boolean} success - Response is successful or not
  * @property {boolean} created - Response is created or not
- * @property {string[]} display_fields - List of all included options with their Details.
+ * @property {string[]} display_fields - List of all display related configs, i.e. logo
  */
 
 /**
@@ -24,11 +24,12 @@ const Joi = require("joi");
  * @property {string} config_type - Config Type of the aggregator
  * @property {boolean} [is_active] - Enable or Disable Flag
  * @property {string} key - Api key of the payment aggregator
- * @property {string} merchant_salt - Merchant key of the payment aggregator
+ * @property {string} merchant_salt - The secret key or token provided by the
+ *   payment aggregator for the merchant.
  */
 
 /**
- * @typedef PaymentGatewayConfigCreation
+ * @typedef PaymentGatewayConfigRequest
  * @property {string} app_id - Application Id to which Payment config Mapped
  * @property {boolean} [is_active] - Enable or Disable Flag
  * @property {PaymentGatewayConfig} [aggregator_name]
@@ -47,7 +48,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef HttpErrorDetails
+ * @typedef HttpErrorCodeAndResponse
  * @property {ErrorCodeAndDescription} error
  * @property {boolean} success - Response is successful or not
  */
@@ -61,11 +62,11 @@ const Joi = require("joi");
 /**
  * @typedef ProductCODData
  * @property {Object} [items] - Item id with its cod availability.
- * @property {CODChargesLimitsDetails} [cod_charges]
+ * @property {CODChargesLimitsResponse} [cod_charges]
  */
 
 /**
- * @typedef CODChargesLimitsDetails
+ * @typedef CODChargesLimitsResponse
  * @property {number} [max_cart_value] - Max allowed cart value for cod order.
  * @property {number} [min_cart_value] - Min allowed cart value for cod order.
  * @property {number} [cod_charge] - Cod charges to be applied on order.
@@ -181,7 +182,7 @@ const Joi = require("joi");
 /**
  * @typedef PaymentOptionAndFlow
  * @property {RootPaymentMode[]} payment_option - Payment options
- * @property {PaymentFlow} payment_flows
+ * @property {PaymentFlow} [payment_flows]
  * @property {PaymentDefaultSelection} [payment_default_selection]
  */
 
@@ -220,7 +221,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentModeRouteDetails
+ * @typedef PaymentModeRouteResponse
  * @property {PaymentOptionAndFlow} payment_options
  * @property {boolean} success - Response is successful or not
  * @property {Object} [payment_breakup] - Payment Breakup for advance payment
@@ -228,7 +229,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentOptionsDetails
+ * @typedef PaymentOptionsResponse
  * @property {PaymentOptions} payment_options
  * @property {boolean} success - Response is successful or not
  * @property {Object} [payment_breakup] - Payment Breakup for advance payment
@@ -275,7 +276,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PayoutsDetails
+ * @typedef PayoutsResponse
  * @property {boolean} success - Response is successful or not
  * @property {Payout[]} items - Contains list of PayoutSchema
  */
@@ -295,7 +296,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PayoutCreation
+ * @typedef PayoutRequest
  * @property {string} aggregator - Aggregator Name
  * @property {Object} users - Payout users object
  * @property {string} unique_external_id - Unique Id of Payout
@@ -305,7 +306,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PayoutDetails
+ * @typedef PayoutResponse
  * @property {string} payment_status - Status of payment
  * @property {Object} users - Users details object
  * @property {string} aggregator - Aggregator Name
@@ -319,58 +320,58 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef UpdatePayoutDetails
+ * @typedef UpdatePayoutResponse
  * @property {boolean} is_default - Enable or Disable Default Payout
  * @property {boolean} is_active - Enable or DIsable Flag Payout
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef UpdatePayoutCreation
+ * @typedef UpdatePayoutRequest
  * @property {boolean} is_default - Enable or Disable Default Payout
  * @property {boolean} is_active - Enable or Disable Flag Payout
  * @property {string} unique_external_id - Unique Id of Payout
  */
 
 /**
- * @typedef DeletePayoutDetails
+ * @typedef DeletePayoutResponse
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef SubscriptionPaymentMethodDetails
+ * @typedef SubscriptionPaymentMethodResponse
  * @property {Object[]} data - Subscription Payment Method Object
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef DeleteSubscriptionPaymentMethodDetails
+ * @typedef DeleteSubscriptionPaymentMethodResponse
  * @property {boolean} success - Success or failure.
  */
 
 /**
- * @typedef SubscriptionConfigDetails
+ * @typedef SubscriptionConfigResponse
  * @property {string} aggregator - Aggregator Name
  * @property {Object} config - Aggregator Config
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef SaveSubscriptionSetupIntentCreation
+ * @typedef SaveSubscriptionSetupIntentRequest
  * @property {string} unique_external_id - Unique id i.e company:id
  */
 
 /**
- * @typedef SaveSubscriptionSetupIntentDetails
+ * @typedef SaveSubscriptionSetupIntentResponse
  * @property {Object} data - Subscription Payment Method Object
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef RefundAccountDetails
- * @property {boolean} [is_verified_flag]
- * @property {string} message - Response message
- * @property {Object} [data] - Refund account data.
+ * @typedef RefundAccountResponse
+ * @property {boolean} [is_verified_flag] - Account is verified or not
+ * @property {string} [message] - Response message
+ * @property {Object} data - Refund account data.
  * @property {boolean} success - Success or failure flag.
  */
 
@@ -383,21 +384,21 @@ const Joi = require("joi");
 
 /**
  * @typedef BankDetailsForOTP
- * @property {string} ifsc_code
- * @property {string} account_no
- * @property {string} branch_name
- * @property {string} bank_name
- * @property {string} account_holder
+ * @property {string} ifsc_code - IFSC code of account
+ * @property {string} account_no - Account number
+ * @property {string} branch_name - Branch name of account
+ * @property {string} bank_name - Bank name of account
+ * @property {string} account_holder - Accountg holder name of account
  */
 
 /**
- * @typedef AddBeneficiaryDetailsOTPCreation
- * @property {string} order_id
+ * @typedef AddBeneficiaryDetailsOTPRequest
+ * @property {string} order_id - Order_id for which account will be added
  * @property {BankDetailsForOTP} details
  */
 
 /**
- * @typedef IfscCodeDetails
+ * @typedef IfscCodeResponse
  * @property {string} branch_name - Branch Name Of Account
  * @property {boolean} [success] - Response is successful or not
  * @property {string} bank_name - Bank Name Of Account
@@ -415,11 +416,11 @@ const Joi = require("joi");
  * @property {string} display_name - Display Name Of Account
  * @property {string} [delights_user_name] - User Id Who filled the Beneficiary
  * @property {string} transfer_mode - Transfer Mode Of Account
- * @property {string} email - EMail of User
+ * @property {string} email - Email of User
  * @property {boolean} is_active - Boolean Flag whether Beneficiary set or not
  * @property {string} [branch_name] - Branch Name Of Account
  * @property {string} address - Address of User
- * @property {string} modified_on - MOdification Date of Beneficiary
+ * @property {string} modified_on - Modification Date of Beneficiary
  * @property {string} beneficiary_id - Benenficiary Id
  * @property {string} account_no - Account Number
  * @property {string} bank_name - Bank Name Of Account
@@ -427,14 +428,14 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef OrderBeneficiaryFetchResults
+ * @typedef OrderBeneficiaryResponse
  * @property {OrderBeneficiaryDetails[]} [beneficiaries] - All Beneficiaries Of An Order
  * @property {boolean} [show_beneficiary_details] - Show beneficiary details or not.
  */
 
 /**
  * @typedef MultiTenderPaymentMeta
- * @property {Object} [extra_meta]
+ * @property {Object} [extra_meta] - Key value pair for extra data related to payment mode
  * @property {string} [order_id] - Fynd Platform order ID
  * @property {string} [payment_id] - A unique identifier associated with a
  *   specific payment transaction
@@ -452,17 +453,17 @@ const Joi = require("joi");
  * @property {string} [name] - Payment mode name
  * @property {MultiTenderPaymentMeta} [meta]
  * @property {number} amount - Payment amount
- * @property {string} mode
+ * @property {string} mode - Payment mode short code
  */
 
 /**
- * @typedef PaymentConfirmationCreation
+ * @typedef PaymentConfirmationRequest
  * @property {string} order_id - Unique order id
  * @property {MultiTenderPaymentMethod[]} payment_methods
  */
 
 /**
- * @typedef PaymentConfirmationDetails
+ * @typedef PaymentConfirmationResponse
  * @property {string} order_id - Unique order id
  * @property {string} message - Message
  * @property {boolean} success - Payment confirmation updated or not.
@@ -478,13 +479,37 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef GetUserCODLimitDetails
- * @property {CODdata} user_cod_data
+ * @typedef CODLimitConfig
+ * @property {number} storefront - Limit for storefront
+ * @property {number} pos - Limit for pos
+ */
+
+/**
+ * @typedef CODPaymentLimitConfig
+ * @property {boolean} is_active - Boolean flag to show the status
+ * @property {number} usages - Used cod limit
+ * @property {number} user_id - User_id
+ * @property {string} merchant_user_id - Merchant_user_id
+ * @property {number} remaining_limit - Remaining COD limit
+ * @property {CODLimitConfig} limit
+ */
+
+/**
+ * @typedef GetUserBULimitResponse
+ * @property {string} business_unit - COD limit business unit
+ * @property {string} display_name - Display name for cod limit
+ * @property {CODPaymentLimitConfig} config
+ */
+
+/**
+ * @typedef GetUserCODLimitResponse
+ * @property {GetUserBULimitResponse[]} items
  * @property {boolean} success - Response is successful or not
+ * @property {string} [message] - Message for cod limit
  */
 
 /**
- * @typedef SetCODForUserCreation
+ * @typedef SetCODForUserRequest
  * @property {string} [business_unit] - Business unit
  * @property {string} mobileno - Mobile No. of User
  * @property {boolean} is_active - Either true or false
@@ -492,7 +517,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef SetCODOptionDetails
+ * @typedef SetCODOptionResponse
  * @property {string} message - Message
  * @property {boolean} success - Response is successful or not
  */
@@ -505,7 +530,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef EdcAggregatorAndModelListDetails
+ * @typedef EdcAggregatorAndModelListResponse
  * @property {EdcModelData[]} data - List of aggregators and their edc models
  * @property {boolean} success - Response is successful or not
  */
@@ -517,13 +542,13 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef EdcDeviceStatsDetails
+ * @typedef EdcDeviceStatsResponse
  * @property {StatisticsData} statistics
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef EdcAddCreation
+ * @typedef EdcAddRequest
  * @property {string} edc_model - Model of the edc machine
  * @property {number} store_id - Store at which devices is to used
  * @property {number} aggregator_id - Aggregator which will accept payment
@@ -550,19 +575,19 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef EdcDeviceAddDetails
+ * @typedef EdcDeviceAddResponse
  * @property {EdcDevice} data
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef EdcDeviceDetails
+ * @typedef EdcDeviceDetailsResponse
  * @property {EdcDevice} data
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef EdcUpdate
+ * @typedef EdcUpdateRequest
  * @property {string} [edc_model] - Model of the edc machine
  * @property {number} [store_id] - Store at which devices is to used
  * @property {number} [aggregator_id] - Aggregator which will accept payment
@@ -573,7 +598,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef EdcDeviceUpdateDetails
+ * @typedef EdcDeviceUpdateResponse
  * @property {boolean} success - Response is successful or not
  */
 
@@ -589,7 +614,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef EdcDeviceListDetails
+ * @typedef EdcDeviceListResponse
  * @property {EdcDevice[]} items - List of all edc mapped to the application
  *   options with their Details.
  * @property {Page} page
@@ -597,7 +622,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentInitializationCreation
+ * @typedef PaymentInitializationRequest
  * @property {string} [razorpay_payment_id] - Payment gateway payment id
  * @property {string} [device_id] - EDC machine Unique Identifier
  * @property {string} email - Customer valid email
@@ -614,7 +639,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentInitializationDetails
+ * @typedef PaymentInitializationResponse
  * @property {string} [razorpay_payment_id] - Payment id.
  * @property {string} [device_id] - EDC machine Unique Identifier
  * @property {string} [upi_poll_url] - UPI poll url.
@@ -635,7 +660,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentStatusUpdateCreation
+ * @typedef PaymentStatusUpdateRequest
  * @property {string} [device_id] - EDC machine Unique Identifier
  * @property {string} email - Customer valid email
  * @property {string} customer_id - Payment gateway customer id.
@@ -652,7 +677,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentStatusUpdateDetails
+ * @typedef PaymentStatusUpdateResponse
  * @property {string} [redirect_url] - Redirect url
  * @property {boolean} retry - Response is successful or not.
  * @property {boolean} [success] - Response is successful or not
@@ -661,7 +686,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef ResendOrCancelPaymentCreation
+ * @typedef ResendOrCancelPaymentRequest
  * @property {string} order_id - Unique order id
  * @property {string} [device_id] - EDC machine Unique Identifier
  * @property {string} request_type - Either resend or cancel
@@ -676,18 +701,18 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef ResendOrCancelPaymentDetails
+ * @typedef ResendOrCancelPaymentResponse
  * @property {LinkStatus} data
  * @property {boolean} success - Response is successful or not.
  */
 
 /**
- * @typedef PaymentStatusBulkHandlerCreation
+ * @typedef PaymentStatusBulkHandlerRequest
  * @property {string[]} merchant_order_id - List of order ids
  */
 
 /**
- * @typedef PaymentObjectList
+ * @typedef PaymentObjectListSerializer
  * @property {Object} user_object
  * @property {string} modified_on
  * @property {string} collected_by
@@ -711,11 +736,11 @@ const Joi = require("joi");
 /**
  * @typedef PaymentStatusObject
  * @property {string} merchant_order_id
- * @property {PaymentObjectList[]} [payment_object_list]
+ * @property {PaymentObjectListSerializer[]} [payment_object_list]
  */
 
 /**
- * @typedef PaymentStatusBulkHandlerDetails
+ * @typedef PaymentStatusBulkHandlerResponse
  * @property {number} [count]
  * @property {PaymentStatusObject[]} [data]
  * @property {string} success
@@ -724,7 +749,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef GetOauthUrlDetails
+ * @typedef GetOauthUrlResponse
  * @property {string} url - The url to call for authenticating
  * @property {boolean} success - Response is successful or not
  */
@@ -759,13 +784,13 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef RepaymentDetails
+ * @typedef RepaymentResponse
  * @property {Object} data
  * @property {boolean} success - Success/Failure of the transaction
  */
 
 /**
- * @typedef MerchantOnBoardingCreation
+ * @typedef MerchantOnBoardingRequest
  * @property {string} credit_line_id - Merchant ID at Ajiodhan's end
  * @property {string} aggregator - Payment aggregator name
  * @property {string} app_id - Application id
@@ -774,13 +799,13 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef MerchantOnBoardingDetails
+ * @typedef MerchantOnBoardingResponse
  * @property {Object} data
  * @property {boolean} success - Success/Failure of the transaction
  */
 
 /**
- * @typedef ValidateCustomerCreation
+ * @typedef ValidateCustomerRequest
  * @property {string} phone_number - User mobile number without country code.
  * @property {string} aggregator - Payment gateway name in camel case i.e Simpl, Rupifi
  * @property {string} [payload] - Hashed payload string.
@@ -792,14 +817,14 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef ValidateCustomerDetails
+ * @typedef ValidateCustomerResponse
  * @property {string} message - Error or success message.
  * @property {Object} [data] - Payment gateway response data
  * @property {boolean} success - Response is successful or not
  */
 
 /**
- * @typedef GetPaymentLinkDetails
+ * @typedef GetPaymentLinkResponse
  * @property {string} message - Message
  * @property {number} status_code - HTTP status code
  * @property {number} [amount] - Total value of order
@@ -807,7 +832,8 @@ const Joi = require("joi");
  * @property {string} [payment_link_url] - Url of payment link
  * @property {string} [payment_link_current_status] - Status of payment link
  * @property {string} [external_order_id] - Merchant order id
- * @property {number} [polling_timeout] - Polling request timeout
+ * @property {number} [polling_timeout] - Polling request timeout, perform
+ *   polling till timeout elapsed or payment status is success/failure
  * @property {boolean} success - Successful or failure
  */
 
@@ -824,7 +850,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef ErrorDetails
+ * @typedef ErrorResponse
  * @property {number} status_code - HTTP status code
  * @property {ErrorDescription} [error]
  * @property {string} message - Message
@@ -833,14 +859,15 @@ const Joi = require("joi");
 
 /**
  * @typedef CreatePaymentLinkMeta
- * @property {string} cart_id
- * @property {string} checkout_mode
- * @property {string} amount
- * @property {string} [assign_card_id]
+ * @property {string} cart_id - Cart id for which payment link needs to be generated.
+ * @property {string} checkout_mode - Checkout mode for the payment link i.e. self
+ * @property {string} amount - Payment link amount to be paid by the customer
+ * @property {string} [assign_card_id] - Assigned card id against which payment
+ *   to be done via payment link
  */
 
 /**
- * @typedef CreatePaymentLinkCreation
+ * @typedef CreatePaymentLinkRequest
  * @property {string} email - Email to which the payment link is to be sent
  * @property {number} amount - Total value of order
  * @property {string} mobile_number - Mobile number to which the payment link is
@@ -849,14 +876,10 @@ const Joi = require("joi");
  * @property {string} [description] - Merchant order id
  * @property {CreatePaymentLinkMeta} meta
  * @property {string} external_order_id - Merchant order id
- * @property {string} [success_redirection_url] - URL to which the user will be
- *   redirected after a successful payment.
- * @property {string} [failure_redirection_url] - URL to which the user will be
- *   redirected if the payment fails.
  */
 
 /**
- * @typedef CreatePaymentLinkDetails
+ * @typedef CreatePaymentLinkResponse
  * @property {string} message - Message
  * @property {number} status_code - HTTP status code
  * @property {string} [payment_link_url] - Url of payment link
@@ -866,7 +889,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PollingPaymentLinkDetails
+ * @typedef PollingPaymentLinkResponse
  * @property {string} [message] - Message
  * @property {number} [http_status] - HTTP status code
  * @property {number} [status_code] - HTTP status code
@@ -880,12 +903,12 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef CancelOrResendPaymentLinkCreation
+ * @typedef CancelOrResendPaymentLinkRequest
  * @property {string} payment_link_id - Unique id of payment link
  */
 
 /**
- * @typedef ResendPaymentLinkDetails
+ * @typedef ResendPaymentLinkResponse
  * @property {number} status_code - HTTP status code
  * @property {string} message - Message
  * @property {number} [polling_timeout] - Polling request timeout
@@ -893,7 +916,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef CancelPaymentLinkDetails
+ * @typedef CancelPaymentLinkResponse
  * @property {number} status_code - HTTP status code
  * @property {string} message - Message
  * @property {boolean} success - Successful or failure
@@ -920,20 +943,20 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef GetPaymentCodeDetails
+ * @typedef GetPaymentCodeResponse
  * @property {GetPaymentCode} data
  * @property {boolean} success - Response is successful or not.
  */
 
 /**
- * @typedef PlatformPaymentModeDetails
+ * @typedef PlatformPaymentModeResponse
  * @property {string} [message] - Message
  * @property {Object[]} [items] - List of all aggregator and payment mode details.
  * @property {boolean} success - Response is successful or not.
  */
 
 /**
- * @typedef MerchnatPaymentModeCreation
+ * @typedef MerchnatPaymentModeRequest
  * @property {Object} [offline] - Details to be updated for online payment configuration.
  * @property {Object} [online] - Details to be updated for offline payment configuration.
  */
@@ -986,7 +1009,8 @@ const Joi = require("joi");
  * @property {AddressDetail} [shipping_address] - Shipping address
  * @property {number} amount_captured - Amount which is captured or credited to
  *   merchant account
- * @property {number} [amount_refunded]
+ * @property {number} [amount_refunded] - Amount refunded or credited back to
+ *   customer accout
  * @property {string} [aggregator_customer_id] - Unique customer id generated by
  *   payment gateway, not required for standard checkout.
  * @property {string} cancel_url - Cancel url sent by Fynd platform at the time
@@ -1008,13 +1032,13 @@ const Joi = require("joi");
  * @property {AddressDetail} [billing_address] - Billing address
  * @property {boolean} [captured] - Whether the payment is captured (credited to
  *   merchant account) by payment gateway.
- * @property {Object} [meta] - Metadata
- * @property {string} status - Stautus of the payment
+ * @property {Object} [meta] - Extra meta data specific to extension
+ * @property {string} status - Status of the payment
  */
 
 /**
- * @typedef PaymentSessionCreation
- * @property {Object} [meta] - Meta
+ * @typedef PaymentSessionRequestSerializer
+ * @property {Object} [meta] - Extra meta data specific to extensions
  * @property {string} gid - Global identifier of the entity (e.g. order, cart
  *   etc.) against which payment_session was initiated. This is generated by
  *   Fynd payments platform and is unique.
@@ -1025,10 +1049,11 @@ const Joi = require("joi");
  *   the schema `PaymentSessionDetail`.
  * @property {number} total_amount - Amount paid.
  * @property {string} checksum - Checksum to verify the payload
+ * @property {string} [source] - Source of payment update session
  */
 
 /**
- * @typedef PaymentSessionPutDetails
+ * @typedef PaymentSessionResponseSerializer
  * @property {string} gid - Global identifier of the entity (e.g. order, cart
  *   etc.) against which payment_session was initiated. This is generated by
  *   Fynd payments platform and is unique.
@@ -1059,7 +1084,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef RefundSessionCreation
+ * @typedef RefundSessionRequestSerializer
  * @property {Object} [meta] - Meta
  * @property {string} gid - Global identifier of the entity (e.g. order, cart
  *   etc.) against which payment_session was initiated. This is generated by
@@ -1075,7 +1100,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef RefundSessionDetails
+ * @typedef RefundSessionResponseSerializer
  * @property {string} gid - Global identifier of the entity (e.g. order, cart
  *   etc.) against which payment_session was initiated. This is generated by
  *   Fynd payments platform and is unique.
@@ -1086,34 +1111,35 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentDetails
- * @property {Object[]} payment_methods - Method of payment
+ * @typedef PaymentDetailsSerializer
+ * @property {Object[]} payment_methods - List of payment methods
  * @property {string} gid - Global identifier of the entity (e.g. order, cart
  *   etc.) against which payment_session was initiated. This is generated by
  *   Fynd payments platform and is unique.
- * @property {number} [amount_refunded]
+ * @property {number} [amount_refunded] - Already refunded amount for the given
+ *   gid (global identifier for the order).
  * @property {string} currency - Currency of the payment.
  * @property {string} mode - Test or live, test mode uses test credentials so
  *   that actual payment is not created.
- * @property {string} [merchant_locale] - Merchant's locale
- * @property {Object} [meta] - Metadata
+ * @property {string} [merchant_locale] - Merchant's locale (language) i.e. en
+ * @property {Object} [meta] - Extra meta data related to the payment methods
  * @property {string} [kind] - Optional kind of purchase/payment - one time
  *   payment (sale) or subcription. defaults to sale.
  * @property {string} [success_url] - Success url sent by Fynd platform at the
  *   time of payment creation
- * @property {string} status - Stautus of the payment
+ * @property {string} status - Status of the payment
  * @property {boolean} [captured] - Whether the payment is captured (credited to
  *   merchant account) by payment gateway.
  * @property {string} [payment_id] - Unique transaction id generated by payment gateway
  * @property {string} g_user_id - Global user identifier - unique user id
  *   generated by Fynd platform
- * @property {string} [locale] - User's locale
+ * @property {string} [locale] - User's locale (language), i.e. en
  * @property {string} [cancel_url] - Cancel url sent by Fynd platform at the
- *   time of payment creation
+ *   time of payment creation, redirect on payment cancellation
  * @property {string} [created] - Timestamp in epoch
  * @property {number} amount_captured - Amount which is captured or credited to
  *   merchant account
- * @property {number} amount - Amount paid.
+ * @property {number} amount - Amount paid for the order.
  * @property {string} [aggregator_customer_id] - Unique customer id generated by
  *   payment gateway, not required for standard checkout.
  * @property {string} [aggregator_order_id] - Unique order id or payment request
@@ -1121,7 +1147,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef CartDetails
+ * @typedef CartDetailsSerializer
  * @property {Object} items - Items that are added in cart
  * @property {Object[]} articles - List of articles that are added in cart
  * @property {number} cart_value - Total cart value i.e. amount to be paid
@@ -1131,7 +1157,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef RefundDetails
+ * @typedef RefundDetailsSerializer
  * @property {number} amount - Refunded amount
  * @property {string} currency - The currency of the payment.
  * @property {string} request_id - Refund request id, unique id generated by Fynd platform
@@ -1141,7 +1167,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentSessionFetchDetails
+ * @typedef PaymentSessionSerializer
  * @property {Object} payment_details - Object of payment details
  * @property {string} [currency] - The currency of the payment.
  * @property {string} status - The status of the payment session.
@@ -1149,8 +1175,8 @@ const Joi = require("joi");
  * @property {string} gid - Global identifier of the entity (e.g. order, cart
  *   etc.) against which payment_session was initiated. This is generated by
  *   Fynd payments platform and is unique.
- * @property {CartDetails} [cart_details]
- * @property {RefundDetails[]} refund_details - Object of refund details
+ * @property {CartDetailsSerializer} [cart_details]
+ * @property {RefundDetailsSerializer[]} refund_details - Object of refund details
  */
 
 /**
@@ -1161,7 +1187,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef RefundPriorityDetails
+ * @typedef RefundPriorityResponseSerializer
  * @property {string} configuration - Configuration for merchant or customer
  * @property {boolean} success - Success
  * @property {boolean} apportion - Apportion refund to multiple sources
@@ -1170,13 +1196,13 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef RefundPriorityCreation
+ * @typedef RefundPriorityRequestSerializer
  * @property {boolean} apportion - Apportion refund to multiple sources
  * @property {RefundSourcesPriority[]} refund_sources_priority - Refund sources priority
  */
 
 /**
- * @typedef MerchantPaymentModeCreation
+ * @typedef MerchantPaymentModeRequest
  * @property {string} business_unit - Business unit
  * @property {Object[]} items - List of item details with respect to payment_mode
  * @property {Object} device - List of devices and its activation status
@@ -1195,7 +1221,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PlatformPaymentModeCopyConfigCreation
+ * @typedef PlatformPaymentModeCopyConfigRequest
  * @property {FromConfig} from_config
  * @property {ToConfig} to_config
  */
@@ -1217,7 +1243,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentOrderCreation
+ * @typedef PaymentOrderRequest
  * @property {string} order_id - Order id
  * @property {PaymentOrderMethods[]} [payment_methods]
  * @property {string} [shipment_id] - Shipment_id
@@ -1238,7 +1264,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PaymentOrderDetails
+ * @typedef PaymentOrderResponse
  * @property {string} message - Message
  * @property {boolean} success - Successful or failure
  * @property {string} [payment_confirm_url] - Payment confirm url for aggregator
@@ -1256,7 +1282,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef AggregatorVersionDetails
+ * @typedef AggregatorVersionResponse
  * @property {string} message - Message
  * @property {boolean} success - Successful or failure
  * @property {AggregatorVersionItemSchema} [items]
@@ -1270,7 +1296,7 @@ const Joi = require("joi");
  */
 
 /**
- * @typedef PatchAggregatorControl
+ * @typedef AggregatorControlRequest
  * @property {string} [business_unit] - Business unit
  * @property {Object[]} [items] - List of item details with respect to payment_mode
  * @property {string} [device] - Device name
@@ -1332,8 +1358,8 @@ const Joi = require("joi");
  */
 
 class PaymentPlatformModel {
-  /** @returns {PaymentGatewayConfigDetails} */
-  static PaymentGatewayConfigDetails() {
+  /** @returns {PaymentGatewayConfigResponse} */
+  static PaymentGatewayConfigResponse() {
     return Joi.object({
       aggregators: Joi.array().items(Joi.any()),
       app_id: Joi.string().allow("").required(),
@@ -1364,8 +1390,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentGatewayConfigCreation} */
-  static PaymentGatewayConfigCreation() {
+  /** @returns {PaymentGatewayConfigRequest} */
+  static PaymentGatewayConfigRequest() {
     return Joi.object({
       app_id: Joi.string().allow("").required(),
       is_active: Joi.boolean().allow(null),
@@ -1389,8 +1415,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {HttpErrorDetails} */
-  static HttpErrorDetails() {
+  /** @returns {HttpErrorCodeAndResponse} */
+  static HttpErrorCodeAndResponse() {
     return Joi.object({
       error: PaymentPlatformModel.ErrorCodeAndDescription().required(),
       success: Joi.boolean().required(),
@@ -1408,13 +1434,13 @@ class PaymentPlatformModel {
   /** @returns {ProductCODData} */
   static ProductCODData() {
     return Joi.object({
-      items: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
-      cod_charges: PaymentPlatformModel.CODChargesLimitsDetails(),
+      items: Joi.any().allow(null),
+      cod_charges: PaymentPlatformModel.CODChargesLimitsResponse(),
     });
   }
 
-  /** @returns {CODChargesLimitsDetails} */
-  static CODChargesLimitsDetails() {
+  /** @returns {CODChargesLimitsResponse} */
+  static CODChargesLimitsResponse() {
     return Joi.object({
       max_cart_value: Joi.number().allow(null),
       min_cart_value: Joi.number().allow(null),
@@ -1514,8 +1540,8 @@ class PaymentPlatformModel {
   /** @returns {AggregatorRoute} */
   static AggregatorRoute() {
     return Joi.object({
-      data: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
-      payment_flow_data: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
+      data: Joi.any().allow(null),
+      payment_flow_data: Joi.any().allow(null),
       payment_flow: Joi.string().allow("").allow(null),
       api_link: Joi.string().allow("").allow(null),
     }).allow(null);
@@ -1555,7 +1581,7 @@ class PaymentPlatformModel {
       payment_option: Joi.array()
         .items(PaymentPlatformModel.RootPaymentMode())
         .required(),
-      payment_flows: PaymentPlatformModel.PaymentFlow().required(),
+      payment_flows: PaymentPlatformModel.PaymentFlow(),
       payment_default_selection: PaymentPlatformModel.PaymentDefaultSelection(),
     });
   }
@@ -1603,24 +1629,24 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentModeRouteDetails} */
-  static PaymentModeRouteDetails() {
+  /** @returns {PaymentModeRouteResponse} */
+  static PaymentModeRouteResponse() {
     return Joi.object({
       payment_options: PaymentPlatformModel.PaymentOptionAndFlow().required(),
       success: Joi.boolean().required(),
-      payment_breakup: Joi.object().pattern(/\S/, Joi.any()),
+      payment_breakup: Joi.any(),
       advance_payment: Joi.array()
         .items(PaymentPlatformModel.AdvancePaymentObject())
         .allow(null, ""),
     });
   }
 
-  /** @returns {PaymentOptionsDetails} */
-  static PaymentOptionsDetails() {
+  /** @returns {PaymentOptionsResponse} */
+  static PaymentOptionsResponse() {
     return Joi.object({
       payment_options: PaymentPlatformModel.PaymentOptions().required(),
       success: Joi.boolean().required(),
-      payment_breakup: Joi.object().pattern(/\S/, Joi.any()),
+      payment_breakup: Joi.any(),
     });
   }
 
@@ -1674,8 +1700,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PayoutsDetails} */
-  static PayoutsDetails() {
+  /** @returns {PayoutsResponse} */
+  static PayoutsResponse() {
     return Joi.object({
       success: Joi.boolean().required(),
       items: Joi.array().items(PaymentPlatformModel.Payout()).required(),
@@ -1698,11 +1724,11 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PayoutCreation} */
-  static PayoutCreation() {
+  /** @returns {PayoutRequest} */
+  static PayoutRequest() {
     return Joi.object({
       aggregator: Joi.string().allow("").required(),
-      users: Joi.object().pattern(/\S/, Joi.any()).required(),
+      users: Joi.any().required(),
       unique_external_id: Joi.string().allow("").required(),
       is_active: Joi.boolean().required(),
       bank_details: PaymentPlatformModel.PayoutBankDetails().required(),
@@ -1710,24 +1736,24 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PayoutDetails} */
-  static PayoutDetails() {
+  /** @returns {PayoutResponse} */
+  static PayoutResponse() {
     return Joi.object({
       payment_status: Joi.string().allow("").required(),
-      users: Joi.object().pattern(/\S/, Joi.any()).required(),
+      users: Joi.any().required(),
       aggregator: Joi.string().allow("").required(),
       unique_transfer_no: Joi.string().allow("").required(),
       is_active: Joi.boolean().required(),
-      bank_details: Joi.object().pattern(/\S/, Joi.any()).required(),
+      bank_details: Joi.any().required(),
       success: Joi.boolean().required(),
       transfer_type: Joi.string().allow("").required(),
       created: Joi.boolean().required(),
-      payouts: Joi.object().pattern(/\S/, Joi.any()).required(),
+      payouts: Joi.any().required(),
     });
   }
 
-  /** @returns {UpdatePayoutDetails} */
-  static UpdatePayoutDetails() {
+  /** @returns {UpdatePayoutResponse} */
+  static UpdatePayoutResponse() {
     return Joi.object({
       is_default: Joi.boolean().required(),
       is_active: Joi.boolean().required(),
@@ -1735,8 +1761,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {UpdatePayoutCreation} */
-  static UpdatePayoutCreation() {
+  /** @returns {UpdatePayoutRequest} */
+  static UpdatePayoutRequest() {
     return Joi.object({
       is_default: Joi.boolean().required(),
       is_active: Joi.boolean().required(),
@@ -1744,58 +1770,58 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {DeletePayoutDetails} */
-  static DeletePayoutDetails() {
+  /** @returns {DeletePayoutResponse} */
+  static DeletePayoutResponse() {
     return Joi.object({
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {SubscriptionPaymentMethodDetails} */
-  static SubscriptionPaymentMethodDetails() {
+  /** @returns {SubscriptionPaymentMethodResponse} */
+  static SubscriptionPaymentMethodResponse() {
     return Joi.object({
       data: Joi.array().items(Joi.any()).required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {DeleteSubscriptionPaymentMethodDetails} */
-  static DeleteSubscriptionPaymentMethodDetails() {
+  /** @returns {DeleteSubscriptionPaymentMethodResponse} */
+  static DeleteSubscriptionPaymentMethodResponse() {
     return Joi.object({
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {SubscriptionConfigDetails} */
-  static SubscriptionConfigDetails() {
+  /** @returns {SubscriptionConfigResponse} */
+  static SubscriptionConfigResponse() {
     return Joi.object({
       aggregator: Joi.string().allow("").required(),
-      config: Joi.object().pattern(/\S/, Joi.any()).required(),
+      config: Joi.any().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {SaveSubscriptionSetupIntentCreation} */
-  static SaveSubscriptionSetupIntentCreation() {
+  /** @returns {SaveSubscriptionSetupIntentRequest} */
+  static SaveSubscriptionSetupIntentRequest() {
     return Joi.object({
       unique_external_id: Joi.string().allow("").required(),
     });
   }
 
-  /** @returns {SaveSubscriptionSetupIntentDetails} */
-  static SaveSubscriptionSetupIntentDetails() {
+  /** @returns {SaveSubscriptionSetupIntentResponse} */
+  static SaveSubscriptionSetupIntentResponse() {
     return Joi.object({
-      data: Joi.object().pattern(/\S/, Joi.any()).required(),
+      data: Joi.any().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {RefundAccountDetails} */
-  static RefundAccountDetails() {
+  /** @returns {RefundAccountResponse} */
+  static RefundAccountResponse() {
     return Joi.object({
       is_verified_flag: Joi.boolean(),
-      message: Joi.string().allow("").required(),
-      data: Joi.object().pattern(/\S/, Joi.any()),
+      message: Joi.string().allow(""),
+      data: Joi.any().required(),
       success: Joi.boolean().required(),
     });
   }
@@ -1820,16 +1846,16 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {AddBeneficiaryDetailsOTPCreation} */
-  static AddBeneficiaryDetailsOTPCreation() {
+  /** @returns {AddBeneficiaryDetailsOTPRequest} */
+  static AddBeneficiaryDetailsOTPRequest() {
     return Joi.object({
       order_id: Joi.string().allow("").required(),
       details: PaymentPlatformModel.BankDetailsForOTP().required(),
     });
   }
 
-  /** @returns {IfscCodeDetails} */
-  static IfscCodeDetails() {
+  /** @returns {IfscCodeResponse} */
+  static IfscCodeResponse() {
     return Joi.object({
       branch_name: Joi.string().allow("").required(),
       success: Joi.boolean(),
@@ -1862,8 +1888,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {OrderBeneficiaryFetchResults} */
-  static OrderBeneficiaryFetchResults() {
+  /** @returns {OrderBeneficiaryResponse} */
+  static OrderBeneficiaryResponse() {
     return Joi.object({
       beneficiaries: Joi.array()
         .items(PaymentPlatformModel.OrderBeneficiaryDetails())
@@ -1875,7 +1901,7 @@ class PaymentPlatformModel {
   /** @returns {MultiTenderPaymentMeta} */
   static MultiTenderPaymentMeta() {
     return Joi.object({
-      extra_meta: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
+      extra_meta: Joi.any().allow(null),
       order_id: Joi.string().allow(""),
       payment_id: Joi.string().allow(""),
       current_status: Joi.string().allow(""),
@@ -1894,8 +1920,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentConfirmationCreation} */
-  static PaymentConfirmationCreation() {
+  /** @returns {PaymentConfirmationRequest} */
+  static PaymentConfirmationRequest() {
     return Joi.object({
       order_id: Joi.string().allow("").required(),
       payment_methods: Joi.array()
@@ -1904,8 +1930,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentConfirmationDetails} */
-  static PaymentConfirmationDetails() {
+  /** @returns {PaymentConfirmationResponse} */
+  static PaymentConfirmationResponse() {
     return Joi.object({
       order_id: Joi.string().allow("").required(),
       message: Joi.string().allow("").required(),
@@ -1924,16 +1950,48 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {GetUserCODLimitDetails} */
-  static GetUserCODLimitDetails() {
+  /** @returns {CODLimitConfig} */
+  static CODLimitConfig() {
+    return Joi.object({
+      storefront: Joi.number().required(),
+      pos: Joi.number().required(),
+    });
+  }
+
+  /** @returns {CODPaymentLimitConfig} */
+  static CODPaymentLimitConfig() {
     return Joi.object({
-      user_cod_data: PaymentPlatformModel.CODdata().required(),
+      is_active: Joi.boolean().required(),
+      usages: Joi.number().required(),
+      user_id: Joi.number().required(),
+      merchant_user_id: Joi.string().allow("").required(),
+      remaining_limit: Joi.number().required(),
+      limit: PaymentPlatformModel.CODLimitConfig().required(),
+    });
+  }
+
+  /** @returns {GetUserBULimitResponse} */
+  static GetUserBULimitResponse() {
+    return Joi.object({
+      business_unit: Joi.string().allow("").required(),
+      display_name: Joi.string().allow("").required(),
+      config: PaymentPlatformModel.CODPaymentLimitConfig().required(),
+    });
+  }
+
+  /** @returns {GetUserCODLimitResponse} */
+  static GetUserCODLimitResponse() {
+    return Joi.object({
+      items: Joi.array()
+        .items(PaymentPlatformModel.GetUserBULimitResponse())
+        .required(),
       success: Joi.boolean().required(),
+      message: Joi.string().allow(""),
     });
   }
 
-  /** @returns {SetCODForUserCreation} */
-  static SetCODForUserCreation() {
+  /** @returns {SetCODForUserRequest} */
+  static SetCODForUserRequest() {
     return Joi.object({
       business_unit: Joi.string().allow(""),
       mobileno: Joi.string().allow("").required(),
@@ -1942,8 +2000,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {SetCODOptionDetails} */
-  static SetCODOptionDetails() {
+  /** @returns {SetCODOptionResponse} */
+  static SetCODOptionResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
       success: Joi.boolean().required(),
@@ -1959,8 +2017,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {EdcAggregatorAndModelListDetails} */
-  static EdcAggregatorAndModelListDetails() {
+  /** @returns {EdcAggregatorAndModelListResponse} */
+  static EdcAggregatorAndModelListResponse() {
     return Joi.object({
       data: Joi.array().items(PaymentPlatformModel.EdcModelData()).required(),
       success: Joi.boolean().required(),
@@ -1975,16 +2033,16 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {EdcDeviceStatsDetails} */
-  static EdcDeviceStatsDetails() {
+  /** @returns {EdcDeviceStatsResponse} */
+  static EdcDeviceStatsResponse() {
     return Joi.object({
       statistics: PaymentPlatformModel.StatisticsData().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {EdcAddCreation} */
-  static EdcAddCreation() {
+  /** @returns {EdcAddRequest} */
+  static EdcAddRequest() {
     return Joi.object({
       edc_model: Joi.string().allow("").required(),
       store_id: Joi.number().required(),
@@ -2012,24 +2070,24 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {EdcDeviceAddDetails} */
-  static EdcDeviceAddDetails() {
+  /** @returns {EdcDeviceAddResponse} */
+  static EdcDeviceAddResponse() {
     return Joi.object({
       data: PaymentPlatformModel.EdcDevice().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {EdcDeviceDetails} */
-  static EdcDeviceDetails() {
+  /** @returns {EdcDeviceDetailsResponse} */
+  static EdcDeviceDetailsResponse() {
     return Joi.object({
       data: PaymentPlatformModel.EdcDevice().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {EdcUpdate} */
-  static EdcUpdate() {
+  /** @returns {EdcUpdateRequest} */
+  static EdcUpdateRequest() {
     return Joi.object({
       edc_model: Joi.string().allow(""),
       store_id: Joi.number(),
@@ -2041,8 +2099,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {EdcDeviceUpdateDetails} */
-  static EdcDeviceUpdateDetails() {
+  /** @returns {EdcDeviceUpdateResponse} */
+  static EdcDeviceUpdateResponse() {
     return Joi.object({
       success: Joi.boolean().required(),
     });
@@ -2061,8 +2119,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {EdcDeviceListDetails} */
-  static EdcDeviceListDetails() {
+  /** @returns {EdcDeviceListResponse} */
+  static EdcDeviceListResponse() {
     return Joi.object({
       items: Joi.array().items(PaymentPlatformModel.EdcDevice()).required(),
       page: PaymentPlatformModel.Page().required(),
@@ -2070,8 +2128,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentInitializationCreation} */
-  static PaymentInitializationCreation() {
+  /** @returns {PaymentInitializationRequest} */
+  static PaymentInitializationRequest() {
     return Joi.object({
       razorpay_payment_id: Joi.string().allow("").allow(null),
       device_id: Joi.string().allow("").allow(null),
@@ -2081,7 +2139,7 @@ class PaymentPlatformModel {
       aggregator: Joi.string().allow("").required(),
       order_id: Joi.string().allow("").required(),
       currency: Joi.string().allow("").required(),
-      amount: Joi.number().required(),
+      amount: Joi.number().allow(null).required(),
       contact: Joi.string().allow("").required(),
       timeout: Joi.number().allow(null),
       merchant_order_id: Joi.string().allow("").required(),
@@ -2089,8 +2147,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentInitializationDetails} */
-  static PaymentInitializationDetails() {
+  /** @returns {PaymentInitializationResponse} */
+  static PaymentInitializationResponse() {
     return Joi.object({
       razorpay_payment_id: Joi.string().allow("").allow(null),
       device_id: Joi.string().allow("").allow(null),
@@ -2112,8 +2170,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentStatusUpdateCreation} */
-  static PaymentStatusUpdateCreation() {
+  /** @returns {PaymentStatusUpdateRequest} */
+  static PaymentStatusUpdateRequest() {
     return Joi.object({
       device_id: Joi.string().allow("").allow(null),
       email: Joi.string().allow("").required(),
@@ -2122,7 +2180,7 @@ class PaymentPlatformModel {
       aggregator: Joi.string().allow("").required(),
       order_id: Joi.string().allow("").required(),
       currency: Joi.string().allow("").required(),
-      amount: Joi.number().required(),
+      amount: Joi.number().allow(null).required(),
       contact: Joi.string().allow("").required(),
       merchant_order_id: Joi.string().allow("").required(),
       status: Joi.string().allow("").required(),
@@ -2131,8 +2189,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentStatusUpdateDetails} */
-  static PaymentStatusUpdateDetails() {
+  /** @returns {PaymentStatusUpdateResponse} */
+  static PaymentStatusUpdateResponse() {
     return Joi.object({
       redirect_url: Joi.string().allow("").allow(null),
       retry: Joi.boolean().required(),
@@ -2142,8 +2200,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {ResendOrCancelPaymentCreation} */
-  static ResendOrCancelPaymentCreation() {
+  /** @returns {ResendOrCancelPaymentRequest} */
+  static ResendOrCancelPaymentRequest() {
     return Joi.object({
       order_id: Joi.string().allow("").required(),
       device_id: Joi.string().allow("").allow(null),
@@ -2160,36 +2218,34 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {ResendOrCancelPaymentDetails} */
-  static ResendOrCancelPaymentDetails() {
+  /** @returns {ResendOrCancelPaymentResponse} */
+  static ResendOrCancelPaymentResponse() {
     return Joi.object({
       data: PaymentPlatformModel.LinkStatus().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {PaymentStatusBulkHandlerCreation} */
-  static PaymentStatusBulkHandlerCreation() {
+  /** @returns {PaymentStatusBulkHandlerRequest} */
+  static PaymentStatusBulkHandlerRequest() {
     return Joi.object({
       merchant_order_id: Joi.array().items(Joi.string().allow("")).required(),
     });
   }
 
-  /** @returns {PaymentObjectList} */
-  static PaymentObjectList() {
+  /** @returns {PaymentObjectListSerializer} */
+  static PaymentObjectListSerializer() {
     return Joi.object({
-      user_object: Joi.object().pattern(/\S/, Joi.any()).required(),
+      user_object: Joi.any().required(),
       modified_on: Joi.string().allow("").required(),
       collected_by: Joi.string().allow("").required(),
       created_on: Joi.string().allow("").required(),
-      refund_object: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
+      refund_object: Joi.any().allow(null),
       id: Joi.string().allow("").required(),
       payment_id: Joi.string().allow("").allow(null),
       currency: Joi.string().allow("").required(),
       current_status: Joi.string().allow("").required(),
-      aggregator_payment_object: Joi.object()
-        .pattern(/\S/, Joi.any())
-        .allow(null, ""),
+      aggregator_payment_object: Joi.any().allow(null),
       payment_mode: Joi.string().allow("").required(),
       refunded_by: Joi.string().allow("").required(),
       amount_in_paisa: Joi.string().allow("").required(),
@@ -2206,13 +2262,13 @@ class PaymentPlatformModel {
     return Joi.object({
       merchant_order_id: Joi.string().allow("").required(),
       payment_object_list: Joi.array().items(
-        PaymentPlatformModel.PaymentObjectList()
+        PaymentPlatformModel.PaymentObjectListSerializer()
       ),
     });
   }
 
-  /** @returns {PaymentStatusBulkHandlerDetails} */
-  static PaymentStatusBulkHandlerDetails() {
+  /** @returns {PaymentStatusBulkHandlerResponse} */
+  static PaymentStatusBulkHandlerResponse() {
     return Joi.object({
       count: Joi.number(),
       data: Joi.array().items(PaymentPlatformModel.PaymentStatusObject()),
@@ -2222,8 +2278,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {GetOauthUrlDetails} */
-  static GetOauthUrlDetails() {
+  /** @returns {GetOauthUrlResponse} */
+  static GetOauthUrlResponse() {
     return Joi.object({
       url: Joi.string().allow("").required(),
       success: Joi.boolean().required(),
@@ -2258,7 +2314,7 @@ class PaymentPlatformModel {
   static RepaymentDetailsSerialiserPayAll() {
     return Joi.object({
       total_amount: Joi.number().required(),
-      extension_order_id: Joi.string().allow("").required(),
+      extension_order_id: Joi.string().allow("").allow(null).required(),
       aggregator_transaction_id: Joi.string().allow("").required(),
       aggregator_order_id: Joi.string().allow("").required(),
       shipment_details: Joi.array().items(
@@ -2267,16 +2323,16 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {RepaymentDetails} */
-  static RepaymentDetails() {
+  /** @returns {RepaymentResponse} */
+  static RepaymentResponse() {
     return Joi.object({
-      data: Joi.object().pattern(/\S/, Joi.any()).required(),
+      data: Joi.any().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {MerchantOnBoardingCreation} */
-  static MerchantOnBoardingCreation() {
+  /** @returns {MerchantOnBoardingRequest} */
+  static MerchantOnBoardingRequest() {
     return Joi.object({
       credit_line_id: Joi.string().allow("").required(),
       aggregator: Joi.string().allow("").required(),
@@ -2286,39 +2342,39 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {MerchantOnBoardingDetails} */
-  static MerchantOnBoardingDetails() {
+  /** @returns {MerchantOnBoardingResponse} */
+  static MerchantOnBoardingResponse() {
     return Joi.object({
-      data: Joi.object().pattern(/\S/, Joi.any()).required(),
+      data: Joi.any().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {ValidateCustomerCreation} */
-  static ValidateCustomerCreation() {
+  /** @returns {ValidateCustomerRequest} */
+  static ValidateCustomerRequest() {
     return Joi.object({
       phone_number: Joi.string().allow("").required(),
       aggregator: Joi.string().allow("").required(),
       payload: Joi.string().allow("").allow(null),
-      delivery_address: Joi.object().pattern(/\S/, Joi.any()),
+      delivery_address: Joi.any(),
       transaction_amount_in_paise: Joi.number().required(),
       order_items: Joi.array().items(Joi.any()),
-      merchant_params: Joi.object().pattern(/\S/, Joi.any()),
-      billing_address: Joi.object().pattern(/\S/, Joi.any()),
+      merchant_params: Joi.any(),
+      billing_address: Joi.any(),
     });
   }
 
-  /** @returns {ValidateCustomerDetails} */
-  static ValidateCustomerDetails() {
+  /** @returns {ValidateCustomerResponse} */
+  static ValidateCustomerResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
-      data: Joi.object().pattern(/\S/, Joi.any()),
+      data: Joi.any(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {GetPaymentLinkDetails} */
-  static GetPaymentLinkDetails() {
+  /** @returns {GetPaymentLinkResponse} */
+  static GetPaymentLinkResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
       status_code: Joi.number().required(),
@@ -2346,8 +2402,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {ErrorDetails} */
-  static ErrorDetails() {
+  /** @returns {ErrorResponse} */
+  static ErrorResponse() {
     return Joi.object({
       status_code: Joi.number().required(),
       error: PaymentPlatformModel.ErrorDescription(),
@@ -2366,8 +2422,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {CreatePaymentLinkCreation} */
-  static CreatePaymentLinkCreation() {
+  /** @returns {CreatePaymentLinkRequest} */
+  static CreatePaymentLinkRequest() {
     return Joi.object({
       email: Joi.string().allow("").required(),
       amount: Joi.number().required(),
@@ -2376,13 +2432,11 @@ class PaymentPlatformModel {
       description: Joi.string().allow("").allow(null),
       meta: PaymentPlatformModel.CreatePaymentLinkMeta().required(),
       external_order_id: Joi.string().allow("").required(),
-      success_redirection_url: Joi.string().allow(""),
-      failure_redirection_url: Joi.string().allow(""),
     });
   }
 
-  /** @returns {CreatePaymentLinkDetails} */
-  static CreatePaymentLinkDetails() {
+  /** @returns {CreatePaymentLinkResponse} */
+  static CreatePaymentLinkResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
       status_code: Joi.number().required(),
@@ -2393,8 +2447,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PollingPaymentLinkDetails} */
-  static PollingPaymentLinkDetails() {
+  /** @returns {PollingPaymentLinkResponse} */
+  static PollingPaymentLinkResponse() {
     return Joi.object({
       message: Joi.string().allow("").allow(null),
       http_status: Joi.number().allow(null),
@@ -2409,15 +2463,15 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {CancelOrResendPaymentLinkCreation} */
-  static CancelOrResendPaymentLinkCreation() {
+  /** @returns {CancelOrResendPaymentLinkRequest} */
+  static CancelOrResendPaymentLinkRequest() {
     return Joi.object({
       payment_link_id: Joi.string().allow("").required(),
     });
   }
 
-  /** @returns {ResendPaymentLinkDetails} */
-  static ResendPaymentLinkDetails() {
+  /** @returns {ResendPaymentLinkResponse} */
+  static ResendPaymentLinkResponse() {
     return Joi.object({
       status_code: Joi.number().required(),
       message: Joi.string().allow("").required(),
@@ -2426,8 +2480,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {CancelPaymentLinkDetails} */
-  static CancelPaymentLinkDetails() {
+  /** @returns {CancelPaymentLinkResponse} */
+  static CancelPaymentLinkResponse() {
     return Joi.object({
       status_code: Joi.number().required(),
       message: Joi.string().allow("").required(),
@@ -2461,16 +2515,16 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {GetPaymentCodeDetails} */
-  static GetPaymentCodeDetails() {
+  /** @returns {GetPaymentCodeResponse} */
+  static GetPaymentCodeResponse() {
     return Joi.object({
       data: PaymentPlatformModel.GetPaymentCode().required(),
       success: Joi.boolean().required(),
     });
   }
 
-  /** @returns {PlatformPaymentModeDetails} */
-  static PlatformPaymentModeDetails() {
+  /** @returns {PlatformPaymentModeResponse} */
+  static PlatformPaymentModeResponse() {
     return Joi.object({
       message: Joi.string().allow("").allow(null),
       items: Joi.array().items(Joi.any()).allow(null, ""),
@@ -2478,11 +2532,11 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {MerchnatPaymentModeCreation} */
-  static MerchnatPaymentModeCreation() {
+  /** @returns {MerchnatPaymentModeRequest} */
+  static MerchnatPaymentModeRequest() {
     return Joi.object({
-      offline: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
-      online: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
+      offline: Joi.any().allow(null),
+      online: Joi.any().allow(null),
     });
   }
 
@@ -2493,9 +2547,7 @@ class PaymentPlatformModel {
       amount: Joi.number().required(),
       status: Joi.string().allow("").required(),
       currency: Joi.string().allow("").required(),
-      aggregator_order_details: Joi.object()
-        .pattern(/\S/, Joi.any())
-        .required(),
+      aggregator_order_details: Joi.any().required(),
       aggregator: Joi.string().allow("").required(),
     });
   }
@@ -2503,14 +2555,14 @@ class PaymentPlatformModel {
   /** @returns {AddressDetail} */
   static AddressDetail() {
     return Joi.object({
-      google_map_point: Joi.object().pattern(/\S/, Joi.any()),
+      google_map_point: Joi.any(),
       landmark: Joi.string().allow(""),
       phone: Joi.string().allow("").required(),
       country_iso_code: Joi.string().allow("").required(),
       area_code: Joi.string().allow("").required(),
       country: Joi.string().allow("").required(),
       expire_at: Joi.string().allow(""),
-      geo_location: Joi.object().pattern(/\S/, Joi.any()),
+      geo_location: Joi.any(),
       state: Joi.string().allow("").required(),
       area: Joi.string().allow("").required(),
       g_address_id: Joi.string().allow("").required(),
@@ -2548,15 +2600,15 @@ class PaymentPlatformModel {
       kind: Joi.string().allow(""),
       billing_address: PaymentPlatformModel.AddressDetail(),
       captured: Joi.boolean(),
-      meta: Joi.object().pattern(/\S/, Joi.any()),
+      meta: Joi.any(),
       status: Joi.string().allow("").required(),
     });
   }
 
-  /** @returns {PaymentSessionCreation} */
-  static PaymentSessionCreation() {
+  /** @returns {PaymentSessionRequestSerializer} */
+  static PaymentSessionRequestSerializer() {
     return Joi.object({
-      meta: Joi.object().pattern(/\S/, Joi.any()),
+      meta: Joi.any(),
       gid: Joi.string().allow("").required(),
       order_details: PaymentPlatformModel.OrderDetail().required(),
       status: Joi.string().allow("").required(),
@@ -2566,11 +2618,12 @@ class PaymentPlatformModel {
         .required(),
       total_amount: Joi.number().required(),
       checksum: Joi.string().allow("").required(),
+      source: Joi.string().allow(""),
     });
   }
 
-  /** @returns {PaymentSessionPutDetails} */
-  static PaymentSessionPutDetails() {
+  /** @returns {PaymentSessionResponseSerializer} */
+  static PaymentSessionResponseSerializer() {
     return Joi.object({
       gid: Joi.string().allow("").required(),
       platform_transaction_details: Joi.array().items(Joi.any()).required(),
@@ -2599,10 +2652,10 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {RefundSessionCreation} */
-  static RefundSessionCreation() {
+  /** @returns {RefundSessionRequestSerializer} */
+  static RefundSessionRequestSerializer() {
     return Joi.object({
-      meta: Joi.object().pattern(/\S/, Joi.any()),
+      meta: Joi.any(),
       gid: Joi.string().allow("").required(),
       status: Joi.string().allow("").required(),
       currency: Joi.string().allow("").required(),
@@ -2617,8 +2670,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {RefundSessionDetails} */
-  static RefundSessionDetails() {
+  /** @returns {RefundSessionResponseSerializer} */
+  static RefundSessionResponseSerializer() {
     return Joi.object({
       gid: Joi.string().allow("").required(),
       status: Joi.string().allow("").required(),
@@ -2628,8 +2681,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentDetails} */
-  static PaymentDetails() {
+  /** @returns {PaymentDetailsSerializer} */
+  static PaymentDetailsSerializer() {
     return Joi.object({
       payment_methods: Joi.array().items(Joi.any()).required(),
       gid: Joi.string().allow("").required(),
@@ -2637,7 +2690,7 @@ class PaymentPlatformModel {
       currency: Joi.string().allow("").required(),
       mode: Joi.string().allow("").required(),
       merchant_locale: Joi.string().allow(""),
-      meta: Joi.object().pattern(/\S/, Joi.any()).allow(null, ""),
+      meta: Joi.any().allow(null),
       kind: Joi.string().allow(""),
       success_url: Joi.string().allow(""),
       status: Joi.string().allow("").required(),
@@ -2654,10 +2707,10 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {CartDetails} */
-  static CartDetails() {
+  /** @returns {CartDetailsSerializer} */
+  static CartDetailsSerializer() {
     return Joi.object({
-      items: Joi.object().pattern(/\S/, Joi.any()).required(),
+      items: Joi.any().required(),
       articles: Joi.array().items(Joi.any()).required(),
       cart_value: Joi.number().required(),
       total_quantity: Joi.number(),
@@ -2665,8 +2718,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {RefundDetails} */
-  static RefundDetails() {
+  /** @returns {RefundDetailsSerializer} */
+  static RefundDetailsSerializer() {
     return Joi.object({
       amount: Joi.number().required(),
       currency: Joi.string().allow("").required(),
@@ -2677,17 +2730,17 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentSessionFetchDetails} */
-  static PaymentSessionFetchDetails() {
+  /** @returns {PaymentSessionSerializer} */
+  static PaymentSessionSerializer() {
     return Joi.object({
       payment_details: Joi.any().required(),
       currency: Joi.string().allow("").allow(null),
       status: Joi.string().allow("").required(),
       total_amount: Joi.number().required(),
-      gid: Joi.string().allow("").required(),
-      cart_details: PaymentPlatformModel.CartDetails(),
+      gid: Joi.string().allow("").allow(null).required(),
+      cart_details: PaymentPlatformModel.CartDetailsSerializer(),
       refund_details: Joi.array()
-        .items(PaymentPlatformModel.RefundDetails())
+        .items(PaymentPlatformModel.RefundDetailsSerializer())
         .required(),
     });
   }
@@ -2701,8 +2754,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {RefundPriorityDetails} */
-  static RefundPriorityDetails() {
+  /** @returns {RefundPriorityResponseSerializer} */
+  static RefundPriorityResponseSerializer() {
     return Joi.object({
       configuration: Joi.string().allow("").required(),
       success: Joi.boolean().required(),
@@ -2714,8 +2767,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {RefundPriorityCreation} */
-  static RefundPriorityCreation() {
+  /** @returns {RefundPriorityRequestSerializer} */
+  static RefundPriorityRequestSerializer() {
     return Joi.object({
       apportion: Joi.boolean().required(),
       refund_sources_priority: Joi.array()
@@ -2724,12 +2777,12 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {MerchantPaymentModeCreation} */
-  static MerchantPaymentModeCreation() {
+  /** @returns {MerchantPaymentModeRequest} */
+  static MerchantPaymentModeRequest() {
     return Joi.object({
       business_unit: Joi.string().allow("").required(),
       items: Joi.array().items(Joi.any()).required(),
-      device: Joi.object().pattern(/\S/, Joi.any()).required(),
+      device: Joi.any().required(),
     });
   }
 
@@ -2749,8 +2802,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PlatformPaymentModeCopyConfigCreation} */
-  static PlatformPaymentModeCopyConfigCreation() {
+  /** @returns {PlatformPaymentModeCopyConfigRequest} */
+  static PlatformPaymentModeCopyConfigRequest() {
     return Joi.object({
       from_config: PaymentPlatformModel.FromConfig().required(),
       to_config: PaymentPlatformModel.ToConfig().required(),
@@ -2777,8 +2830,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentOrderCreation} */
-  static PaymentOrderCreation() {
+  /** @returns {PaymentOrderRequest} */
+  static PaymentOrderRequest() {
     return Joi.object({
       order_id: Joi.string().allow("").required(),
       payment_methods: Joi.array().items(
@@ -2804,8 +2857,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PaymentOrderDetails} */
-  static PaymentOrderDetails() {
+  /** @returns {PaymentOrderResponse} */
+  static PaymentOrderResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
       success: Joi.boolean().required(),
@@ -2826,8 +2879,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {AggregatorVersionDetails} */
-  static AggregatorVersionDetails() {
+  /** @returns {AggregatorVersionResponse} */
+  static AggregatorVersionResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
       success: Joi.boolean().required(),
@@ -2844,8 +2897,8 @@ class PaymentPlatformModel {
     });
   }
 
-  /** @returns {PatchAggregatorControl} */
-  static PatchAggregatorControl() {
+  /** @returns {AggregatorControlRequest} */
+  static AggregatorControlRequest() {
     return Joi.object({
       business_unit: Joi.string().allow(""),
       items: Joi.array().items(Joi.any()),