@mojaloop/api-snippets 13.0.7 → 13.0.10

package/thirdparty/{openapi3 → v1_0/openapi3}/thirdparty-dfsp-api.yaml

@@ -75,15 +75,24 @@ paths:
             schema:
               title: AccountsIDPutResponse
               type: object
-              description: 'The object sent in a `PUT /accounts/{ID}` request.'
+              description: |-
+                Callback and data model information for GET /accounts/{ID}:
+                Callback - PUT /accounts/{ID} Error Callback - PUT /accounts/{ID}/error Data Model - Empty body
+                The PUT /accounts/{ID} response is used to inform the requester of the result of a request for accounts information. The identifier ID given in the call are the values given in the original request.
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31121--put-accountsid
               properties:
                 accountList:
-                  description: Information about the accounts that the DFSP associates with the identifier sent by the PISP
+                  title: AccountList
                   type: array
+                  description: |-
+                    The AccountList data model is used to hold information about the accounts that a party controls.
+                    https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#3213-accountlist
                   items:
                     title: Account
                     type: object
-                    description: Data model for the complex type Account.
+                    description: |-
+                      Data model for the complex type Account.
+                      https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#3211-account
                     properties:
                       accountNickname:
                         title: Name
@@ -96,182 +105,17 @@ paths:
 
                           **Note:** In some programming languages, Unicode support must be specifically enabled. For example, if Java is used, the flag UNICODE_CHARACTER_CLASS must be enabled to allow Unicode characters.
                       address:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items/address'
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items/properties/address'
                       currency:
-                        title: Currency
-                        description: 'The currency codes defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) as three-letter alphabetic codes are used as the standard naming representation for currencies.'
-                        type: string
-                        minLength: 3
-                        maxLength: 3
-                        enum:
-                          - AED
-                          - AFN
-                          - ALL
-                          - AMD
-                          - ANG
-                          - AOA
-                          - ARS
-                          - AUD
-                          - AWG
-                          - AZN
-                          - BAM
-                          - BBD
-                          - BDT
-                          - BGN
-                          - BHD
-                          - BIF
-                          - BMD
-                          - BND
-                          - BOB
-                          - BRL
-                          - BSD
-                          - BTN
-                          - BWP
-                          - BYN
-                          - BZD
-                          - CAD
-                          - CDF
-                          - CHF
-                          - CLP
-                          - CNY
-                          - COP
-                          - CRC
-                          - CUC
-                          - CUP
-                          - CVE
-                          - CZK
-                          - DJF
-                          - DKK
-                          - DOP
-                          - DZD
-                          - EGP
-                          - ERN
-                          - ETB
-                          - EUR
-                          - FJD
-                          - FKP
-                          - GBP
-                          - GEL
-                          - GGP
-                          - GHS
-                          - GIP
-                          - GMD
-                          - GNF
-                          - GTQ
-                          - GYD
-                          - HKD
-                          - HNL
-                          - HRK
-                          - HTG
-                          - HUF
-                          - IDR
-                          - ILS
-                          - IMP
-                          - INR
-                          - IQD
-                          - IRR
-                          - ISK
-                          - JEP
-                          - JMD
-                          - JOD
-                          - JPY
-                          - KES
-                          - KGS
-                          - KHR
-                          - KMF
-                          - KPW
-                          - KRW
-                          - KWD
-                          - KYD
-                          - KZT
-                          - LAK
-                          - LBP
-                          - LKR
-                          - LRD
-                          - LSL
-                          - LYD
-                          - MAD
-                          - MDL
-                          - MGA
-                          - MKD
-                          - MMK
-                          - MNT
-                          - MOP
-                          - MRO
-                          - MUR
-                          - MVR
-                          - MWK
-                          - MXN
-                          - MYR
-                          - MZN
-                          - NAD
-                          - NGN
-                          - NIO
-                          - NOK
-                          - NPR
-                          - NZD
-                          - OMR
-                          - PAB
-                          - PEN
-                          - PGK
-                          - PHP
-                          - PKR
-                          - PLN
-                          - PYG
-                          - QAR
-                          - RON
-                          - RSD
-                          - RUB
-                          - RWF
-                          - SAR
-                          - SBD
-                          - SCR
-                          - SDG
-                          - SEK
-                          - SGD
-                          - SHP
-                          - SLL
-                          - SOS
-                          - SPL
-                          - SRD
-                          - STD
-                          - SVC
-                          - SYP
-                          - SZL
-                          - THB
-                          - TJS
-                          - TMT
-                          - TND
-                          - TOP
-                          - TRY
-                          - TTD
-                          - TVD
-                          - TWD
-                          - TZS
-                          - UAH
-                          - UGX
-                          - USD
-                          - UYU
-                          - UZS
-                          - VEF
-                          - VND
-                          - VUV
-                          - WST
-                          - XAF
-                          - XCD
-                          - XDR
-                          - XOF
-                          - XPF
-                          - XTS
-                          - XXX
-                          - YER
-                          - ZAR
-                          - ZMW
-                          - ZWD
+                        $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/amount/allOf/0/properties/currency'
                     required:
                       - accountNickname
-                      - id
+                      - address
                       - currency
+                  minItems: 1
+                  maxItems: 256
+                extensionList:
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - accounts
             example:
@@ -350,7 +194,7 @@ paths:
                       maxLength: 128
                       description: Error description string.
                     extensionList:
-                      $ref: '#/paths/~1thirdpartyRequests~1authorizations/post/requestBody/content/application~1json/schema/extensionList'
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - errorCode
                     - errorDescription
@@ -406,7 +250,12 @@ paths:
             schema:
               title: ConsentRequestsPostRequest
               type: object
-              description: The object sent in a `POST /consentRequests` request.
+              description: |-
+                Used by: PISP
+                The HTTP request POST /consentRequests is used to request a DFSP to grant access to one or more accounts owned by a customer of the DFSP for the PISP who sends the request.
+                Callback and data model for POST /consentRequests:
+                Callback: PUT /consentRequests/{ID} Error callback: PUT /consentRequests/{ID}/error Data model - see below url
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31212-post-consentrequests
               properties:
                 consentRequestId:
                   title: CorrelationId
@@ -426,13 +275,20 @@ paths:
                   items:
                     title: Scope
                     type: object
-                    description: Scope + Account Identifier mapping for a Consent.
+                    description: |-
+                      The Scope element contains an identifier defining, in the terms of a DFSP, an account on which access types can be requested or granted. It also defines the access types which are requested or granted.
+                      https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#32121-scope
                     properties:
                       address:
                         title: AccountAddress
                         type: string
-                        description: |
-                          An address which can be used to identify the account.
+                        description: |-
+                          The AccountAddress data type is a variable length string with a maximum size of 1023 characters and consists of:
+                          Alphanumeric characters, upper or lower case. (Addresses are case-sensitive so that they can contain data encoded in formats such as base64url.)
+                          - Underscore (_) - Tilde (~) - Hyphen (-) - Period (.) Addresses MUST NOT end in a period (.) character
+                          An entity providing accounts to parties (i.e. a participant) can provide any value for an AccountAddress that is meaningful to that entity. It does not need to provide an address that makes the account identifiable outside the entity's domain.
+                          IMPORTANT: The policy for defining addresses and the life-cycle of these is at the discretion of the address space owner (the payer DFSP in this case).
+                          https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#3212-accountaddress
                         pattern: '^([0-9A-Za-z_~\-\.]+[0-9A-Za-z_~\-])$'
                         minLength: 1
                         maxLength: 1023
@@ -443,16 +299,18 @@ paths:
                         items:
                           title: ScopeAction
                           type: string
+                          description: |
+                            The ScopeAction element contains an access type which a PISP can request
+                            from a DFSP, or which a DFSP can grant to a PISP.
+                            It must be a member of the appropriate enumeration.
+
+                            - ACCOUNTS_GET_BALANCE: PISP can request a balance for the linked account
+                            - ACCOUNTS_TRANSFER: PISP can request a transfer of funds from the linked account in the DFSP
+                            - ACCOUNTS_STATEMENT: PISP can request a statement of individual transactions on a user's account
                           enum:
                             - ACCOUNTS_GET_BALANCE
                             - ACCOUNTS_TRANSFER
                             - ACCOUNTS_STATEMENT
-                          description: |
-                            The permissions allowed on a given account by a DFSP as defined in
-                            a consent object
-                            - ACCOUNTS_GET_BALANCE: PISP can request a balance for the linked account
-                            - ACCOUNTS_TRANSFER: PISP can request a transfer of funds from the linked account in the DFSP
-                            - ACCOUNTS_STATEMENT: PISP can request a statement of individual transactions on a user’s account
                     required:
                       - address
                       - actions
@@ -467,9 +325,9 @@ paths:
                       - WEB
                       - OTP
                     description: |
-                      The auth channel being used for the consentRequest.
-                      - "WEB" - The Web auth channel.
-                      - "OTP" - The OTP auth channel.
+                      The auth channel being used for the consent request.
+                      - WEB - DFSP can support authorization via a web-based login.
+                      - OTP - DFSP can support authorization via a One Time PIN.
                 callbackUri:
                   title: Uri
                   type: string
@@ -478,6 +336,38 @@ paths:
                   maxLength: 512
                   description: |
                     The API data type Uri is a JSON string in a canonical format that is restricted by a regular expression for interoperability reasons.
+                extensionList:
+                  title: ExtensionList
+                  type: object
+                  description: 'Data model for the complex type ExtensionList. An optional list of extensions, specific to deployment.'
+                  properties:
+                    extension:
+                      type: array
+                      items:
+                        title: Extension
+                        type: object
+                        description: Data model for the complex type Extension.
+                        properties:
+                          key:
+                            title: ExtensionKey
+                            type: string
+                            minLength: 1
+                            maxLength: 32
+                            description: Extension key.
+                          value:
+                            title: ExtensionValue
+                            type: string
+                            minLength: 1
+                            maxLength: 128
+                            description: Extension value.
+                        required:
+                          - key
+                          - value
+                      minItems: 1
+                      maxItems: 16
+                      description: Number of Extension elements.
+                  required:
+                    - extension
               required:
                 - consentRequestId
                 - userId
@@ -585,7 +475,7 @@ paths:
                       minLength: 1
                       maxLength: 256
                       items:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items'
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items'
                     authChannels:
                       type: array
                       minLength: 1
@@ -596,11 +486,13 @@ paths:
                         enum:
                           - WEB
                         description: |
-                          The web auth channel being used for PUT consentRequest/{ID} request.
+                          The web auth channel being used for `PUT /consentRequest/{ID}` request.
                     callbackUri:
-                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/callbackUri'
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/callbackUri'
                     authUri:
-                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/callbackUri'
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/callbackUri'
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - scopes
                     - authChannels
@@ -619,7 +511,7 @@ paths:
                       minLength: 1
                       maxLength: 256
                       items:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items'
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items'
                     authChannels:
                       type: array
                       minLength: 1
@@ -630,9 +522,11 @@ paths:
                         enum:
                           - OTP
                         description: |
-                          The OTP auth channel being used for PUT consentRequest/{ID} request.
+                          The OTP auth channel being used for `PUT /consentRequests/{ID}` request.
                     callbackUri:
-                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/callbackUri'
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/callbackUri'
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - scopes
                     - authChannels
@@ -674,12 +568,17 @@ paths:
             schema:
               title: ConsentRequestsIDPatchRequest
               type: object
-              description: 'The object sent in a `PATCH /consentRequests/{ID}` request.'
+              description: |-
+                Used by: PISP
+                After the user completes an out-of-band authorization with the DFSP, the PISP will receive a token which they can use to prove to the DFSP that the user trusts this PISP.
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31222-patch-consentrequestsid
               properties:
                 authToken:
                   type: string
                   pattern: '^[A-Za-z0-9-_]+[=]{0,2}$'
                   description: 'The API data type BinaryString is a JSON String. The string is a base64url  encoding of a string of raw bytes, where padding (character ‘=’) is added at the end of the data if needed to ensure that the string is a multiple of 4 characters. The length restriction indicates the allowed number of characters.'
+                extensionList:
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - authToken
       responses:
@@ -845,19 +744,21 @@ paths:
                   properties:
                     consentId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                       description: |
                         Common ID between the PISP and FSP for the Consent object
                         determined by the DFSP who creates the Consent.
+                    consentRequestId:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                     scopes:
                       minLength: 1
                       maxLength: 256
                       type: array
                       items:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items'
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items'
                     credential:
                       allOf:
-                        - $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/credential'
+                        - $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/properties/credential'
                     status:
                       title: ConsentStatus
                       type: string
@@ -868,6 +769,8 @@ paths:
                         Allowed values for the enumeration ConsentStatus
                         - ISSUED - The consent has been issued by the DFSP
                         - REVOKED - The consent has been revoked
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - consentId
                     - scopes
@@ -881,14 +784,14 @@ paths:
                   properties:
                     consentId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                       description: |
                         Common ID between the PISP and the Payer DFSP for the consent object. The ID
-                        should be reused for resends of the same consent. A new ID should be generated
+                        should be reused for re-sends of the same consent. A new ID should be generated
                         for each new consent.
                     consentRequestId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                       description: |
                         The ID given to the original consent request on which this consent is based.
                     scopes:
@@ -896,9 +799,11 @@ paths:
                       minLength: 1
                       maxLength: 256
                       items:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items'
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items'
                     status:
-                      $ref: '#/paths/~1consents/post/requestBody/content/application~1json/schema/oneOf/0/status'
+                      $ref: '#/paths/~1consents/post/requestBody/content/application~1json/schema/oneOf/0/properties/status'
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - consentId
                     - consentRequestId
@@ -917,7 +822,7 @@ paths:
                 description: Data model for the complex type object that contains an optional element ErrorInformation used along with 4xx and 5xx responses.
                 properties:
                   errorInformation:
-                    $ref: '#/paths/~1accounts~1%7BID%7D~1error/put/requestBody/content/application~1json/schema/errorInformation'
+                    $ref: '#/paths/~1accounts~1%7BID%7D~1error/put/requestBody/content/application~1json/schema/properties/errorInformation'
           headers:
             Content-Length:
               required: false
@@ -1023,7 +928,7 @@ paths:
       - $ref: '#/paths/~1consents/parameters/8'
     get:
       description: |
-        The **GET /consents/**_{ID}_ resource allows a party to enquire after the status of a consent. The  *{ID}* used in the URI of the request should be the consent request ID which was used to identify the consent when it was created.
+        The **GET /consents/**_{ID}_ resource allows a party to enquire after the status of a consent. The *{ID}* used in the URI of the request should be the consent request ID which was used to identify the consent when it was created.
       tags:
         - consents
       operationId: GetConsent
@@ -1077,7 +982,7 @@ paths:
                   description: |
                     PATCH /consents/{ID} request object.
 
-                    Sent by the DFSP to the PISP when a consent is verified.
+                    Sent by the DFSP to the PISP when a consent is issued and verified.
                     Used in the "Register Credential" part of the Account linking flow.
                   type: object
                   properties:
@@ -1085,7 +990,7 @@ paths:
                       type: object
                       properties:
                         status:
-                          title: CredentialStatus
+                          title: CredentialStatusVerified
                           type: string
                           enum:
                             - VERIFIED
@@ -1094,6 +999,8 @@ paths:
                             - "VERIFIED" - The Credential is valid and verified.
                       required:
                         - status
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - credential
                 - title: ConsentsIDPatchResponseRevoked
@@ -1105,7 +1012,7 @@ paths:
                   type: object
                   properties:
                     status:
-                      title: ConsentStatus
+                      title: ConsentStatusRevoked
                       type: string
                       enum:
                         - REVOKED
@@ -1113,7 +1020,9 @@ paths:
                         Allowed values for the enumeration ConsentStatus
                         - REVOKED - The consent has been revoked
                     revokedAt:
-                      $ref: '#/paths/~1thirdpartyRequests~1transactions~1%7BID%7D/patch/requestBody/content/application~1json/schema/completedTimestamp'
+                      $ref: '#/paths/~1thirdpartyRequests~1transactions~1%7BID%7D/patch/requestBody/content/application~1json/schema/properties/completedTimestamp'
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - status
                     - revokedAt
@@ -1162,18 +1071,18 @@ paths:
                     The HTTP request `PUT /consents/{ID}` is used by the PISP to update a Consent with a signed challenge and register a credential.
                     Called by a `PISP` to after signing a challenge. Sent to a DFSP for verification.
                   properties:
-                    scopes:
-                      type: array
-                      items:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items'
                     status:
-                      title: ConsentStatus
+                      title: ConsentStatusIssued
                       type: string
                       enum:
                         - ISSUED
                       description: |-
                         Allowed values for the enumeration ConsentStatus
                         - ISSUED - The consent has been issued by the DFSP
+                    scopes:
+                      type: array
+                      items:
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items'
                     credential:
                       title: SignedCredential
                       type: object
@@ -1191,12 +1100,11 @@ paths:
                           enum:
                             - FIDO
                             - GENERIC
-                          description: |
-                            The type of the Credential.
-                            - "FIDO" - A FIDO public/private keypair
-                            - "GENERIC" - A Generic public/private keypair
+                          description: |-
+                            The type of the Credential. - "FIDO" - The credential is based on a FIDO challenge. Its payload is a FIDOPublicKeyCredentialAttestation object. - "GENERIC" - The credential is based on a simple public key validation. Its payload is a GenericCredential object.
+                            https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#3226-credentialtype
                         status:
-                          title: CredentialStatus
+                          title: CredentialStatusPending
                           type: string
                           enum:
                             - PENDING
@@ -1207,61 +1115,21 @@ paths:
                           title: GenericCredential
                           type: object
                           description: |
-                            A publicKey + signature of a challenge for a generic public/private keypair
+                            A publicKey + signature of a challenge for a generic public/private keypair.
                           properties:
                             publicKey:
-                              $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/authToken'
+                              $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/properties/authToken'
                             signature:
-                              $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/authToken'
+                              $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/properties/authToken'
                           required:
                             - publicKey
                             - signature
                           additionalProperties: false
                         fidoPayload:
-                          $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/1/credential/payload'
-                      required:
-                        - credentialType
-                        - status
-                      additionalProperties: false
-                  required:
-                    - scopes
-                    - credential
-                  additionalProperties: false
-                - title: ConsentsIDPutResponseVerified
-                  type: object
-                  description: |
-                    The HTTP request `PUT /consents/{ID}` is used by the DFSP or Auth-Service to update a Consent object once it has been Verified.
-                    Called by a `auth-service` to notify a DFSP that a credential has been verified and registered.
-                  properties:
-                    scopes:
-                      type: array
-                      items:
-                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/scopes/items'
-                    status:
-                      $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/status'
-                    credential:
-                      title: VerifiedCredential
-                      type: object
-                      description: |
-                        A credential used to allow a user to prove their identity and access
-                        to an account with a DFSP.
-
-                        VerifiedCredential is a special formatting of the credential to allow us to be
-                        more explicit about the `status` field - it should only ever be VERIFIED when
-                        updating a credential.
-                      properties:
-                        credentialType:
-                          $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/credential/credentialType'
-                        status:
-                          type: string
-                          enum:
-                            - VERIFIED
-                          description: 'The Credential is valid, and ready to be used by the PISP.'
-                        payload:
                           title: FIDOPublicKeyCredentialAttestation
                           type: object
                           description: |
-                            A data model representing a FIDO Attestation result. Derived from
+                            A data model representing a FIDO Attestation result. Derived from 
                             [`PublicKeyCredential` Interface](https://w3c.github.io/webauthn/#iface-pkcredential).
 
                             The `PublicKeyCredential` interface represents the below fields with
@@ -1315,8 +1183,50 @@ paths:
                       required:
                         - credentialType
                         - status
-                        - payload
                       additionalProperties: false
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
+                  required:
+                    - scopes
+                    - credential
+                  additionalProperties: false
+                - title: ConsentsIDPutResponseVerified
+                  type: object
+                  description: |
+                    The HTTP request `PUT /consents/{ID}` is used by the DFSP or Auth-Service to update a Consent object once it has been Verified.
+                    Called by a `auth-service` to notify a DFSP that a credential has been verified and registered.
+                  properties:
+                    status:
+                      $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/properties/status'
+                    scopes:
+                      type: array
+                      items:
+                        $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/scopes/items'
+                    credential:
+                      title: VerifiedCredential
+                      type: object
+                      description: |
+                        A credential used to allow a user to prove their identity and access
+                        to an account with a DFSP.
+
+                        VerifiedCredential is a special formatting of Credential to allow us to be
+                        more explicit about the `status` field - it should only ever be VERIFIED when
+                        updating a credential.
+                      properties:
+                        credentialType:
+                          $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/properties/credential/properties/credentialType'
+                        status:
+                          $ref: '#/paths/~1consents~1%7BID%7D/patch/requestBody/content/application~1json/schema/oneOf/0/properties/credential/properties/status'
+                        genericPayload:
+                          $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/properties/credential/properties/genericPayload'
+                        fidoPayload:
+                          $ref: '#/paths/~1consents~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/0/properties/credential/properties/fidoPayload'
+                      required:
+                        - credentialType
+                        - status
+                      additionalProperties: false
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - scopes
                     - credential
@@ -1451,35 +1361,40 @@ paths:
           application/json:
             schema:
               title: ThirdpartyRequestsAuthorizationsPostRequest
-              description: POST /thirdpartyRequests/authorizations request object.
+              description: |-
+                Used by: DFSP
+                The HTTP request POST /thirdpartyRequests/authorizations is used to request the validation by a customer for the transfer described in the request.
+                Callback and data model information for POST /thirdpartyRequests/authorizations:
+                Callback - PUT /thirdpartyRequests/authorizations/{ID} Error Callback - PUT /thirdpartyRequests/authorizations/{ID}/error Data Model - See below url
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31612-post-thirdpartyrequestsauthorizations
               type: object
               properties:
                 authorizationRequestId:
-                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                 transactionRequestId:
-                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                 challenge:
                   type: string
                   description: The challenge that the PISP's client is to sign
                 transferAmount:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/amount/allOf/0'
-                  description: The amount that will be debited from the sending customer’s  account as a consequence of the transaction.
+                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/amount/allOf/0'
+                  description: The amount that will be debited from the sending customer's account as a consequence of the transaction.
                 payeeReceiveAmount:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/amount/allOf/0'
-                  description: The amount that will be credited to the receiving customer’s  account as a consequence of the transaction.
+                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/amount/allOf/0'
+                  description: The amount that will be credited to the receiving customer's account as a consequence of the transaction.
                 fees:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/amount/allOf/0'
+                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/amount/allOf/0'
                   description: The amount of fees that the paying customer will be charged as part of the transaction.
                 payer:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/payer/allOf/0'
+                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/payer/allOf/0'
                   description: 'Information about the Payer type, id, sub-type/id, FSP Id in the proposed financial transaction.'
                 payee:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/payee/allOf/0'
+                    - $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/payee/allOf/0'
                   description: Information about the Payee in the proposed financial transaction.
                 transactionType:
                   title: TransactionType
@@ -1541,7 +1456,7 @@ paths:
                       description: Data model for the complex type Refund.
                       properties:
                         originalTransactionId:
-                          $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                          $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                         refundReason:
                           title: RefundReason
                           type: string
@@ -1563,40 +1478,10 @@ paths:
                     - initiatorType
                 expiration:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1transactions~1%7BID%7D/patch/requestBody/content/application~1json/schema/completedTimestamp'
+                    - $ref: '#/paths/~1thirdpartyRequests~1transactions~1%7BID%7D/patch/requestBody/content/application~1json/schema/properties/completedTimestamp'
                   description: 'The time by which the transfer must be completed, set by the payee DFSP.'
                 extensionList:
-                  title: ExtensionList
-                  type: object
-                  description: 'Data model for the complex type ExtensionList. An optional list of extensions, specific to deployment.'
-                  properties:
-                    extension:
-                      type: array
-                      items:
-                        title: Extension
-                        type: object
-                        description: Data model for the complex type Extension.
-                        properties:
-                          key:
-                            title: ExtensionKey
-                            type: string
-                            minLength: 1
-                            maxLength: 32
-                            description: Extension key.
-                          value:
-                            title: ExtensionValue
-                            type: string
-                            minLength: 1
-                            maxLength: 128
-                            description: Extension value.
-                        required:
-                          - key
-                          - value
-                      minItems: 1
-                      maxItems: 16
-                      description: Number of Extension elements.
-                  required:
-                    - extension
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - authorizationRequestId
                 - transactionRequestId
@@ -1690,17 +1575,19 @@ paths:
           application/json:
             schema:
               oneOf:
-                - title: ThirdpartyRequestsAuthorizationsIDPutResponseGeneric
+                - title: ThirdpartyRequestsAuthorizationsIDPutResponseRejected
                   type: object
                   description: 'The object sent in the PUT /thirdpartyRequests/authorizations/{ID} callback.'
                   properties:
                     responseType:
-                      title: AuthorizationResponseType
+                      title: AuthorizationResponseTypeRejected
                       description: |
                         The customer rejected the terms of the transfer.
                       type: string
                       enum:
                         - REJECTED
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - responseType
                 - title: ThirdpartyRequestsAuthorizationsIDPutResponseFIDO
@@ -1715,16 +1602,19 @@ paths:
                       enum:
                         - ACCEPTED
                     signedPayload:
+                      title: SignedPayloadFIDO
                       type: object
                       properties:
                         signedPayloadType:
-                          $ref: '#/paths/~1thirdpartyRequests~1verifications/post/requestBody/content/application~1json/schema/oneOf/0/signedPayloadType'
+                          $ref: '#/paths/~1thirdpartyRequests~1verifications/post/requestBody/content/application~1json/schema/oneOf/0/properties/signedPayloadType'
                         fidoSignedPayload:
-                          $ref: '#/paths/~1thirdpartyRequests~1verifications/post/requestBody/content/application~1json/schema/oneOf/0/fidoSignedPayload'
+                          $ref: '#/paths/~1thirdpartyRequests~1verifications/post/requestBody/content/application~1json/schema/oneOf/0/properties/fidoSignedPayload'
                       required:
                         - signedPayloadType
                         - fidoSignedPayload
                       additionalProperties: false
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - responseType
                     - signedPayload
@@ -1734,18 +1624,21 @@ paths:
                   description: 'The object sent in the PUT /thirdpartyRequests/authorizations/{ID} callback.'
                   properties:
                     responseType:
-                      $ref: '#/paths/~1thirdpartyRequests~1authorizations~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/1/responseType'
+                      $ref: '#/paths/~1thirdpartyRequests~1authorizations~1%7BID%7D/put/requestBody/content/application~1json/schema/oneOf/1/properties/responseType'
                     signedPayload:
+                      title: SignedPayloadGeneric
                       type: object
                       properties:
                         signedPayloadType:
-                          $ref: '#/paths/~1thirdpartyRequests~1verifications/post/requestBody/content/application~1json/schema/oneOf/1/signedPayloadType'
+                          $ref: '#/paths/~1thirdpartyRequests~1verifications/post/requestBody/content/application~1json/schema/oneOf/1/properties/signedPayloadType'
                         genericSignedPayload:
-                          $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/authToken'
+                          $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/properties/authToken'
                       required:
                         - signedPayloadType
                         - genericSignedPayload
                       additionalProperties: false
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - responseType
                     - signedPayload
@@ -1852,13 +1745,18 @@ paths:
             schema:
               title: ThirdpartyRequestsTransactionsPostRequest
               type: object
-              description: The object sent in the POST /thirdpartyRequests/transactions request.
+              description: |-
+                Used by: PISP
+                The HTTP request POST /thirdpartyRequests/transactions is used to request the creation of a transaction request on the server for the transfer described in the request.
+                Callback and data model information for POST /thirdpartyRequests/transactions:
+                Callback - PUT /thirdpartyRequests/transactions/{ID} Error Callback - PUT /thirdpartyRequests/transactions/{ID}/error Data Model - See link below
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31712-post-thirdpartyrequeststransactions
               properties:
                 transactionRequestId:
                   allOf:
-                    - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                    - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                   description: |
-                    Common ID between the PISP and the Payer DFSP for the transaction request object. The ID should be reused for resends of the same transaction request.  A new ID should be generated for each new transaction request.
+                    Common ID between the PISP and the Payer DFSP for the transaction request object. The ID should be reused for resends of the same transaction request. A new ID should be generated for each new transaction request.
                 payee:
                   allOf:
                     - title: Party
@@ -1866,7 +1764,7 @@ paths:
                       description: Data model for the complex type Party.
                       properties:
                         partyIdInfo:
-                          $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/payer/allOf/0'
+                          $ref: '#/paths/~1thirdpartyRequests~1transactions/post/requestBody/content/application~1json/schema/properties/payer/allOf/0'
                         merchantClassificationCode:
                           title: MerchantClassificationCode
                           type: string
@@ -1954,7 +1852,7 @@ paths:
                             [RFC 3696](https://tools.ietf.org/html/rfc3696).
                             - PERSONAL_ID - A personal identifier is used as reference to a participant.
                             Examples of personal identification are passport number, birth certificate
-                            number, and national registration number. The identifier number is added in
+                            number, and national registration number. The identifier number is added in 
                             the PartyIdentifier element. The personal identifier type is added in the
                             PartySubIdOrType element.
                             - BUSINESS - A specific Business (for example, an organization or a company)
@@ -1978,12 +1876,12 @@ paths:
                             PartySubIdOrType element for identifying an account under an Alias defined
                             by the PartyIdentifier.
                             - CONSENT - A Consent represents an agreement between a PISP, a Customer and
-                            a DFSP which allows the PISP permission to perform actions on behalf of the
-                            customer. A Consent has an authoritative source: either the DFSP who issued
+                            a DFSP which allows the PISP permission to perform actions on behalf of the 
+                            customer. A Consent has an authoritative source: either the DFSP who issued 
                             the Consent, or an Auth Service which administers the Consent.
                             - THIRD_PARTY_LINK - A Third Party Link represents an agreement between a PISP,
-                            a DFSP, and a specific Customer's account at the DFSP. The content of the link
-                            is created by the DFSP at the time when it gives permission to the PISP for
+                            a DFSP, and a specific Customer's account at the DFSP. The content of the link 
+                            is created by the DFSP at the time when it gives permission to the PISP for 
                             specific access to a given account.
                           example: PERSONAL_ID
                         partyIdentifier:
@@ -2006,7 +1904,7 @@ paths:
                           maxLength: 32
                           description: FSP identifier.
                         extensionList:
-                          $ref: '#/paths/~1thirdpartyRequests~1authorizations/post/requestBody/content/application~1json/schema/extensionList'
+                          $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                       required:
                         - partyIdType
                         - partyIdentifier
@@ -2031,7 +1929,176 @@ paths:
                       description: Data model for the complex type Money.
                       properties:
                         currency:
-                          $ref: '#/paths/~1accounts~1%7BID%7D/put/requestBody/content/application~1json/schema/accountList/items/currency'
+                          title: Currency
+                          description: 'The currency codes defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) as three-letter alphabetic codes are used as the standard naming representation for currencies.'
+                          type: string
+                          minLength: 3
+                          maxLength: 3
+                          enum:
+                            - AED
+                            - AFN
+                            - ALL
+                            - AMD
+                            - ANG
+                            - AOA
+                            - ARS
+                            - AUD
+                            - AWG
+                            - AZN
+                            - BAM
+                            - BBD
+                            - BDT
+                            - BGN
+                            - BHD
+                            - BIF
+                            - BMD
+                            - BND
+                            - BOB
+                            - BRL
+                            - BSD
+                            - BTN
+                            - BWP
+                            - BYN
+                            - BZD
+                            - CAD
+                            - CDF
+                            - CHF
+                            - CLP
+                            - CNY
+                            - COP
+                            - CRC
+                            - CUC
+                            - CUP
+                            - CVE
+                            - CZK
+                            - DJF
+                            - DKK
+                            - DOP
+                            - DZD
+                            - EGP
+                            - ERN
+                            - ETB
+                            - EUR
+                            - FJD
+                            - FKP
+                            - GBP
+                            - GEL
+                            - GGP
+                            - GHS
+                            - GIP
+                            - GMD
+                            - GNF
+                            - GTQ
+                            - GYD
+                            - HKD
+                            - HNL
+                            - HRK
+                            - HTG
+                            - HUF
+                            - IDR
+                            - ILS
+                            - IMP
+                            - INR
+                            - IQD
+                            - IRR
+                            - ISK
+                            - JEP
+                            - JMD
+                            - JOD
+                            - JPY
+                            - KES
+                            - KGS
+                            - KHR
+                            - KMF
+                            - KPW
+                            - KRW
+                            - KWD
+                            - KYD
+                            - KZT
+                            - LAK
+                            - LBP
+                            - LKR
+                            - LRD
+                            - LSL
+                            - LYD
+                            - MAD
+                            - MDL
+                            - MGA
+                            - MKD
+                            - MMK
+                            - MNT
+                            - MOP
+                            - MRO
+                            - MUR
+                            - MVR
+                            - MWK
+                            - MXN
+                            - MYR
+                            - MZN
+                            - NAD
+                            - NGN
+                            - NIO
+                            - NOK
+                            - NPR
+                            - NZD
+                            - OMR
+                            - PAB
+                            - PEN
+                            - PGK
+                            - PHP
+                            - PKR
+                            - PLN
+                            - PYG
+                            - QAR
+                            - RON
+                            - RSD
+                            - RUB
+                            - RWF
+                            - SAR
+                            - SBD
+                            - SCR
+                            - SDG
+                            - SEK
+                            - SGD
+                            - SHP
+                            - SLL
+                            - SOS
+                            - SPL
+                            - SRD
+                            - STD
+                            - SVC
+                            - SYP
+                            - SZL
+                            - THB
+                            - TJS
+                            - TMT
+                            - TND
+                            - TOP
+                            - TRY
+                            - TTD
+                            - TVD
+                            - TWD
+                            - TZS
+                            - UAH
+                            - UGX
+                            - USD
+                            - UYU
+                            - UZS
+                            - VEF
+                            - VND
+                            - VUV
+                            - WST
+                            - XAF
+                            - XCD
+                            - XDR
+                            - XOF
+                            - XPF
+                            - XTS
+                            - XXX
+                            - YER
+                            - ZAR
+                            - ZMW
+                            - ZWD
                         amount:
                           title: Amount
                           type: string
@@ -2044,7 +2111,7 @@ paths:
                   description: Requested amount to be transferred from the Payer to Payee.
                 transactionType:
                   allOf:
-                    - $ref: '#/paths/~1thirdpartyRequests~1authorizations/post/requestBody/content/application~1json/schema/transactionType'
+                    - $ref: '#/paths/~1thirdpartyRequests~1authorizations/post/requestBody/content/application~1json/schema/properties/transactionType'
                   description: Type of transaction.
                 note:
                   type: string
@@ -2056,6 +2123,8 @@ paths:
                   description: |
                     Date and time until when the transaction request is valid. It can be set to get a quick failure in case the peer FSP takes too long to respond.
                   example: '2016-05-24T08:38:08.699-04:00'
+                extensionList:
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - transactionRequestId
                 - payee
@@ -2145,7 +2214,10 @@ paths:
             schema:
               title: ThirdpartyRequestsTransactionsIDPutResponse
               type: object
-              description: 'The object sent in the PUT /thirdPartyRequests/transactions/{ID} request.'
+              description: |-
+                Used by: DFSP
+                After a PISP requests the creation of a Third Party Transaction request (POST /thirdpartyRequests/transactions) or the status of a previously created Third Party Transaction request (GET /thirdpartyRequests/transactions/{ID}), the DFSP will send this callback.
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31721-put-thirdpartyrequeststransactionsid
               properties:
                 transactionRequestState:
                   title: TransactionRequestState
@@ -2162,6 +2234,8 @@ paths:
                     - ACCEPTED - Payer has approved the transaction.
                     - REJECTED - Payer has rejected the transaction.
                   example: RECEIVED
+                extensionList:
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - transactionRequestState
             example:
@@ -2205,7 +2279,12 @@ paths:
             schema:
               title: ThirdpartyRequestsTransactionsIDPatchResponse
               type: object
-              description: 'The object sent in the PATCH /thirdpartyRequests/transactions/{ID} callback.'
+              description: |-
+                Used by: DFSP
+                The issuing PISP will expect a response to their request for a transfer which describes the finalized state of the requested transfer.
+                This response will be given by a PATCH call on the /thirdpartyRequests/transactions/{ID} resource.
+                The {ID} given in the query string should be the transactionRequestId which was originally used by the PISP to identify the transaction request.
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31612-post-thirdpartyrequestsauthorizations
               properties:
                 completedTimestamp:
                   title: DateTime
@@ -2214,7 +2293,7 @@ paths:
                   description: 'The API data type DateTime is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons. The format is according to [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html), expressed in a combined date, time and time zone format. A more readable version of the format is yyyy-MM-ddTHH:mm:ss.SSS[-HH:MM]. Examples are "2016-05-24T08:38:08.699-04:00", "2016-05-24T08:38:08.699Z" (where Z indicates Zulu time zone, same as UTC).'
                   example: '2016-05-24T08:38:08.699-04:00'
                 transactionRequestState:
-                  $ref: '#/paths/~1thirdpartyRequests~1transactions~1%7BID%7D/put/requestBody/content/application~1json/schema/transactionRequestState'
+                  $ref: '#/paths/~1thirdpartyRequests~1transactions~1%7BID%7D/put/requestBody/content/application~1json/schema/properties/transactionRequestState'
                 transactionState:
                   title: TransactionState
                   type: string
@@ -2230,6 +2309,8 @@ paths:
                     - COMPLETED - Payee FSP has successfully performed the transaction.
                     - REJECTED - Payee FSP has failed to perform the transaction.
                   example: RECEIVED
+                extensionList:
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - transactionRequestState
                 - transactionState
@@ -2341,13 +2422,13 @@ paths:
                   properties:
                     verificationRequestId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                     challenge:
                       type: string
                       description: Base64 encoded bytes - The challenge generated by the DFSP.
                     consentId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                       description: |
                         The id of the stored consent object that contains the credential with which to verify
                         the signed challenge against.
@@ -2361,9 +2442,14 @@ paths:
                       title: FIDOPublicKeyCredentialAssertion
                       type: object
                       description: |
-                        An object sent in a `PUT /thirdpartyRequests/authorization/{ID}` request.
-                        based mostly on: https://webauthn.guide/#authentication
-                        AuthenticatorAssertionResponse
+                        A data model representing a FIDO Assertion result.
+                        Derived from PublicKeyCredential Interface in WebAuthN.
+
+                        The PublicKeyCredential interface represents the below fields with a Type of
+                        Javascript ArrayBuffer.
+                        For this API, we represent ArrayBuffers as base64 encoded utf-8 strings.
+
+                        https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#32128-fidopublickeycredentialassertion
                       properties:
                         id:
                           type: string
@@ -2424,6 +2510,8 @@ paths:
                         - response
                         - type
                       additionalProperties: false
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - verificationRequestId
                     - challenge
@@ -2436,13 +2524,13 @@ paths:
                   properties:
                     verificationRequestId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                     challenge:
                       type: string
                       description: Base64 encoded bytes - The challenge generated by the DFSP.
                     consentId:
                       allOf:
-                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/consentRequestId'
+                        - $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/consentRequestId'
                       description: |
                         The id of the stored consent object that contains the credential with which to verify
                         the signed challenge against.
@@ -2453,7 +2541,9 @@ paths:
                         - GENERIC
                       description: Describes a challenge that has been signed with a private key
                     genericSignedPayload:
-                      $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/authToken'
+                      $ref: '#/paths/~1consentRequests~1%7BID%7D/patch/requestBody/content/application~1json/schema/properties/authToken'
+                    extensionList:
+                      $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
                   required:
                     - verificationRequestId
                     - challenge
@@ -2528,12 +2618,10 @@ paths:
         - sampled
       operationId: PutThirdpartyRequestsVerificationsById
       summary: PutThirdpartyRequestsVerificationsById
-      description: |
-        The HTTP request `PUT /thirdpartyRequests/verifications/{ID}` is used by the Auth-Service to inform
-        the DFSP of a successful result in validating the verification of a Thirdparty Transaction Request.
-
-        If the validation fails, The Auth-Service MUST use `PUT /thirdpartyRequests/verifications/{ID}/error`
-        instead.
+      description: |-
+        The HTTP request `PUT /thirdpartyRequests/verifications/{ID}` is used by the Auth-Service to inform the DFSP of a successful result in validating the verification of a Thirdparty Transaction Request.
+        If the validation fails, the auth-service will send back `PUT /thirdpartyRequests/verifications/{ID}` with `authenticationResponse: 'REJECTED'`.
+        In unplanned error cases the Auth-Service MUST use `PUT /thirdpartyRequests/verifications/{ID}/error`.
       parameters:
         - $ref: '#/paths/~1consents/post/parameters/1'
       requestBody:
@@ -2544,13 +2632,21 @@ paths:
             schema:
               title: ThirdpartyRequestsVerificationsIDPutResponse
               type: object
-              description: 'The object sent in the PUT /thirdpartyRequests/verifications/{ID} request.'
+              description: |-
+                Used by: Auth Service
+                The callback PUT /thirdpartyRequests/verifications/{ID} is used to inform the client of the result of an authorization check. The {ID} in the URI should contain the authorizationRequestId which was used to request the check, or the {ID} that was used in the GET /thirdpartyRequests/verifications/{ID}.
+                https://github.com/mojaloop/documentation/blob/master/website/versioned_docs/v1.0.1/api/thirdparty/data-models.md#31821-put-thirdpartyrequestsverificationsid
               properties:
                 authenticationResponse:
+                  title: AuthenticationResponse
                   type: string
                   enum:
                     - VERIFIED
-                  description: The verification passed
+                  description: |-
+                    The AuthenticationResponse enumeration describes the result of authenticating verification request.
+                    Below are the allowed values for the enumeration AuthenticationResponse. - VERIFIED - The challenge was correctly signed.
+                extensionList:
+                  $ref: '#/paths/~1consentRequests/post/requestBody/content/application~1json/schema/properties/extensionList'
               required:
                 - authenticationResponse
             example: