@mojaloop/api-snippets 18.3.1 → 18.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (216) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/audit-ci.jsonc +7 -1
  3. package/docs/fspiop-rest-v2.0-ISO20022-openapi3-snippets.yaml +0 -2
  4. package/docs/sdk-scheme-adapter-outbound-v2_1_0-openapi3-snippets.yaml +1 -1
  5. package/docs/thirdparty-admin-v2.0-openapi3-snippets.yaml +3705 -0
  6. package/docs/thirdparty-openapi3-snippets.yaml +5 -5
  7. package/docs/thirdparty-v1.0-openapi3-snippets.yaml +3802 -0
  8. package/docs/thirdparty-v2.0-openapi3-snippets.yaml +1825 -0
  9. package/eslint.config.mjs +70 -0
  10. package/fspiop/v2_0_ISO20022/openapi3/components/schemas/FinancialInstitutionIdentification18.yaml +0 -1
  11. package/fspiop/v2_0_ISO20022/openapi3/components/schemas/FinancialInstitutionIdentification23.yaml +0 -1
  12. package/lib/fspiop/v2_0/index.js +0 -1
  13. package/lib/fspiop/v2_0/index.js.map +1 -1
  14. package/lib/fspiop/v2_0_ISO20022/index.js +0 -1
  15. package/lib/fspiop/v2_0_ISO20022/index.js.map +1 -1
  16. package/lib/fspiop/v2_0_ISO20022/json-schemas.json +0 -71
  17. package/lib/fspiop/v2_0_ISO20022/schemas.d.ts +0 -140
  18. package/lib/index.js +0 -1
  19. package/lib/index.js.map +1 -1
  20. package/lib/sdk-scheme-adapter/v2_0_0/backend/index.js +0 -1
  21. package/lib/sdk-scheme-adapter/v2_0_0/backend/index.js.map +1 -1
  22. package/lib/sdk-scheme-adapter/v2_0_0/outbound/index.js +0 -1
  23. package/lib/sdk-scheme-adapter/v2_0_0/outbound/index.js.map +1 -1
  24. package/lib/sdk-scheme-adapter/v2_1_0/backend/index.js +0 -1
  25. package/lib/sdk-scheme-adapter/v2_1_0/backend/index.js.map +1 -1
  26. package/lib/sdk-scheme-adapter/v2_1_0/outbound/index.js +0 -1
  27. package/lib/sdk-scheme-adapter/v2_1_0/outbound/index.js.map +1 -1
  28. package/lib/sdk-scheme-adapter/v2_1_0/outbound/json-schemas.json +1 -1
  29. package/lib/sdk-scheme-adapter/v2_1_0/outbound/schemas.d.ts +1 -1
  30. package/lib/thirdparty/v2_0/openapi.d.ts +1726 -0
  31. package/lib/thirdparty/v2_0/openapi.js +7 -0
  32. package/lib/thirdparty/v2_0/openapi.js.map +1 -0
  33. package/package.json +48 -45
  34. package/sdk-scheme-adapter/v2_1_0/components/schemas/transferRequest.yaml +1 -1
  35. package/test/dto/{thirdparty.test.ts → thirdparty_v1_0.test.ts} +1 -1
  36. package/thirdparty/v1_0/openapi3/components/schemas/FIDOPublicKeyCredentialAssertion.yaml +2 -2
  37. package/thirdparty/v1_0/openapi3/components/schemas/FIDOPublicKeyCredentialAttestation.yaml +3 -3
  38. package/thirdparty/v1_0/openapi3/thirdparty-dfsp-api.yaml +68 -61
  39. package/thirdparty/v1_0/openapi3/thirdparty-pisp-api.yaml +82 -75
  40. package/thirdparty/v2_0/openapi3/components/headers/Content-Length.yaml +1 -0
  41. package/thirdparty/v2_0/openapi3/components/headers/Content-Type.yaml +1 -0
  42. package/thirdparty/v2_0/openapi3/components/parameters/Accept.yaml +1 -0
  43. package/thirdparty/v2_0/openapi3/components/parameters/Content-Length.yaml +1 -0
  44. package/thirdparty/v2_0/openapi3/components/parameters/Content-Type.yaml +1 -0
  45. package/thirdparty/v2_0/openapi3/components/parameters/Date.yaml +1 -0
  46. package/thirdparty/v2_0/openapi3/components/parameters/FSPIOP-Destination.yaml +1 -0
  47. package/thirdparty/v2_0/openapi3/components/parameters/FSPIOP-Encryption.yaml +1 -0
  48. package/thirdparty/v2_0/openapi3/components/parameters/FSPIOP-HTTP-Method.yaml +1 -0
  49. package/thirdparty/v2_0/openapi3/components/parameters/FSPIOP-Signature.yaml +1 -0
  50. package/thirdparty/v2_0/openapi3/components/parameters/FSPIOP-Source.yaml +1 -0
  51. package/thirdparty/v2_0/openapi3/components/parameters/FSPIOP-URI.yaml +1 -0
  52. package/thirdparty/v2_0/openapi3/components/parameters/ID.yaml +1 -0
  53. package/thirdparty/v2_0/openapi3/components/parameters/ServiceType.yaml +6 -0
  54. package/thirdparty/v2_0/openapi3/components/parameters/SubId.yaml +1 -0
  55. package/thirdparty/v2_0/openapi3/components/parameters/Type.yaml +1 -0
  56. package/thirdparty/v2_0/openapi3/components/parameters/X-Forwarded-For.yaml +1 -0
  57. package/thirdparty/v2_0/openapi3/components/responses/200.yaml +1 -0
  58. package/thirdparty/v2_0/openapi3/components/responses/202.yaml +1 -0
  59. package/thirdparty/v2_0/openapi3/components/responses/400.yaml +1 -0
  60. package/thirdparty/v2_0/openapi3/components/responses/401.yaml +1 -0
  61. package/thirdparty/v2_0/openapi3/components/responses/403.yaml +1 -0
  62. package/thirdparty/v2_0/openapi3/components/responses/404.yaml +1 -0
  63. package/thirdparty/v2_0/openapi3/components/responses/405.yaml +1 -0
  64. package/thirdparty/v2_0/openapi3/components/responses/406.yaml +1 -0
  65. package/thirdparty/v2_0/openapi3/components/responses/501.yaml +1 -0
  66. package/thirdparty/v2_0/openapi3/components/responses/503.yaml +1 -0
  67. package/thirdparty/v2_0/openapi3/components/schemas/Account.yaml +17 -0
  68. package/thirdparty/v2_0/openapi3/components/schemas/AccountAddress.yaml +25 -0
  69. package/thirdparty/v2_0/openapi3/components/schemas/AccountList.yaml +11 -0
  70. package/thirdparty/v2_0/openapi3/components/schemas/Amount.yaml +1 -0
  71. package/thirdparty/v2_0/openapi3/components/schemas/AmountType.yaml +1 -0
  72. package/thirdparty/v2_0/openapi3/components/schemas/AuthenticationResponse.yaml +10 -0
  73. package/thirdparty/v2_0/openapi3/components/schemas/AuthenticatorAssertionResponse.yaml +32 -0
  74. package/thirdparty/v2_0/openapi3/components/schemas/AuthenticatorAttestationResponse.yaml +23 -0
  75. package/thirdparty/v2_0/openapi3/components/schemas/AuthorizationResponseType.yaml +8 -0
  76. package/thirdparty/v2_0/openapi3/components/schemas/AuthorizationResponseTypeAccepted.yaml +6 -0
  77. package/thirdparty/v2_0/openapi3/components/schemas/AuthorizationResponseTypeRejected.yaml +6 -0
  78. package/thirdparty/v2_0/openapi3/components/schemas/BinaryString.yaml +1 -0
  79. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestChannelType.yaml +9 -0
  80. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestChannelTypeOTP.yaml +6 -0
  81. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestChannelTypeWeb.yaml +6 -0
  82. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestsIDPatchRequest.yaml +16 -0
  83. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestsIDPutResponseOTP.yaml +30 -0
  84. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestsIDPutResponseWeb.yaml +39 -0
  85. package/thirdparty/v2_0/openapi3/components/schemas/ConsentRequestsPostRequest.yaml +44 -0
  86. package/thirdparty/v2_0/openapi3/components/schemas/ConsentStatus.yaml +9 -0
  87. package/thirdparty/v2_0/openapi3/components/schemas/ConsentStatusIssued.yaml +7 -0
  88. package/thirdparty/v2_0/openapi3/components/schemas/ConsentStatusRevoked.yaml +7 -0
  89. package/thirdparty/v2_0/openapi3/components/schemas/ConsentsIDPatchResponseRevoked.yaml +17 -0
  90. package/thirdparty/v2_0/openapi3/components/schemas/ConsentsIDPatchResponseVerified.yaml +19 -0
  91. package/thirdparty/v2_0/openapi3/components/schemas/ConsentsIDPutResponseSigned.yaml +23 -0
  92. package/thirdparty/v2_0/openapi3/components/schemas/ConsentsIDPutResponseVerified.yaml +23 -0
  93. package/thirdparty/v2_0/openapi3/components/schemas/ConsentsPostRequestAUTH.yaml +33 -0
  94. package/thirdparty/v2_0/openapi3/components/schemas/ConsentsPostRequestPISP.yaml +32 -0
  95. package/thirdparty/v2_0/openapi3/components/schemas/CorrelationId.yaml +1 -0
  96. package/thirdparty/v2_0/openapi3/components/schemas/CredentialStatusPending.yaml +7 -0
  97. package/thirdparty/v2_0/openapi3/components/schemas/CredentialStatusVerified.yaml +7 -0
  98. package/thirdparty/v2_0/openapi3/components/schemas/CredentialType.yaml +11 -0
  99. package/thirdparty/v2_0/openapi3/components/schemas/Currency.yaml +1 -0
  100. package/thirdparty/v2_0/openapi3/components/schemas/DateOfBirth.yaml +1 -0
  101. package/thirdparty/v2_0/openapi3/components/schemas/DateTime.yaml +1 -0
  102. package/thirdparty/v2_0/openapi3/components/schemas/ErrorCode.yaml +1 -0
  103. package/thirdparty/v2_0/openapi3/components/schemas/ErrorDescription.yaml +1 -0
  104. package/thirdparty/v2_0/openapi3/components/schemas/ErrorInformation.yaml +1 -0
  105. package/thirdparty/v2_0/openapi3/components/schemas/Extension.yaml +1 -0
  106. package/thirdparty/v2_0/openapi3/components/schemas/ExtensionKey.yaml +1 -0
  107. package/thirdparty/v2_0/openapi3/components/schemas/ExtensionList.yaml +1 -0
  108. package/thirdparty/v2_0/openapi3/components/schemas/ExtensionValue.yaml +1 -0
  109. package/thirdparty/v2_0/openapi3/components/schemas/FIDOPublicKeyCredentialAssertion.yaml +71 -0
  110. package/thirdparty/v2_0/openapi3/components/schemas/FIDOPublicKeyCredentialAttestation.yaml +54 -0
  111. package/thirdparty/v2_0/openapi3/components/schemas/FirstName.yaml +1 -0
  112. package/thirdparty/v2_0/openapi3/components/schemas/FspId.yaml +1 -0
  113. package/thirdparty/v2_0/openapi3/components/schemas/GenericCredential.yaml +13 -0
  114. package/thirdparty/v2_0/openapi3/components/schemas/GeoCode.yaml +1 -0
  115. package/thirdparty/v2_0/openapi3/components/schemas/IlpCondition.yaml +1 -0
  116. package/thirdparty/v2_0/openapi3/components/schemas/IlpFulfilment.yaml +1 -0
  117. package/thirdparty/v2_0/openapi3/components/schemas/IlpPacket.yaml +1 -0
  118. package/thirdparty/v2_0/openapi3/components/schemas/Integer.yaml +1 -0
  119. package/thirdparty/v2_0/openapi3/components/schemas/LastName.yaml +1 -0
  120. package/thirdparty/v2_0/openapi3/components/schemas/Latitude.yaml +1 -0
  121. package/thirdparty/v2_0/openapi3/components/schemas/Longitude.yaml +1 -0
  122. package/thirdparty/v2_0/openapi3/components/schemas/MerchantClassificationCode.yaml +1 -0
  123. package/thirdparty/v2_0/openapi3/components/schemas/MiddleName.yaml +1 -0
  124. package/thirdparty/v2_0/openapi3/components/schemas/Money.yaml +1 -0
  125. package/thirdparty/v2_0/openapi3/components/schemas/Name.yaml +2 -0
  126. package/thirdparty/v2_0/openapi3/components/schemas/Note.yaml +1 -0
  127. package/thirdparty/v2_0/openapi3/components/schemas/ParticipantsIDPutResponse.yaml +17 -0
  128. package/thirdparty/v2_0/openapi3/components/schemas/ParticipantsPostRequest.yaml +20 -0
  129. package/thirdparty/v2_0/openapi3/components/schemas/ParticipantsTypeIDPutResponse.yaml +8 -0
  130. package/thirdparty/v2_0/openapi3/components/schemas/ParticipantsTypeIDSubIDPostRequest.yaml +15 -0
  131. package/thirdparty/v2_0/openapi3/components/schemas/PartiesTypeIDPutResponse.yaml +13 -0
  132. package/thirdparty/v2_0/openapi3/components/schemas/Party.yaml +15 -0
  133. package/thirdparty/v2_0/openapi3/components/schemas/PartyComplexName.yaml +1 -0
  134. package/thirdparty/v2_0/openapi3/components/schemas/PartyIdInfo.yaml +17 -0
  135. package/thirdparty/v2_0/openapi3/components/schemas/PartyIdInfoTPLink.yaml +17 -0
  136. package/thirdparty/v2_0/openapi3/components/schemas/PartyIdType.yaml +58 -0
  137. package/thirdparty/v2_0/openapi3/components/schemas/PartyIdTypeTPLink.yaml +7 -0
  138. package/thirdparty/v2_0/openapi3/components/schemas/PartyIdentifier.yaml +1 -0
  139. package/thirdparty/v2_0/openapi3/components/schemas/PartyName.yaml +1 -0
  140. package/thirdparty/v2_0/openapi3/components/schemas/PartyPersonalInfo.yaml +1 -0
  141. package/thirdparty/v2_0/openapi3/components/schemas/PartyResult.yaml +10 -0
  142. package/thirdparty/v2_0/openapi3/components/schemas/PartySubIdOrType.yaml +1 -0
  143. package/thirdparty/v2_0/openapi3/components/schemas/PartyTPLink.yaml +14 -0
  144. package/thirdparty/v2_0/openapi3/components/schemas/QuotesIDPutResponse.yaml +1 -0
  145. package/thirdparty/v2_0/openapi3/components/schemas/QuotesPostRequest.yaml +79 -0
  146. package/thirdparty/v2_0/openapi3/components/schemas/Scope.yaml +20 -0
  147. package/thirdparty/v2_0/openapi3/components/schemas/ScopeAction.yaml +14 -0
  148. package/thirdparty/v2_0/openapi3/components/schemas/ServiceType.yaml +15 -0
  149. package/thirdparty/v2_0/openapi3/components/schemas/ServicesServiceTypePutResponse.yaml +26 -0
  150. package/thirdparty/v2_0/openapi3/components/schemas/SignedCredential.yaml +23 -0
  151. package/thirdparty/v2_0/openapi3/components/schemas/SignedPayloadFIDO.yaml +11 -0
  152. package/thirdparty/v2_0/openapi3/components/schemas/SignedPayloadGeneric.yaml +11 -0
  153. package/thirdparty/v2_0/openapi3/components/schemas/SignedPayloadType.yaml +9 -0
  154. package/thirdparty/v2_0/openapi3/components/schemas/SignedPayloadTypeFIDO.yaml +5 -0
  155. package/thirdparty/v2_0/openapi3/components/schemas/SignedPayloadTypeGeneric.yaml +5 -0
  156. package/thirdparty/v2_0/openapi3/components/schemas/Transaction.yaml +43 -0
  157. package/thirdparty/v2_0/openapi3/components/schemas/TransactionRequestState.yaml +1 -0
  158. package/thirdparty/v2_0/openapi3/components/schemas/TransactionState.yaml +1 -0
  159. package/thirdparty/v2_0/openapi3/components/schemas/TransactionType.yaml +1 -0
  160. package/thirdparty/v2_0/openapi3/components/schemas/TransfersPostRequestFIDO.yaml +15 -0
  161. package/thirdparty/v2_0/openapi3/components/schemas/TransfersPostRequestGeneric.yaml +15 -0
  162. package/thirdparty/v2_0/openapi3/components/schemas/Uri.yaml +8 -0
  163. package/thirdparty/v2_0/openapi3/components/schemas/VerifiedCredential.yaml +23 -0
  164. package/thirdparty/v2_0/openapi3/components/schemas/tppAccountRequestPostRequest.yaml +35 -0
  165. package/thirdparty/v2_0/openapi3/components/schemas/tppAccountRequestPutResponse.yaml +30 -0
  166. package/thirdparty/v2_0/openapi3/components/schemas/tppAccountsIDPutResponse.yaml +21 -0
  167. package/thirdparty/v2_0/openapi3/components/schemas/tppAuthorizationsIDPutResponseFIDO.yaml +15 -0
  168. package/thirdparty/v2_0/openapi3/components/schemas/tppAuthorizationsIDPutResponseGeneric.yaml +15 -0
  169. package/thirdparty/v2_0/openapi3/components/schemas/tppAuthorizationsIDPutResponseRejected.yaml +10 -0
  170. package/thirdparty/v2_0/openapi3/components/schemas/tppAuthorizationsPostRequest.yaml +67 -0
  171. package/thirdparty/v2_0/openapi3/components/schemas/tppTransactionRequestPostRequest.yaml +60 -0
  172. package/thirdparty/v2_0/openapi3/components/schemas/tppTransactionRequestPutResponse.yaml +67 -0
  173. package/thirdparty/v2_0/openapi3/components/schemas/tppTransfersPostRequest.yaml +19 -0
  174. package/thirdparty/v2_0/openapi3/components/schemas/tppTransfersPutResponse.yaml +25 -0
  175. package/thirdparty/v2_0/openapi3/components/schemas/tppVerificationsIDPutResponse.yaml +19 -0
  176. package/thirdparty/v2_0/openapi3/components/schemas/tppVerificationsPostRequestFIDO.yaml +28 -0
  177. package/thirdparty/v2_0/openapi3/components/schemas/tppVerificationsPostRequestGeneric.yaml +28 -0
  178. package/thirdparty/v2_0/openapi3/openapi-admin.yaml +99 -0
  179. package/thirdparty/v2_0/openapi3/openapi.yaml +64 -0
  180. package/thirdparty/v2_0/openapi3/paths/health.yaml +25 -0
  181. package/thirdparty/v2_0/openapi3/paths/metrics.yaml +25 -0
  182. package/thirdparty/v2_0/openapi3/paths/participants.yaml +50 -0
  183. package/thirdparty/v2_0/openapi3/paths/participants_ID.yaml +49 -0
  184. package/thirdparty/v2_0/openapi3/paths/participants_ID_error.yaml +51 -0
  185. package/thirdparty/v2_0/openapi3/paths/participants_Type_ID.yaml +169 -0
  186. package/thirdparty/v2_0/openapi3/paths/participants_Type_ID_error.yaml +52 -0
  187. package/thirdparty/v2_0/openapi3/paths/services_ServiceType.yaml +77 -0
  188. package/thirdparty/v2_0/openapi3/paths/services_ServiceType_error.yaml +49 -0
  189. package/thirdparty/v2_0/openapi3/paths/tppAccountRequest.yaml +49 -0
  190. package/thirdparty/v2_0/openapi3/paths/tppAccountRequest_ID.yaml +86 -0
  191. package/thirdparty/v2_0/openapi3/paths/tppAccountRequest_ID_error.yaml +48 -0
  192. package/thirdparty/v2_0/openapi3/paths/tppAccounts_ID.yaml +88 -0
  193. package/thirdparty/v2_0/openapi3/paths/tppAccounts_ID_error.yaml +48 -0
  194. package/thirdparty/v2_0/openapi3/paths/tppAuthorizations.yaml +51 -0
  195. package/thirdparty/v2_0/openapi3/paths/tppAuthorizations_ID.yaml +86 -0
  196. package/thirdparty/v2_0/openapi3/paths/tppAuthorizations_ID_error.yaml +55 -0
  197. package/thirdparty/v2_0/openapi3/paths/tppConsentRequests.yaml +48 -0
  198. package/thirdparty/v2_0/openapi3/paths/tppConsentRequests_ID.yaml +123 -0
  199. package/thirdparty/v2_0/openapi3/paths/tppConsentRequests_ID_error.yaml +48 -0
  200. package/thirdparty/v2_0/openapi3/paths/tppConsents.yaml +49 -0
  201. package/thirdparty/v2_0/openapi3/paths/tppConsents_ID.yaml +165 -0
  202. package/thirdparty/v2_0/openapi3/paths/tppConsents_ID_error.yaml +48 -0
  203. package/thirdparty/v2_0/openapi3/paths/tppTransactionRequests.yaml +48 -0
  204. package/thirdparty/v2_0/openapi3/paths/tppTransactionRequests_ID.yaml +83 -0
  205. package/thirdparty/v2_0/openapi3/paths/tppTransactionRequests_ID_error.yaml +52 -0
  206. package/thirdparty/v2_0/openapi3/paths/tppTransfers.yaml +47 -0
  207. package/thirdparty/v2_0/openapi3/paths/tppTransfers_ID.yaml +86 -0
  208. package/thirdparty/v2_0/openapi3/paths/tppTransfers_ID_error.yaml +52 -0
  209. package/thirdparty/v2_0/openapi3/paths/tppVerifications.yaml +49 -0
  210. package/thirdparty/v2_0/openapi3/paths/tppVerifications_ID.yaml +87 -0
  211. package/thirdparty/v2_0/openapi3/paths/tppVerifications_ID_error.yaml +49 -0
  212. package/thirdparty/v2_0/openapi3/thirdparty-dfsp-admin-api.template.yaml +53 -0
  213. package/thirdparty/v2_0/openapi3/thirdparty-dfsp-admin-api.yaml +2633 -0
  214. package/thirdparty/v2_0/openapi3/thirdparty-pisp-admin-api.template.yaml +57 -0
  215. package/thirdparty/v2_0/openapi3/thirdparty-pisp-admin-api.yaml +3103 -0
  216. package/tsconfig.build.json +4 -3
@@ -0,0 +1,1825 @@
1
+ openapi: 3.0.2
2
+ info:
3
+ version: '2.0'
4
+ title: Thirdparty Snippets
5
+ description: |
6
+ Based on sequence diagrams
7
+ (https://github.com/mojaloop/tpp/tree/main/docs/out).
8
+ This is a work in progress.
9
+ license:
10
+ name: TBD
11
+ servers:
12
+ - url: '{protocol}://hostname:<port>/switch/'
13
+ variables:
14
+ protocol:
15
+ enum:
16
+ - http
17
+ - https
18
+ default: https
19
+ paths:
20
+ /interface:
21
+ post:
22
+ description: Essential path to include schema definitions that are not used so that these definitions get included into the openapi-cli bundle api definition so that they get converted into typescript definitions.
23
+ operationId: test
24
+ requestBody:
25
+ content:
26
+ application/json:
27
+ schema:
28
+ oneOf:
29
+ - $ref: '#/components/schemas/ParticipantsIDPutResponse'
30
+ - $ref: '#/components/schemas/PartiesTypeIDPutResponse'
31
+ - $ref: '#/components/schemas/QuotesIDPutResponse'
32
+ - $ref: '#/components/schemas/AuthorizationResponseType'
33
+ - $ref: '#/components/schemas/ConsentStatusIssued'
34
+ - $ref: '#/components/schemas/IlpFulfilment'
35
+ - $ref: '#/components/schemas/Integer'
36
+ - $ref: '#/components/schemas/Note'
37
+ - $ref: '#/components/schemas/PartyIdInfoTPLink'
38
+ - $ref: '#/components/schemas/PartyResult'
39
+ - $ref: '#/components/schemas/ServiceType'
40
+ - $ref: '#/components/schemas/ParticipantsPostRequest'
41
+ - $ref: '#/components/schemas/QuotesPostRequest'
42
+ responses:
43
+ '200':
44
+ description: Ok
45
+ /health:
46
+ get:
47
+ tags:
48
+ - health
49
+ responses:
50
+ '200':
51
+ $ref: '#/components/responses/200'
52
+ '400':
53
+ $ref: '#/components/responses/400'
54
+ '401':
55
+ $ref: '#/components/responses/401'
56
+ '403':
57
+ $ref: '#/components/responses/403'
58
+ '404':
59
+ $ref: '#/components/responses/404'
60
+ '405':
61
+ $ref: '#/components/responses/405'
62
+ '406':
63
+ $ref: '#/components/responses/406'
64
+ '501':
65
+ $ref: '#/components/responses/501'
66
+ '503':
67
+ $ref: '#/components/responses/503'
68
+ operationId: HealthGet
69
+ summary: Health check endpoint
70
+ description: The HTTP request GET /health is used to return the current status of the API.
71
+ /metrics:
72
+ get:
73
+ tags:
74
+ - health
75
+ responses:
76
+ '200':
77
+ $ref: '#/components/responses/200'
78
+ '400':
79
+ $ref: '#/components/responses/400'
80
+ '401':
81
+ $ref: '#/components/responses/401'
82
+ '403':
83
+ $ref: '#/components/responses/403'
84
+ '404':
85
+ $ref: '#/components/responses/404'
86
+ '405':
87
+ $ref: '#/components/responses/405'
88
+ '406':
89
+ $ref: '#/components/responses/406'
90
+ '501':
91
+ $ref: '#/components/responses/501'
92
+ '503':
93
+ $ref: '#/components/responses/503'
94
+ operationId: MetricsGet
95
+ summary: Prometheus metrics endpoint
96
+ description: The HTTP request GET /metrics is used to return metrics for the API.
97
+ /tppTransactionRequests:
98
+ parameters:
99
+ - $ref: '#/components/parameters/Content-Type'
100
+ - $ref: '#/components/parameters/Date'
101
+ - $ref: '#/components/parameters/X-Forwarded-For'
102
+ - $ref: '#/components/parameters/FSPIOP-Source'
103
+ - $ref: '#/components/parameters/FSPIOP-Destination'
104
+ - $ref: '#/components/parameters/FSPIOP-Encryption'
105
+ - $ref: '#/components/parameters/FSPIOP-Signature'
106
+ - $ref: '#/components/parameters/FSPIOP-URI'
107
+ - $ref: '#/components/parameters/FSPIOP-HTTP-Method'
108
+ post:
109
+ operationId: tppTransactionsPost
110
+ summary: tppTransactionsPost
111
+ description: |
112
+ The `/tppTransactionRequests` resource is analogous to the `/transactionRequests` resource described fspiop API. The PISP uses it to request the owner of the PISP's customer's account to transfer a specified amount from the customer's account with the DFSP to a named Payee, or a request to pay request from a named payer into the customer's account.
113
+ tags:
114
+ - transaction Requests
115
+ parameters:
116
+ - $ref: '#/components/parameters/Accept'
117
+ - $ref: '#/components/parameters/Content-Length'
118
+ requestBody:
119
+ description: Transaction request to be created.
120
+ required: true
121
+ content:
122
+ application/json:
123
+ schema:
124
+ $ref: '#/components/schemas/tppTransactionRequestPostRequest'
125
+ responses:
126
+ '202':
127
+ $ref: '#/components/responses/202'
128
+ '400':
129
+ $ref: '#/components/responses/400'
130
+ '401':
131
+ $ref: '#/components/responses/401'
132
+ '403':
133
+ $ref: '#/components/responses/403'
134
+ '404':
135
+ $ref: '#/components/responses/404'
136
+ '405':
137
+ $ref: '#/components/responses/405'
138
+ '406':
139
+ $ref: '#/components/responses/406'
140
+ '501':
141
+ $ref: '#/components/responses/501'
142
+ '503':
143
+ $ref: '#/components/responses/503'
144
+ /tppTransactionRequests/{ID}:
145
+ parameters:
146
+ - $ref: '#/components/parameters/ID'
147
+ - $ref: '#/components/parameters/Content-Type'
148
+ - $ref: '#/components/parameters/Date'
149
+ - $ref: '#/components/parameters/X-Forwarded-For'
150
+ - $ref: '#/components/parameters/FSPIOP-Source'
151
+ - $ref: '#/components/parameters/FSPIOP-Destination'
152
+ - $ref: '#/components/parameters/FSPIOP-Encryption'
153
+ - $ref: '#/components/parameters/FSPIOP-Signature'
154
+ - $ref: '#/components/parameters/FSPIOP-URI'
155
+ - $ref: '#/components/parameters/FSPIOP-HTTP-Method'
156
+ get:
157
+ tags:
158
+ - transaction Requests
159
+ operationId: GetThirdpartyTransactionRequests
160
+ summary: GetThirdpartyTransactionRequests
161
+ description: |
162
+ The HTTP request `GET /tppTransactionRequests/{ID}` is used to request the
163
+ retrieval of a third party transaction request.
164
+ parameters:
165
+ - $ref: '#/components/parameters/Accept'
166
+ responses:
167
+ '202':
168
+ $ref: '#/components/responses/202'
169
+ '400':
170
+ $ref: '#/components/responses/400'
171
+ '401':
172
+ $ref: '#/components/responses/401'
173
+ '403':
174
+ $ref: '#/components/responses/403'
175
+ '404':
176
+ $ref: '#/components/responses/404'
177
+ '405':
178
+ $ref: '#/components/responses/405'
179
+ '406':
180
+ $ref: '#/components/responses/406'
181
+ '501':
182
+ $ref: '#/components/responses/501'
183
+ '503':
184
+ $ref: '#/components/responses/503'
185
+ put:
186
+ tags:
187
+ - transaction Requests
188
+ operationId: tppUpdateTransactionRequests
189
+ summary: tppUpdateTransactionRequests
190
+ description: |
191
+ The HTTP request `PUT /tppTransactionRequests/{ID}` is used by the DFSP to inform the client about
192
+ the status of a previously requested thirdparty transaction request.
193
+
194
+ Switch(Thirdparty API Adapter) -> PISP
195
+ parameters:
196
+ - $ref: '#/components/parameters/Content-Length'
197
+ requestBody:
198
+ required: true
199
+ content:
200
+ application/json:
201
+ schema:
202
+ $ref: '#/components/schemas/tppTransactionRequestPutResponse'
203
+ responses:
204
+ '200':
205
+ $ref: '#/components/responses/200'
206
+ '400':
207
+ $ref: '#/components/responses/400'
208
+ '401':
209
+ $ref: '#/components/responses/401'
210
+ '403':
211
+ $ref: '#/components/responses/403'
212
+ '404':
213
+ $ref: '#/components/responses/404'
214
+ '405':
215
+ $ref: '#/components/responses/405'
216
+ '406':
217
+ $ref: '#/components/responses/406'
218
+ '501':
219
+ $ref: '#/components/responses/501'
220
+ '503':
221
+ $ref: '#/components/responses/503'
222
+ /tppTransactionRequests/{ID}/error:
223
+ parameters:
224
+ - $ref: '#/components/parameters/ID'
225
+ - $ref: '#/components/parameters/Content-Type'
226
+ - $ref: '#/components/parameters/Date'
227
+ - $ref: '#/components/parameters/X-Forwarded-For'
228
+ - $ref: '#/components/parameters/FSPIOP-Source'
229
+ - $ref: '#/components/parameters/FSPIOP-Destination'
230
+ - $ref: '#/components/parameters/FSPIOP-Encryption'
231
+ - $ref: '#/components/parameters/FSPIOP-Signature'
232
+ - $ref: '#/components/parameters/FSPIOP-URI'
233
+ - $ref: '#/components/parameters/FSPIOP-HTTP-Method'
234
+ put:
235
+ tags:
236
+ - transaction Requests
237
+ operationId: tppTransactionRequestsError
238
+ summary: tppTransactionRequestsError
239
+ description: |
240
+ If the server is unable to find the transaction request, or another processing error occurs,
241
+ the error callback `PUT /tppTransactionRequests/{ID}/error` is used.
242
+ The `{ID}` in the URI should contain the `transactionRequestId` that was used for the creation of
243
+ the thirdparty transaction request.
244
+ parameters:
245
+ - $ref: '#/components/parameters/Content-Length'
246
+ requestBody:
247
+ description: Error information returned.
248
+ required: true
249
+ content:
250
+ application/json:
251
+ schema:
252
+ $ref: '#/components/schemas/ErrorInformationObject'
253
+ responses:
254
+ '200':
255
+ $ref: '#/components/responses/200'
256
+ '400':
257
+ $ref: '#/components/responses/400'
258
+ '401':
259
+ $ref: '#/components/responses/401'
260
+ '403':
261
+ $ref: '#/components/responses/403'
262
+ '404':
263
+ $ref: '#/components/responses/404'
264
+ '405':
265
+ $ref: '#/components/responses/405'
266
+ '406':
267
+ $ref: '#/components/responses/406'
268
+ '501':
269
+ $ref: '#/components/responses/501'
270
+ '503':
271
+ $ref: '#/components/responses/503'
272
+ /tppTransfers:
273
+ parameters:
274
+ - $ref: '#/components/parameters/Content-Type'
275
+ - $ref: '#/components/parameters/Date'
276
+ - $ref: '#/components/parameters/X-Forwarded-For'
277
+ - $ref: '#/components/parameters/FSPIOP-Source'
278
+ - $ref: '#/components/parameters/FSPIOP-Destination'
279
+ - $ref: '#/components/parameters/FSPIOP-Encryption'
280
+ - $ref: '#/components/parameters/FSPIOP-Signature'
281
+ - $ref: '#/components/parameters/FSPIOP-URI'
282
+ - $ref: '#/components/parameters/FSPIOP-HTTP-Method'
283
+ post:
284
+ operationId: tppPostTransfers
285
+ summary: tppPostTransfers
286
+ description: The HTTP request POST `/tppTransfers` is used by a PISP to initiate a 3rd party Transaction request with a DFSP
287
+ tags:
288
+ - transfers
289
+ parameters:
290
+ - $ref: '#/components/parameters/Accept'
291
+ - $ref: '#/components/parameters/Content-Length'
292
+ requestBody:
293
+ description: Transaction request to be created.
294
+ required: true
295
+ content:
296
+ application/json:
297
+ schema:
298
+ $ref: '#/components/schemas/tppTransfersPostRequest'
299
+ responses:
300
+ '202':
301
+ $ref: '#/components/responses/202'
302
+ '400':
303
+ $ref: '#/components/responses/400'
304
+ '401':
305
+ $ref: '#/components/responses/401'
306
+ '403':
307
+ $ref: '#/components/responses/403'
308
+ '404':
309
+ $ref: '#/components/responses/404'
310
+ '405':
311
+ $ref: '#/components/responses/405'
312
+ '406':
313
+ $ref: '#/components/responses/406'
314
+ '501':
315
+ $ref: '#/components/responses/501'
316
+ '503':
317
+ $ref: '#/components/responses/503'
318
+ /tppTransfers/{ID}:
319
+ parameters:
320
+ - $ref: '#/components/parameters/ID'
321
+ - $ref: '#/components/parameters/Content-Type'
322
+ - $ref: '#/components/parameters/Date'
323
+ - $ref: '#/components/parameters/X-Forwarded-For'
324
+ - $ref: '#/components/parameters/FSPIOP-Source'
325
+ - $ref: '#/components/parameters/FSPIOP-Destination'
326
+ - $ref: '#/components/parameters/FSPIOP-Encryption'
327
+ - $ref: '#/components/parameters/FSPIOP-Signature'
328
+ - $ref: '#/components/parameters/FSPIOP-URI'
329
+ - $ref: '#/components/parameters/FSPIOP-HTTP-Method'
330
+ get:
331
+ tags:
332
+ - transfers
333
+ operationId: tppGetTransfers
334
+ summary: tppGetTransfers
335
+ description: |
336
+ The HTTP request `GET /tppTransfers/{ID}` is used to request the
337
+ retrieval of a third party transaction request.
338
+ parameters:
339
+ - $ref: '#/components/parameters/Accept'
340
+ responses:
341
+ '202':
342
+ $ref: '#/components/responses/202'
343
+ '400':
344
+ $ref: '#/components/responses/400'
345
+ '401':
346
+ $ref: '#/components/responses/401'
347
+ '403':
348
+ $ref: '#/components/responses/403'
349
+ '404':
350
+ $ref: '#/components/responses/404'
351
+ '405':
352
+ $ref: '#/components/responses/405'
353
+ '406':
354
+ $ref: '#/components/responses/406'
355
+ '501':
356
+ $ref: '#/components/responses/501'
357
+ '503':
358
+ $ref: '#/components/responses/503'
359
+ put:
360
+ tags:
361
+ - transfers
362
+ operationId: tppUpdateTransfersRequest
363
+ summary: tppUpdateTransfersRequest
364
+ description: |
365
+ The HTTP request `PUT /tppTransfers/{ID}` is used by the DFSP to inform the client about
366
+ the status of a previously requested thirdparty transaction request. The ID is the executionRequestId that was provided in the corresponding POST request.
367
+
368
+ Switch(Thirdparty API Adapter) -> PISP
369
+ parameters:
370
+ - $ref: '#/components/parameters/Content-Length'
371
+ requestBody:
372
+ required: true
373
+ content:
374
+ application/json:
375
+ schema:
376
+ $ref: '#/components/schemas/tppTransfersPutResponse'
377
+ example:
378
+ transactionRequestState: RECEIVED
379
+ responses:
380
+ '200':
381
+ $ref: '#/components/responses/200'
382
+ '400':
383
+ $ref: '#/components/responses/400'
384
+ '401':
385
+ $ref: '#/components/responses/401'
386
+ '403':
387
+ $ref: '#/components/responses/403'
388
+ '404':
389
+ $ref: '#/components/responses/404'
390
+ '405':
391
+ $ref: '#/components/responses/405'
392
+ '406':
393
+ $ref: '#/components/responses/406'
394
+ '501':
395
+ $ref: '#/components/responses/501'
396
+ '503':
397
+ $ref: '#/components/responses/503'
398
+ /tppTransfers/{ID}/error:
399
+ parameters:
400
+ - $ref: '#/components/parameters/ID'
401
+ - $ref: '#/components/parameters/Content-Type'
402
+ - $ref: '#/components/parameters/Date'
403
+ - $ref: '#/components/parameters/X-Forwarded-For'
404
+ - $ref: '#/components/parameters/FSPIOP-Source'
405
+ - $ref: '#/components/parameters/FSPIOP-Destination'
406
+ - $ref: '#/components/parameters/FSPIOP-Encryption'
407
+ - $ref: '#/components/parameters/FSPIOP-Signature'
408
+ - $ref: '#/components/parameters/FSPIOP-URI'
409
+ - $ref: '#/components/parameters/FSPIOP-HTTP-Method'
410
+ put:
411
+ tags:
412
+ - transfers
413
+ operationId: tppTransfersRequestsError
414
+ summary: tppTransfersRequestsError
415
+ description: |
416
+ If the server is unable to find the transaction request, or another processing error occurs,
417
+ the error callback `PUT /tppTransfers/{ID}/error` is used.
418
+ The `{ID}` in the URI should contain the `transactionRequestId` that was used for the creation of
419
+ the thirdparty transaction request.
420
+ parameters:
421
+ - $ref: '#/components/parameters/Content-Length'
422
+ requestBody:
423
+ description: Error information returned.
424
+ required: true
425
+ content:
426
+ application/json:
427
+ schema:
428
+ $ref: '#/components/schemas/ErrorInformationObject'
429
+ responses:
430
+ '200':
431
+ $ref: '#/components/responses/200'
432
+ '400':
433
+ $ref: '#/components/responses/400'
434
+ '401':
435
+ $ref: '#/components/responses/401'
436
+ '403':
437
+ $ref: '#/components/responses/403'
438
+ '404':
439
+ $ref: '#/components/responses/404'
440
+ '405':
441
+ $ref: '#/components/responses/405'
442
+ '406':
443
+ $ref: '#/components/responses/406'
444
+ '501':
445
+ $ref: '#/components/responses/501'
446
+ '503':
447
+ $ref: '#/components/responses/503'
448
+ components:
449
+ schemas:
450
+ PartyIdType:
451
+ title: PartyIdType
452
+ type: string
453
+ enum:
454
+ - MSISDN
455
+ - EMAIL
456
+ - PERSONAL_ID
457
+ - BUSINESS
458
+ - DEVICE
459
+ - ACCOUNT_ID
460
+ - IBAN
461
+ - ALIAS
462
+ - CONSENT
463
+ - THIRD_PARTY_LINK
464
+ description: |
465
+ Below are the allowed values for the enumeration.
466
+ - MSISDN - An MSISDN (Mobile Station International Subscriber Directory
467
+ Number, that is, the phone number) is used as reference to a participant.
468
+ The MSISDN identifier should be in international format according to the
469
+ [ITU-T E.164 standard](https://www.itu.int/rec/T-REC-E.164/en).
470
+ Optionally, the MSISDN may be prefixed by a single plus sign, indicating the
471
+ international prefix.
472
+ - EMAIL - An email is used as reference to a
473
+ participant. The format of the email should be according to the informational
474
+ [RFC 3696](https://tools.ietf.org/html/rfc3696).
475
+ - PERSONAL_ID - A personal identifier is used as reference to a participant.
476
+ Examples of personal identification are passport number, birth certificate
477
+ number, and national registration number. The identifier number is added in
478
+ the PartyIdentifier element. The personal identifier type is added in the
479
+ PartySubIdOrType element.
480
+ - BUSINESS - A specific Business (for example, an organization or a company)
481
+ is used as reference to a participant. The BUSINESS identifier can be in any
482
+ format. To make a transaction connected to a specific username or bill number
483
+ in a Business, the PartySubIdOrType element should be used.
484
+ - DEVICE - A specific device (for example, a POS or ATM) ID connected to a
485
+ specific business or organization is used as reference to a Party.
486
+ For referencing a specific device under a specific business or organization,
487
+ use the PartySubIdOrType element.
488
+ - ACCOUNT_ID - A bank account number or FSP account ID should be used as
489
+ reference to a participant. The ACCOUNT_ID identifier can be in any format,
490
+ as formats can greatly differ depending on country and FSP.
491
+ - IBAN - A bank account number or FSP account ID is used as reference to a
492
+ participant. The IBAN identifier can consist of up to 34 alphanumeric
493
+ characters and should be entered without whitespace.
494
+ - ALIAS An alias is used as reference to a participant. The alias should be
495
+ created in the FSP as an alternative reference to an account owner.
496
+ Another example of an alias is a username in the FSP system.
497
+ The ALIAS identifier can be in any format. It is also possible to use the
498
+ PartySubIdOrType element for identifying an account under an Alias defined
499
+ by the PartyIdentifier.
500
+ - CONSENT - A Consent represents an agreement between a PISP, a Customer and
501
+ a DFSP which allows the PISP permission to perform actions on behalf of the
502
+ customer. A Consent has an authoritative source: either the DFSP who issued
503
+ the Consent, or an Auth Service which administers the Consent.
504
+ - THIRD_PARTY_LINK - A Third Party Link represents an agreement between a PISP,
505
+ a DFSP, and a specific Customer's account at the DFSP. The content of the link
506
+ is created by the DFSP at the time when it gives permission to the PISP for
507
+ specific access to a given account.
508
+ example: PERSONAL_ID
509
+ PartyIdentifier:
510
+ title: PartyIdentifier
511
+ type: string
512
+ minLength: 1
513
+ maxLength: 128
514
+ description: Identifier of the Party.
515
+ example: '16135551212'
516
+ PartySubIdOrType:
517
+ title: PartySubIdOrType
518
+ type: string
519
+ minLength: 1
520
+ maxLength: 128
521
+ description: Either a sub-identifier of a PartyIdentifier, or a sub-type of the PartyIdType, normally a PersonalIdentifierType.
522
+ FspId:
523
+ title: FspId
524
+ type: string
525
+ minLength: 1
526
+ maxLength: 32
527
+ description: FSP identifier.
528
+ ExtensionKey:
529
+ title: ExtensionKey
530
+ type: string
531
+ minLength: 1
532
+ maxLength: 32
533
+ description: Extension key.
534
+ ExtensionValue:
535
+ title: ExtensionValue
536
+ type: string
537
+ minLength: 1
538
+ maxLength: 128
539
+ description: Extension value.
540
+ Extension:
541
+ title: Extension
542
+ type: object
543
+ additionalProperties: false
544
+ description: Data model for the complex type Extension.
545
+ properties:
546
+ key:
547
+ $ref: '#/components/schemas/ExtensionKey'
548
+ value:
549
+ $ref: '#/components/schemas/ExtensionValue'
550
+ required:
551
+ - key
552
+ - value
553
+ ExtensionList:
554
+ title: ExtensionList
555
+ type: object
556
+ additionalProperties: false
557
+ description: Data model for the complex type ExtensionList. An optional list of extensions, specific to deployment.
558
+ properties:
559
+ extension:
560
+ type: array
561
+ items:
562
+ $ref: '#/components/schemas/Extension'
563
+ minItems: 1
564
+ maxItems: 16
565
+ description: Number of Extension elements.
566
+ required:
567
+ - extension
568
+ PartyIdInfo:
569
+ title: PartyIdInfo
570
+ type: object
571
+ description: Data model for the complex type PartyIdInfo.
572
+ properties:
573
+ partyIdType:
574
+ $ref: '#/components/schemas/PartyIdType'
575
+ partyIdentifier:
576
+ $ref: '#/components/schemas/PartyIdentifier'
577
+ partySubIdOrType:
578
+ $ref: '#/components/schemas/PartySubIdOrType'
579
+ fspId:
580
+ $ref: '#/components/schemas/FspId'
581
+ extensionList:
582
+ $ref: '#/components/schemas/ExtensionList'
583
+ required:
584
+ - partyIdType
585
+ - partyIdentifier
586
+ ErrorCode:
587
+ title: ErrorCode
588
+ type: string
589
+ pattern: ^[1-9]\d{3}$
590
+ description: The API data type ErrorCode is a JSON String of four characters, consisting of digits only. Negative numbers are not allowed. A leading zero is not allowed. Each error code in the API is a four-digit number, for example, 1234, where the first number (1 in the example) represents the high-level error category, the second number (2 in the example) represents the low-level error category, and the last two numbers (34 in the example) represent the specific error.
591
+ example: '5100'
592
+ ErrorDescription:
593
+ title: ErrorDescription
594
+ type: string
595
+ minLength: 1
596
+ maxLength: 128
597
+ description: Error description string.
598
+ ErrorInformation:
599
+ title: ErrorInformation
600
+ type: object
601
+ additionalProperties: false
602
+ description: Data model for the complex type ErrorInformation.
603
+ properties:
604
+ errorCode:
605
+ $ref: '#/components/schemas/ErrorCode'
606
+ errorDescription:
607
+ $ref: '#/components/schemas/ErrorDescription'
608
+ extensionList:
609
+ $ref: '#/components/schemas/ExtensionList'
610
+ required:
611
+ - errorCode
612
+ - errorDescription
613
+ PartyResult:
614
+ title: PartyResult
615
+ type: object
616
+ description: Data model for the complex type PartyResult.
617
+ properties:
618
+ partyId:
619
+ $ref: '#/components/schemas/PartyIdInfo'
620
+ errorInformation:
621
+ $ref: '#/components/schemas/ErrorInformation'
622
+ required:
623
+ - partyId
624
+ Currency:
625
+ title: Currency
626
+ 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.
627
+ type: string
628
+ minLength: 3
629
+ maxLength: 3
630
+ enum:
631
+ - AED
632
+ - AFN
633
+ - ALL
634
+ - AMD
635
+ - ANG
636
+ - AOA
637
+ - ARS
638
+ - AUD
639
+ - AWG
640
+ - AZN
641
+ - BAM
642
+ - BBD
643
+ - BDT
644
+ - BGN
645
+ - BHD
646
+ - BIF
647
+ - BMD
648
+ - BND
649
+ - BOB
650
+ - BRL
651
+ - BSD
652
+ - BTN
653
+ - BWP
654
+ - BYN
655
+ - BZD
656
+ - CAD
657
+ - CDF
658
+ - CHF
659
+ - CLP
660
+ - CNY
661
+ - COP
662
+ - CRC
663
+ - CUC
664
+ - CUP
665
+ - CVE
666
+ - CZK
667
+ - DJF
668
+ - DKK
669
+ - DOP
670
+ - DZD
671
+ - EGP
672
+ - ERN
673
+ - ETB
674
+ - EUR
675
+ - FJD
676
+ - FKP
677
+ - GBP
678
+ - GEL
679
+ - GGP
680
+ - GHS
681
+ - GIP
682
+ - GMD
683
+ - GNF
684
+ - GTQ
685
+ - GYD
686
+ - HKD
687
+ - HNL
688
+ - HRK
689
+ - HTG
690
+ - HUF
691
+ - IDR
692
+ - ILS
693
+ - IMP
694
+ - INR
695
+ - IQD
696
+ - IRR
697
+ - ISK
698
+ - JEP
699
+ - JMD
700
+ - JOD
701
+ - JPY
702
+ - KES
703
+ - KGS
704
+ - KHR
705
+ - KMF
706
+ - KPW
707
+ - KRW
708
+ - KWD
709
+ - KYD
710
+ - KZT
711
+ - LAK
712
+ - LBP
713
+ - LKR
714
+ - LRD
715
+ - LSL
716
+ - LYD
717
+ - MAD
718
+ - MDL
719
+ - MGA
720
+ - MKD
721
+ - MMK
722
+ - MNT
723
+ - MOP
724
+ - MRO
725
+ - MUR
726
+ - MVR
727
+ - MWK
728
+ - MXN
729
+ - MYR
730
+ - MZN
731
+ - NAD
732
+ - NGN
733
+ - NIO
734
+ - NOK
735
+ - NPR
736
+ - NZD
737
+ - OMR
738
+ - PAB
739
+ - PEN
740
+ - PGK
741
+ - PHP
742
+ - PKR
743
+ - PLN
744
+ - PYG
745
+ - QAR
746
+ - RON
747
+ - RSD
748
+ - RUB
749
+ - RWF
750
+ - SAR
751
+ - SBD
752
+ - SCR
753
+ - SDG
754
+ - SEK
755
+ - SGD
756
+ - SHP
757
+ - SLL
758
+ - SOS
759
+ - SPL
760
+ - SRD
761
+ - STD
762
+ - SVC
763
+ - SYP
764
+ - SZL
765
+ - THB
766
+ - TJS
767
+ - TMT
768
+ - TND
769
+ - TOP
770
+ - TRY
771
+ - TTD
772
+ - TVD
773
+ - TWD
774
+ - TZS
775
+ - UAH
776
+ - UGX
777
+ - USD
778
+ - UYU
779
+ - UZS
780
+ - VEF
781
+ - VND
782
+ - VUV
783
+ - WST
784
+ - XAF
785
+ - XCD
786
+ - XDR
787
+ - XOF
788
+ - XPF
789
+ - XTS
790
+ - XXX
791
+ - YER
792
+ - ZAR
793
+ - ZMW
794
+ - ZWD
795
+ ParticipantsIDPutResponse:
796
+ title: ParticipantsIDPutResponse
797
+ type: object
798
+ description: The object sent in the PUT /participants/{ID} callback.
799
+ properties:
800
+ partyList:
801
+ type: array
802
+ items:
803
+ $ref: '#/components/schemas/PartyResult'
804
+ minItems: 1
805
+ maxItems: 10000
806
+ description: List of PartyResult elements that were either created or failed to be created.
807
+ currency:
808
+ $ref: '#/components/schemas/Currency'
809
+ required:
810
+ - partyList
811
+ MerchantClassificationCode:
812
+ title: MerchantClassificationCode
813
+ type: string
814
+ pattern: ^[\d]{1,4}$
815
+ description: A limited set of pre-defined numbers. This list would be a limited set of numbers identifying a set of popular merchant types like School Fees, Pubs and Restaurants, Groceries, etc.
816
+ PartyName:
817
+ title: PartyName
818
+ type: string
819
+ minLength: 1
820
+ maxLength: 128
821
+ description: Name of the Party. Could be a real name or a nickname.
822
+ FirstName:
823
+ title: FirstName
824
+ type: string
825
+ minLength: 1
826
+ maxLength: 128
827
+ pattern: ^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control} .,''-]{1,128}$
828
+ description: First name of the Party (Name Type).
829
+ example: Henrik
830
+ MiddleName:
831
+ title: MiddleName
832
+ type: string
833
+ minLength: 1
834
+ maxLength: 128
835
+ pattern: ^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control} .,''-]{1,128}$
836
+ description: Middle name of the Party (Name Type).
837
+ example: Johannes
838
+ LastName:
839
+ title: LastName
840
+ type: string
841
+ minLength: 1
842
+ maxLength: 128
843
+ pattern: ^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control} .,''-]{1,128}$
844
+ description: Last name of the Party (Name Type).
845
+ example: Karlsson
846
+ PartyComplexName:
847
+ title: PartyComplexName
848
+ type: object
849
+ additionalProperties: false
850
+ description: Data model for the complex type PartyComplexName.
851
+ properties:
852
+ firstName:
853
+ $ref: '#/components/schemas/FirstName'
854
+ middleName:
855
+ $ref: '#/components/schemas/MiddleName'
856
+ lastName:
857
+ $ref: '#/components/schemas/LastName'
858
+ DateOfBirth:
859
+ title: DateofBirth (type Date)
860
+ type: string
861
+ pattern: ^(?:[1-9]\d{3}-(?:(?:0[1-9]|1[0-2])-(?:0[1-9]|1\d|2[0-8])|(?:0[13-9]|1[0-2])-(?:29|30)|(?:0[13578]|1[02])-31)|(?:[1-9]\d(?:0[48]|[2468][048]|[13579][26])|(?:[2468][048]|[13579][26])00)-02-29)$
862
+ description: Date of Birth of the Party.
863
+ example: '1966-06-16'
864
+ KYCInformation:
865
+ title: KYCInformation
866
+ type: string
867
+ minLength: 1
868
+ maxLength: 2048
869
+ description: KYC information for the party in a form mandated by an individual scheme.
870
+ example: |-
871
+ {
872
+ "metadata": {
873
+ "format": "JSON",
874
+ "version": "1.0",
875
+ "description": "Data containing KYC Information"
876
+ },
877
+ "data": {
878
+ "name": "John Doe",
879
+ "dob": "1980-05-15",
880
+ "gender": "Male",
881
+ "address": "123 Main Street, Anytown, USA",
882
+ "email": "johndoe@example.com",
883
+ "phone": "+1 555-123-4567",
884
+ "nationality": "US",
885
+ "passport_number": "AB1234567",
886
+ "issue_date": "2010-02-20",
887
+ "expiry_date": "2025-02-20",
888
+ "bank_account_number": "1234567890",
889
+ "bank_name": "Example Bank",
890
+ "employer": "ABC Company",
891
+ "occupation": "Software Engineer",
892
+ "income": "$80,000 per year",
893
+ "marital_status": "Single",
894
+ "dependents": 0,
895
+ "risk_level": "Low"
896
+ }
897
+ }
898
+ PartyPersonalInfo:
899
+ title: PartyPersonalInfo
900
+ type: object
901
+ additionalProperties: false
902
+ description: Data model for the complex type PartyPersonalInfo.
903
+ properties:
904
+ complexName:
905
+ $ref: '#/components/schemas/PartyComplexName'
906
+ dateOfBirth:
907
+ $ref: '#/components/schemas/DateOfBirth'
908
+ kycInformation:
909
+ $ref: '#/components/schemas/KYCInformation'
910
+ Party:
911
+ title: Party
912
+ type: object
913
+ description: Data model for the complex type Party.
914
+ properties:
915
+ partyIdInfo:
916
+ $ref: '#/components/schemas/PartyIdInfo'
917
+ merchantClassificationCode:
918
+ $ref: '#/components/schemas/MerchantClassificationCode'
919
+ name:
920
+ $ref: '#/components/schemas/PartyName'
921
+ personalInfo:
922
+ $ref: '#/components/schemas/PartyPersonalInfo'
923
+ required:
924
+ - partyIdInfo
925
+ PartiesTypeIDPutResponse:
926
+ title: PartiesTypeIDPutResponse
927
+ type: object
928
+ description: |
929
+ The object sent in the PUT /parties/{Type}/{ID} callback.
930
+
931
+ This is a variant based on FSPIOP `PartiesTypeIDPutResponse` specification.
932
+ Main difference being that it returns a `Party` with the newly added
933
+ `accounts` property.
934
+ properties:
935
+ party:
936
+ $ref: '#/components/schemas/Party'
937
+ required:
938
+ - party
939
+ Amount:
940
+ title: Amount
941
+ type: string
942
+ pattern: ^([0]|([1-9][0-9]{0,17}))([.][0-9]{0,3}[1-9])?$
943
+ description: The API data type Amount is a JSON String in a canonical format that is restricted by a regular expression for interoperability reasons. This pattern does not allow any trailing zeroes at all, but allows an amount without a minor currency unit. It also only allows four digits in the minor currency unit; a negative value is not allowed. Using more than 18 digits in the major currency unit is not allowed.
944
+ example: '123.45'
945
+ Money:
946
+ title: Money
947
+ type: object
948
+ additionalProperties: false
949
+ description: Data model for the complex type Money.
950
+ properties:
951
+ currency:
952
+ $ref: '#/components/schemas/Currency'
953
+ amount:
954
+ $ref: '#/components/schemas/Amount'
955
+ required:
956
+ - currency
957
+ - amount
958
+ DateTime:
959
+ title: DateTime
960
+ type: string
961
+ pattern: ^(?:[1-9]\d{3}-(?:(?:0[1-9]|1[0-2])-(?:0[1-9]|1\d|2[0-8])|(?:0[13-9]|1[0-2])-(?:29|30)|(?:0[13578]|1[02])-31)|(?:[1-9]\d(?:0[48]|[2468][048]|[13579][26])|(?:[2468][048]|[13579][26])00)-02-29)T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:(\.\d{3}))(?:Z|[+-][01]\d:[0-5]\d)$
962
+ 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).
963
+ example: '2016-05-24T08:38:08.699-04:00'
964
+ Latitude:
965
+ title: Latitude
966
+ type: string
967
+ pattern: ^(\+|-)?(?:90(?:(?:\.0{1,6})?)|(?:[0-9]|[1-8][0-9])(?:(?:\.[0-9]{1,6})?))$
968
+ description: The API data type Latitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
969
+ example: '+45.4215'
970
+ Longitude:
971
+ title: Longitude
972
+ type: string
973
+ pattern: ^(\+|-)?(?:180(?:(?:\.0{1,6})?)|(?:[0-9]|[1-9][0-9]|1[0-7][0-9])(?:(?:\.[0-9]{1,6})?))$
974
+ description: The API data type Longitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
975
+ example: '+75.6972'
976
+ GeoCode:
977
+ title: GeoCode
978
+ type: object
979
+ additionalProperties: false
980
+ description: Data model for the complex type GeoCode. Indicates the geographic location from where the transaction was initiated.
981
+ properties:
982
+ latitude:
983
+ $ref: '#/components/schemas/Latitude'
984
+ longitude:
985
+ $ref: '#/components/schemas/Longitude'
986
+ required:
987
+ - latitude
988
+ - longitude
989
+ IlpPacket:
990
+ title: IlpPacket
991
+ type: string
992
+ pattern: ^[A-Za-z0-9-_]+[=]{0,2}$
993
+ minLength: 1
994
+ maxLength: 32768
995
+ description: Information for recipient (transport layer information).
996
+ example: AYIBgQAAAAAAAASwNGxldmVsb25lLmRmc3AxLm1lci45T2RTOF81MDdqUUZERmZlakgyOVc4bXFmNEpLMHlGTFGCAUBQU0svMS4wCk5vbmNlOiB1SXlweUYzY3pYSXBFdzVVc05TYWh3CkVuY3J5cHRpb246IG5vbmUKUGF5bWVudC1JZDogMTMyMzZhM2ItOGZhOC00MTYzLTg0NDctNGMzZWQzZGE5OGE3CgpDb250ZW50LUxlbmd0aDogMTM1CkNvbnRlbnQtVHlwZTogYXBwbGljYXRpb24vanNvbgpTZW5kZXItSWRlbnRpZmllcjogOTI4MDYzOTEKCiJ7XCJmZWVcIjowLFwidHJhbnNmZXJDb2RlXCI6XCJpbnZvaWNlXCIsXCJkZWJpdE5hbWVcIjpcImFsaWNlIGNvb3BlclwiLFwiY3JlZGl0TmFtZVwiOlwibWVyIGNoYW50XCIsXCJkZWJpdElkZW50aWZpZXJcIjpcIjkyODA2MzkxXCJ9IgA
997
+ IlpCondition:
998
+ title: IlpCondition
999
+ type: string
1000
+ pattern: ^[A-Za-z0-9-_]{43}$
1001
+ maxLength: 48
1002
+ description: Condition that must be attached to the transfer by the Payer.
1003
+ QuotesIDPutResponse:
1004
+ title: QuotesIDPutResponse
1005
+ type: object
1006
+ additionalProperties: false
1007
+ description: The object sent in the PUT /quotes/{ID} callback.
1008
+ properties:
1009
+ transferAmount:
1010
+ $ref: '#/components/schemas/Money'
1011
+ payeeReceiveAmount:
1012
+ $ref: '#/components/schemas/Money'
1013
+ payeeFspFee:
1014
+ $ref: '#/components/schemas/Money'
1015
+ payeeFspCommission:
1016
+ $ref: '#/components/schemas/Money'
1017
+ expiration:
1018
+ $ref: '#/components/schemas/DateTime'
1019
+ geoCode:
1020
+ $ref: '#/components/schemas/GeoCode'
1021
+ ilpPacket:
1022
+ $ref: '#/components/schemas/IlpPacket'
1023
+ condition:
1024
+ $ref: '#/components/schemas/IlpCondition'
1025
+ extensionList:
1026
+ $ref: '#/components/schemas/ExtensionList'
1027
+ required:
1028
+ - transferAmount
1029
+ - expiration
1030
+ - ilpPacket
1031
+ - condition
1032
+ AuthorizationResponseType:
1033
+ title: AuthorizationResponseType
1034
+ description: |
1035
+ Enum containing authorization response information; if the customer
1036
+ accepted the terms of the transfer, or rejected the terms.
1037
+ type: string
1038
+ enum:
1039
+ - ACCEPTED
1040
+ - REJECTED
1041
+ ConsentStatusIssued:
1042
+ title: ConsentStatusIssued
1043
+ type: string
1044
+ enum:
1045
+ - ISSUED
1046
+ description: |-
1047
+ Allowed values for the enumeration ConsentStatus
1048
+ - ISSUED - The consent has been issued by the DFSP
1049
+ IlpFulfilment:
1050
+ title: IlpFulfilment
1051
+ type: string
1052
+ pattern: ^[A-Za-z0-9-_]{43}$
1053
+ maxLength: 48
1054
+ description: Fulfilment that must be attached to the transfer by the Payee.
1055
+ example: WLctttbu2HvTsa1XWvUoGRcQozHsqeu9Ahl2JW9Bsu8
1056
+ Integer:
1057
+ title: Integer
1058
+ type: string
1059
+ pattern: ^[1-9]\d*$
1060
+ description: The API data type Integer is a JSON String consisting of digits only. Negative numbers and leading zeroes are not allowed. The data type is always limited to a specific number of digits.
1061
+ Note:
1062
+ title: Note
1063
+ type: string
1064
+ minLength: 1
1065
+ maxLength: 128
1066
+ description: Memo assigned to transaction.
1067
+ example: Note sent to Payee.
1068
+ PartyIdTypeTPLink:
1069
+ title: PartyIdTypeTPLink
1070
+ type: string
1071
+ enum:
1072
+ - THIRD_PARTY_LINK
1073
+ description: |
1074
+ - THIRD_PARTY_LINK - is the DFSP's internal reference which allows DFSP to find out the corresponding consent
1075
+ example: PERSONAL_ID
1076
+ PartyIdInfoTPLink:
1077
+ title: PartyIdInfo
1078
+ type: object
1079
+ description: Data model for the complex type PartyIdInfo.
1080
+ properties:
1081
+ partyIdType:
1082
+ $ref: '#/components/schemas/PartyIdTypeTPLink'
1083
+ partyIdentifier:
1084
+ $ref: '#/components/schemas/PartyIdentifier'
1085
+ partySubIdOrType:
1086
+ $ref: '#/components/schemas/PartySubIdOrType'
1087
+ fspId:
1088
+ $ref: '#/components/schemas/FspId'
1089
+ extensionList:
1090
+ $ref: '#/components/schemas/ExtensionList'
1091
+ required:
1092
+ - partyIdType
1093
+ - partyIdentifier
1094
+ ServiceType:
1095
+ title: ServiceType
1096
+ type: string
1097
+ description: |-
1098
+ The ServiceType enumeration describes the types of role for which a DFSP may query using the /services resource.
1099
+ Below are the allowed values for the enumeration ServiceType - THIRD_PARTY_DFSP - Enum used to query for DFSPs that have thirdparty features enabled. - PISP - Enum used to query for PISPs. - AUTH_SERVICE - Participants which provide Authentication Services.
1100
+ https://github.com/mojaloop/documentation/blob/main/website/versioned_docs/v2.0.0/api/thirdparty/data-models.md#3229-servicetype
1101
+ enum:
1102
+ - THIRD_PARTY_DFSP
1103
+ - PISP
1104
+ - AUTH_SERVICE
1105
+ CorrelationId:
1106
+ title: CorrelationId
1107
+ type: string
1108
+ pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$|^[0-9A-HJKMNP-TV-Z]{26}$
1109
+ description: Identifier that correlates all messages of the same sequence. The supported identifiers formats are for lowercase [UUID](https://datatracker.ietf.org/doc/html/rfc9562) and uppercase [ULID](https://github.com/ulid/spec)
1110
+ example: b51ec534-ee48-4575-b6a9-ead2955b8069
1111
+ ParticipantsPostRequest:
1112
+ title: ParticipantsPostRequest
1113
+ type: object
1114
+ description: The object sent in the POST /participants request.
1115
+ properties:
1116
+ requestId:
1117
+ $ref: '#/components/schemas/CorrelationId'
1118
+ partyList:
1119
+ type: array
1120
+ items:
1121
+ $ref: '#/components/schemas/PartyIdInfo'
1122
+ minItems: 1
1123
+ maxItems: 10000
1124
+ description: |
1125
+ List of PartyIdInfo elements that the client would like to update
1126
+ or create FSP information about.
1127
+ currency:
1128
+ $ref: '#/components/schemas/Currency'
1129
+ required:
1130
+ - requestId
1131
+ - partyList
1132
+ AmountType:
1133
+ title: AmountType
1134
+ type: string
1135
+ enum:
1136
+ - SEND
1137
+ - RECEIVE
1138
+ description: |-
1139
+ Below are the allowed values for the enumeration AmountType.
1140
+ - SEND - Amount the Payer would like to send, that is, the amount that should be withdrawn from the Payer account including any fees.
1141
+ - RECEIVE - Amount the Payer would like the Payee to receive, that is, the amount that should be sent to the receiver exclusive of any fees.
1142
+ example: RECEIVE
1143
+ TransactionScenario:
1144
+ title: TransactionScenario
1145
+ type: string
1146
+ enum:
1147
+ - DEPOSIT
1148
+ - WITHDRAWAL
1149
+ - TRANSFER
1150
+ - PAYMENT
1151
+ - REFUND
1152
+ description: |-
1153
+ Below are the allowed values for the enumeration.
1154
+ - DEPOSIT - Used for performing a Cash-In (deposit) transaction. In a normal scenario, electronic funds are transferred from a Business account to a Consumer account, and physical cash is given from the Consumer to the Business User.
1155
+ - WITHDRAWAL - Used for performing a Cash-Out (withdrawal) transaction. In a normal scenario, electronic funds are transferred from a Consumer’s account to a Business account, and physical cash is given from the Business User to the Consumer.
1156
+ - TRANSFER - Used for performing a P2P (Peer to Peer, or Consumer to Consumer) transaction.
1157
+ - PAYMENT - Usually used for performing a transaction from a Consumer to a Merchant or Organization, but could also be for a B2B (Business to Business) payment. The transaction could be online for a purchase in an Internet store, in a physical store where both the Consumer and Business User are present, a bill payment, a donation, and so on.
1158
+ - REFUND - Used for performing a refund of transaction.
1159
+ example: DEPOSIT
1160
+ TransactionSubScenario:
1161
+ title: TransactionSubScenario
1162
+ type: string
1163
+ pattern: ^[A-Z_]{1,32}$
1164
+ description: Possible sub-scenario, defined locally within the scheme (UndefinedEnum Type).
1165
+ example: LOCALLY_DEFINED_SUBSCENARIO
1166
+ TransactionInitiator:
1167
+ title: TransactionInitiator
1168
+ type: string
1169
+ enum:
1170
+ - PAYER
1171
+ - PAYEE
1172
+ description: |-
1173
+ Below are the allowed values for the enumeration.
1174
+ - PAYER - Sender of funds is initiating the transaction. The account to send from is either owned by the Payer or is connected to the Payer in some way.
1175
+ - PAYEE - Recipient of the funds is initiating the transaction by sending a transaction request. The Payer must approve the transaction, either automatically by a pre-generated OTP or by pre-approval of the Payee, or by manually approving in his or her own Device.
1176
+ example: PAYEE
1177
+ TransactionInitiatorType:
1178
+ title: TransactionInitiatorType
1179
+ type: string
1180
+ enum:
1181
+ - CONSUMER
1182
+ - AGENT
1183
+ - BUSINESS
1184
+ - DEVICE
1185
+ description: |-
1186
+ Below are the allowed values for the enumeration.
1187
+ - CONSUMER - Consumer is the initiator of the transaction.
1188
+ - AGENT - Agent is the initiator of the transaction.
1189
+ - BUSINESS - Business is the initiator of the transaction.
1190
+ - DEVICE - Device is the initiator of the transaction.
1191
+ example: CONSUMER
1192
+ RefundReason:
1193
+ title: RefundReason
1194
+ type: string
1195
+ minLength: 1
1196
+ maxLength: 128
1197
+ description: Reason for the refund.
1198
+ example: Free text indicating reason for the refund.
1199
+ Refund:
1200
+ title: Refund
1201
+ type: object
1202
+ additionalProperties: false
1203
+ description: Data model for the complex type Refund.
1204
+ properties:
1205
+ originalTransactionId:
1206
+ $ref: '#/components/schemas/CorrelationId'
1207
+ refundReason:
1208
+ $ref: '#/components/schemas/RefundReason'
1209
+ required:
1210
+ - originalTransactionId
1211
+ BalanceOfPayments:
1212
+ title: BalanceOfPayments
1213
+ type: string
1214
+ pattern: ^[1-9]\d{2}$
1215
+ description: (BopCode) The API data type [BopCode](https://www.imf.org/external/np/sta/bopcode/) is a JSON String of 3 characters, consisting of digits only. Negative numbers are not allowed. A leading zero is not allowed.
1216
+ example: '123'
1217
+ TransactionType:
1218
+ title: TransactionType
1219
+ type: object
1220
+ additionalProperties: false
1221
+ description: Data model for the complex type TransactionType.
1222
+ properties:
1223
+ scenario:
1224
+ $ref: '#/components/schemas/TransactionScenario'
1225
+ subScenario:
1226
+ $ref: '#/components/schemas/TransactionSubScenario'
1227
+ initiator:
1228
+ $ref: '#/components/schemas/TransactionInitiator'
1229
+ initiatorType:
1230
+ $ref: '#/components/schemas/TransactionInitiatorType'
1231
+ refundInfo:
1232
+ $ref: '#/components/schemas/Refund'
1233
+ balanceOfPayments:
1234
+ $ref: '#/components/schemas/BalanceOfPayments'
1235
+ required:
1236
+ - scenario
1237
+ - initiator
1238
+ - initiatorType
1239
+ QuotesPostRequest:
1240
+ title: QuotesPostRequest
1241
+ type: object
1242
+ description: The object sent in the POST /quotes request.
1243
+ properties:
1244
+ quoteId:
1245
+ $ref: '#/components/schemas/CorrelationId'
1246
+ description: Common ID between the FSPs for the quote object, decided by the Payer FSP. The ID should be reused for resends of the same quote for a transaction. A new ID should be generated for each new quote for a transaction.
1247
+ example: b51ec534-ee48-4575-b6a9-ead2955b8069
1248
+ transactionId:
1249
+ $ref: '#/components/schemas/CorrelationId'
1250
+ description: Common ID (decided by the Payer FSP) between the FSPs for the future transaction object. The actual transaction will be created as part of a successful transfer process. The ID should be reused for resends of the same quote for a transaction. A new ID should be generated for each new quote for a transaction.
1251
+ example: a8323bc6-c228-4df2-ae82-e5a997baf899
1252
+ transactionRequestId:
1253
+ $ref: '#/components/schemas/CorrelationId'
1254
+ description: Identifies an optional previously-sent transaction request.
1255
+ example: a8323bc6-c228-4df2-ae82-e5a997baf890
1256
+ payee:
1257
+ $ref: '#/components/schemas/Party'
1258
+ description: Information about the Payee in the proposed financial transaction.
1259
+ payer:
1260
+ $ref: '#/components/schemas/Party'
1261
+ description: Information about the Payer in the proposed financial transaction.
1262
+ amountType:
1263
+ $ref: '#/components/schemas/AmountType'
1264
+ description: SEND for send amount, RECEIVE for receive amount.
1265
+ example: SEND
1266
+ amount:
1267
+ $ref: '#/components/schemas/Money'
1268
+ description: Depending on amountType - If SEND - The amount the Payer would like to send, that is, the amount that should be withdrawn from the Payer account including any fees. The amount is updated by each participating entity in the transaction. If RECEIVE - The amount the Payee should receive, that is, the amount that should be sent to the receiver exclusive any fees. The amount is not updated by any of the participating entities.
1269
+ fees:
1270
+ $ref: '#/components/schemas/Money'
1271
+ description: The fees in the transaction. The fees element should be empty if fees should be non-disclosed. The fees element should be non-empty if fees should be disclosed.
1272
+ transactionType:
1273
+ $ref: '#/components/schemas/TransactionType'
1274
+ description: Type of transaction for which the quote is requested.
1275
+ geoCode:
1276
+ $ref: '#/components/schemas/GeoCode'
1277
+ description: Longitude and Latitude of the initiating Party. Can be used to detect fraud.
1278
+ note:
1279
+ $ref: '#/components/schemas/Note'
1280
+ description: A memo that will be attached to the transaction.
1281
+ example: Free-text memo.
1282
+ expiration:
1283
+ $ref: '#/components/schemas/DateTime'
1284
+ description: Expiration is optional. It can be set to get a quick failure in case the peer FSP takes too long to respond. Also, it may be beneficial for Consumer, Agent, and Merchant to know that their request has a time limit.
1285
+ example: '2016-05-24T08:38:08.699-04:00'
1286
+ extensionList:
1287
+ $ref: '#/components/schemas/ExtensionList'
1288
+ description: Optional extension, specific to deployment.
1289
+ required:
1290
+ - quoteId
1291
+ - transactionId
1292
+ - payee
1293
+ - payer
1294
+ - amountType
1295
+ - amount
1296
+ - transactionType
1297
+ ErrorInformationResponse:
1298
+ title: ErrorInformationResponse
1299
+ type: object
1300
+ additionalProperties: false
1301
+ description: Data model for the complex type object that contains an optional element ErrorInformation used along with 4xx and 5xx responses.
1302
+ properties:
1303
+ errorInformation:
1304
+ $ref: '#/components/schemas/ErrorInformation'
1305
+ tppTransactionRequestPostRequest:
1306
+ title: tppTransactionRequestPostRequest
1307
+ type: object
1308
+ description: |-
1309
+ Used by: PISP
1310
+ The HTTP request POST /tppTransationRequest is used to request the creation of a transaction request on the server for the transfer described in the request.
1311
+ Callback and data model information for POST /tppTransationRequest:
1312
+ Callback - PUT /tppTransationRequest/{ID} Error Callback - PUT /tppTransationRequest/{ID}/error
1313
+ properties:
1314
+ transactionRequestId:
1315
+ allOf:
1316
+ - $ref: '#/components/schemas/CorrelationId'
1317
+ description: |
1318
+ 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.
1319
+ payee:
1320
+ allOf:
1321
+ - $ref: '#/components/schemas/Party'
1322
+ description: Information about the Payee in the proposed financial transaction.
1323
+ payer:
1324
+ allOf:
1325
+ - $ref: '#/components/schemas/PartyIdInfo'
1326
+ description: Information about the Payer in the proposed financial transaction.
1327
+ amountType:
1328
+ allOf:
1329
+ - $ref: '#/components/schemas/AmountType'
1330
+ description: SEND for sendAmount, RECEIVE for receiveAmount.
1331
+ amount:
1332
+ allOf:
1333
+ - $ref: '#/components/schemas/Money'
1334
+ description: Requested amount to be transferred from the Payer to Payee.
1335
+ transactionType:
1336
+ allOf:
1337
+ - $ref: '#/components/schemas/TransactionType'
1338
+ description: Type of transaction.
1339
+ note:
1340
+ type: string
1341
+ minLength: 1
1342
+ maxLength: 256
1343
+ description: A memo that will be attached to the transaction.
1344
+ expiration:
1345
+ type: string
1346
+ description: |
1347
+ 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.
1348
+ example: '2016-05-24T08:38:08.699-04:00'
1349
+ extensionList:
1350
+ $ref: '#/components/schemas/ExtensionList'
1351
+ required:
1352
+ - transactionRequestId
1353
+ - payee
1354
+ - payer
1355
+ - amountType
1356
+ - amount
1357
+ - transactionType
1358
+ - expiration
1359
+ tppTransactionRequestPutResponse:
1360
+ title: tppAuthorizationsPostRequest
1361
+ description: |-
1362
+ Used by: DFSP
1363
+ The HTTP request PUT /tppTransactionRequests/<ID> resource will have the following content. The <ID> in the request should match the transactionRequestId which was given when the transaction request was created.
1364
+ It is used to return the: 1. status of the customer information for validation. 2. the status of that agreement of terms for the transfer 3. a challenge that the PISP's client is to sign if the terms are agreed to and the transaction is to be authorized.
1365
+ type: object
1366
+ properties:
1367
+ transactionRequestId:
1368
+ $ref: '#/components/schemas/CorrelationId'
1369
+ challenge:
1370
+ type: string
1371
+ description: The challenge that the PISP's client is to sign
1372
+ transactionId:
1373
+ $ref: '#/components/schemas/CorrelationId'
1374
+ description: The unique identifier for the proposed transaction. It is set by the payer DFSP and signed by the payee DFSP as part of the terms of the transfer
1375
+ transferAmount:
1376
+ allOf:
1377
+ - $ref: '#/components/schemas/Money'
1378
+ description: The amount that will be debited from the sending customer's account as a consequence of the transaction.
1379
+ payeeReceiveAmount:
1380
+ allOf:
1381
+ - $ref: '#/components/schemas/Money'
1382
+ description: The amount that will be credited to the receiving customer's account as a consequence of the transaction.
1383
+ fees:
1384
+ allOf:
1385
+ - $ref: '#/components/schemas/Money'
1386
+ description: The amount of fees that the paying customer will be charged as part of the transaction.
1387
+ payer:
1388
+ allOf:
1389
+ - $ref: '#/components/schemas/PartyIdInfo'
1390
+ description: Information about the Payer type, id, sub-type/id, FSP Id in the proposed financial transaction.
1391
+ payee:
1392
+ allOf:
1393
+ - $ref: '#/components/schemas/Party'
1394
+ description: Information about the Payee in the proposed financial transaction.
1395
+ transactionType:
1396
+ $ref: '#/components/schemas/TransactionType'
1397
+ expiration:
1398
+ allOf:
1399
+ - $ref: '#/components/schemas/DateTime'
1400
+ description: The time by which the transfer must be completed, set by the payee DFSP.
1401
+ extensionList:
1402
+ $ref: '#/components/schemas/ExtensionList'
1403
+ required:
1404
+ - transactionRequestId
1405
+ - transactionId
1406
+ - challenge
1407
+ - transferAmount
1408
+ - payeeReceiveAmount
1409
+ - fees
1410
+ - payer
1411
+ - payee
1412
+ - transactionType
1413
+ - expiration
1414
+ additionalProperties: false
1415
+ ErrorInformationObject:
1416
+ title: ErrorInformationObject
1417
+ type: object
1418
+ additionalProperties: false
1419
+ description: Data model for the complex type object that contains ErrorInformation.
1420
+ properties:
1421
+ errorInformation:
1422
+ $ref: '#/components/schemas/ErrorInformation'
1423
+ required:
1424
+ - errorInformation
1425
+ AuthorizationResponseTypeAccepted:
1426
+ title: AuthorizationResponseType
1427
+ description: |
1428
+ The customer accepted the terms of the transfer
1429
+ type: string
1430
+ enum:
1431
+ - ACCEPTED
1432
+ SignedPayloadTypeGeneric:
1433
+ title: SignedPayloadTypeGeneric
1434
+ type: string
1435
+ enum:
1436
+ - GENERIC
1437
+ description: Describes a challenge that has been signed with a private key
1438
+ BinaryString:
1439
+ type: string
1440
+ pattern: ^[A-Za-z0-9-_]+[=]{0,2}$
1441
+ 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.
1442
+ SignedPayloadGeneric:
1443
+ title: SignedPayloadGeneric
1444
+ type: object
1445
+ properties:
1446
+ signedPayloadType:
1447
+ $ref: '#/components/schemas/SignedPayloadTypeGeneric'
1448
+ genericSignedPayload:
1449
+ $ref: '#/components/schemas/BinaryString'
1450
+ required:
1451
+ - signedPayloadType
1452
+ - genericSignedPayload
1453
+ additionalProperties: false
1454
+ TransfersPostRequestGeneric:
1455
+ title: TransfersPostRequestGeneric
1456
+ type: object
1457
+ description: The object sent in the PUT /tppAuthorizations/{ID} callback.
1458
+ properties:
1459
+ responseType:
1460
+ $ref: '#/components/schemas/AuthorizationResponseTypeAccepted'
1461
+ signedPayload:
1462
+ $ref: '#/components/schemas/SignedPayloadGeneric'
1463
+ extensionList:
1464
+ $ref: '#/components/schemas/ExtensionList'
1465
+ required:
1466
+ - responseType
1467
+ - signedPayload
1468
+ additionalProperties: false
1469
+ SignedPayloadTypeFIDO:
1470
+ title: SignedPayloadTypeFIDO
1471
+ type: string
1472
+ enum:
1473
+ - FIDO
1474
+ description: Describes a challenge that has been signed with FIDO Attestation flows
1475
+ FIDOPublicKeyCredentialAssertion:
1476
+ title: FIDOPublicKeyCredentialAssertion
1477
+ type: object
1478
+ description: |
1479
+ A data model representing a FIDO Assertion result.
1480
+ Derived from PublicKeyCredential Interface in WebAuthN.
1481
+
1482
+ The PublicKeyCredential interface represents the below fields with a Type of
1483
+ Javascript ArrayBuffer.
1484
+ For this API, we represent ArrayBuffers as base64 encoded utf-8 strings.
1485
+
1486
+ https://github.com/mojaloop/documentation/blob/main/website/versioned_docs/v2.0.0/api/thirdparty/data-models.md#32128-fidopublickeycredentialassertion
1487
+ properties:
1488
+ id:
1489
+ type: string
1490
+ description: |
1491
+ credential id: identifier of pair of keys, base64 encoded
1492
+ https://w3c.github.io/webauthn/#ref-for-dom-credential-id
1493
+ minLength: 20
1494
+ maxLength: 118
1495
+ rawId:
1496
+ type: string
1497
+ description: |
1498
+ raw credential id: identifier of pair of keys, base64 encoded.
1499
+ minLength: 20
1500
+ maxLength: 118
1501
+ response:
1502
+ type: object
1503
+ description: |
1504
+ AuthenticatorAssertionResponse
1505
+ properties:
1506
+ authenticatorData:
1507
+ type: string
1508
+ description: |
1509
+ Authenticator data object.
1510
+ minLength: 49
1511
+ maxLength: 256
1512
+ clientDataJSON:
1513
+ type: string
1514
+ description: |
1515
+ JSON string with client data.
1516
+ minLength: 121
1517
+ maxLength: 512
1518
+ signature:
1519
+ type: string
1520
+ description: |
1521
+ The signature generated by the private key associated with this credential.
1522
+ minLength: 59
1523
+ maxLength: 256
1524
+ userHandle:
1525
+ type: string
1526
+ description: |
1527
+ This field is optionally provided by the authenticator, and
1528
+ represents the user.id that was supplied during registration.
1529
+ minLength: 1
1530
+ maxLength: 88
1531
+ required:
1532
+ - authenticatorData
1533
+ - clientDataJSON
1534
+ - signature
1535
+ additionalProperties: false
1536
+ type:
1537
+ type: string
1538
+ description: response type, we need only the type of public-key
1539
+ enum:
1540
+ - public-key
1541
+ required:
1542
+ - id
1543
+ - rawId
1544
+ - response
1545
+ - type
1546
+ additionalProperties: false
1547
+ SignedPayloadFIDO:
1548
+ title: SignedPayloadFIDO
1549
+ type: object
1550
+ properties:
1551
+ signedPayloadType:
1552
+ $ref: '#/components/schemas/SignedPayloadTypeFIDO'
1553
+ fidoSignedPayload:
1554
+ $ref: '#/components/schemas/FIDOPublicKeyCredentialAssertion'
1555
+ required:
1556
+ - signedPayloadType
1557
+ - fidoSignedPayload
1558
+ additionalProperties: false
1559
+ TransfersPostRequestFIDO:
1560
+ title: TransfersPostRequestFIDO
1561
+ type: object
1562
+ description: The object sent in the PUT /tppAuthorizations/{ID} callback.
1563
+ properties:
1564
+ responseType:
1565
+ $ref: '#/components/schemas/AuthorizationResponseTypeAccepted'
1566
+ signedPayload:
1567
+ $ref: '#/components/schemas/SignedPayloadFIDO'
1568
+ extensionList:
1569
+ $ref: '#/components/schemas/ExtensionList'
1570
+ required:
1571
+ - responseType
1572
+ - signedPayload
1573
+ additionalProperties: false
1574
+ tppTransfersPostRequest:
1575
+ title: tppTransfersPostRequest
1576
+ type: object
1577
+ description: The object sent in the PUT /tppAuthorizations/{ID} callback.
1578
+ properties:
1579
+ executionRequestId:
1580
+ $ref: '#/components/schemas/CorrelationId'
1581
+ transactionRequestId:
1582
+ $ref: '#/components/schemas/CorrelationId'
1583
+ authenticationInfo:
1584
+ oneOf:
1585
+ - $ref: '#/components/schemas/TransfersPostRequestGeneric'
1586
+ - $ref: '#/components/schemas/TransfersPostRequestFIDO'
1587
+ extensionList:
1588
+ $ref: '#/components/schemas/ExtensionList'
1589
+ required:
1590
+ - executionRequestId
1591
+ - transactionRequestId
1592
+ - authenticationInfo
1593
+ additionalProperties: false
1594
+ TransactionState:
1595
+ title: TransactionState
1596
+ type: string
1597
+ enum:
1598
+ - RECEIVED
1599
+ - PENDING
1600
+ - COMPLETED
1601
+ - REJECTED
1602
+ description: |-
1603
+ Below are the allowed values for the enumeration.
1604
+ - RECEIVED - Payee FSP has received the transaction from the Payer FSP.
1605
+ - PENDING - Payee FSP has validated the transaction.
1606
+ - COMPLETED - Payee FSP has successfully performed the transaction.
1607
+ - REJECTED - Payee FSP has failed to perform the transaction.
1608
+ example: RECEIVED
1609
+ tppTransfersPutResponse:
1610
+ title: tppTransfersPutResponse
1611
+ type: object
1612
+ description: |-
1613
+ Used by: DFSP
1614
+ The issuing PISP will expect a response to their request for a transfer which describes the finalized state of the requested transfer.
1615
+ This response will be given by a PUT callback call on the /tppTransfers/{ID} resource.
1616
+ The {ID} given in the query string should be the executionRequestId which was originally used by the PISP to initiate the transaction.
1617
+ https://github.com/mojaloop/documentation/blob/main/website/versioned_docs/v2.0.0/api/thirdparty/data-models.md#31612-post-thirdpartyrequestsauthorizations
1618
+ properties:
1619
+ completedTimestamp:
1620
+ $ref: '#/components/schemas/DateTime'
1621
+ transactionState:
1622
+ $ref: '#/components/schemas/TransactionState'
1623
+ extensionList:
1624
+ $ref: '#/components/schemas/ExtensionList'
1625
+ required:
1626
+ - transactionRequestState
1627
+ - transactionState
1628
+ responses:
1629
+ '200':
1630
+ description: OK
1631
+ '202':
1632
+ description: Accepted
1633
+ '400':
1634
+ description: Bad Request
1635
+ content:
1636
+ application/json:
1637
+ schema:
1638
+ $ref: '#/components/schemas/ErrorInformationResponse'
1639
+ headers:
1640
+ Content-Length:
1641
+ $ref: '#/components/headers/Content-Length'
1642
+ Content-Type:
1643
+ $ref: '#/components/headers/Content-Type'
1644
+ '401':
1645
+ description: Unauthorized
1646
+ content:
1647
+ application/json:
1648
+ schema:
1649
+ $ref: '#/components/schemas/ErrorInformationResponse'
1650
+ headers:
1651
+ Content-Length:
1652
+ $ref: '#/components/headers/Content-Length'
1653
+ Content-Type:
1654
+ $ref: '#/components/headers/Content-Type'
1655
+ '403':
1656
+ description: Forbidden
1657
+ content:
1658
+ application/json:
1659
+ schema:
1660
+ $ref: '#/components/schemas/ErrorInformationResponse'
1661
+ headers:
1662
+ Content-Length:
1663
+ $ref: '#/components/headers/Content-Length'
1664
+ Content-Type:
1665
+ $ref: '#/components/headers/Content-Type'
1666
+ '404':
1667
+ description: Not Found
1668
+ content:
1669
+ application/json:
1670
+ schema:
1671
+ $ref: '#/components/schemas/ErrorInformationResponse'
1672
+ headers:
1673
+ Content-Length:
1674
+ $ref: '#/components/headers/Content-Length'
1675
+ Content-Type:
1676
+ $ref: '#/components/headers/Content-Type'
1677
+ '405':
1678
+ description: Method Not Allowed
1679
+ content:
1680
+ application/json:
1681
+ schema:
1682
+ $ref: '#/components/schemas/ErrorInformationResponse'
1683
+ headers:
1684
+ Content-Length:
1685
+ $ref: '#/components/headers/Content-Length'
1686
+ Content-Type:
1687
+ $ref: '#/components/headers/Content-Type'
1688
+ '406':
1689
+ description: Not Acceptable
1690
+ content:
1691
+ application/json:
1692
+ schema:
1693
+ $ref: '#/components/schemas/ErrorInformationResponse'
1694
+ headers:
1695
+ Content-Length:
1696
+ $ref: '#/components/headers/Content-Length'
1697
+ Content-Type:
1698
+ $ref: '#/components/headers/Content-Type'
1699
+ '501':
1700
+ description: Not Implemented
1701
+ content:
1702
+ application/json:
1703
+ schema:
1704
+ $ref: '#/components/schemas/ErrorInformationResponse'
1705
+ headers:
1706
+ Content-Length:
1707
+ $ref: '#/components/headers/Content-Length'
1708
+ Content-Type:
1709
+ $ref: '#/components/headers/Content-Type'
1710
+ '503':
1711
+ description: Service Unavailable
1712
+ content:
1713
+ application/json:
1714
+ schema:
1715
+ $ref: '#/components/schemas/ErrorInformationResponse'
1716
+ headers:
1717
+ Content-Length:
1718
+ $ref: '#/components/headers/Content-Length'
1719
+ Content-Type:
1720
+ $ref: '#/components/headers/Content-Type'
1721
+ headers:
1722
+ Content-Length:
1723
+ required: false
1724
+ schema:
1725
+ type: integer
1726
+ description: |-
1727
+ The `Content-Length` header field indicates the anticipated size of the payload body. Only sent if there is a body.
1728
+
1729
+ **Note:** The API supports a maximum size of 5242880 bytes (5 Megabytes).
1730
+ Content-Type:
1731
+ schema:
1732
+ type: string
1733
+ required: true
1734
+ description: The `Content-Type` header indicates the specific version of the API used to send the payload body.
1735
+ parameters:
1736
+ Content-Type:
1737
+ name: Content-Type
1738
+ in: header
1739
+ schema:
1740
+ type: string
1741
+ required: true
1742
+ description: The `Content-Type` header indicates the specific version of the API used to send the payload body.
1743
+ Date:
1744
+ name: Date
1745
+ in: header
1746
+ schema:
1747
+ type: string
1748
+ required: true
1749
+ description: The `Date` header field indicates the date when the request was sent.
1750
+ X-Forwarded-For:
1751
+ name: X-Forwarded-For
1752
+ in: header
1753
+ schema:
1754
+ type: string
1755
+ required: false
1756
+ description: |-
1757
+ The `X-Forwarded-For` header field is an unofficially accepted standard used for informational purposes of the originating client IP address, as a request might pass multiple proxies, firewalls, and so on. Multiple `X-Forwarded-For` values should be expected and supported by implementers of the API.
1758
+
1759
+ **Note:** An alternative to `X-Forwarded-For` is defined in [RFC 7239](https://tools.ietf.org/html/rfc7239). However, to this point RFC 7239 is less-used and supported than `X-Forwarded-For`.
1760
+ FSPIOP-Source:
1761
+ name: FSPIOP-Source
1762
+ in: header
1763
+ schema:
1764
+ type: string
1765
+ required: true
1766
+ description: The `FSPIOP-Source` header field is a non-HTTP standard field used by the API for identifying the sender of the HTTP request. The field should be set by the original sender of the request. Required for routing and signature verification (see header field `FSPIOP-Signature`).
1767
+ FSPIOP-Destination:
1768
+ name: FSPIOP-Destination
1769
+ in: header
1770
+ schema:
1771
+ type: string
1772
+ required: false
1773
+ description: The `FSPIOP-Destination` header field is a non-HTTP standard field used by the API for HTTP header based routing of requests and responses to the destination. The field must be set by the original sender of the request if the destination is known (valid for all services except GET /parties) so that any entities between the client and the server do not need to parse the payload for routing purposes. If the destination is not known (valid for service GET /parties), the field should be left empty.
1774
+ FSPIOP-Encryption:
1775
+ name: FSPIOP-Encryption
1776
+ in: header
1777
+ schema:
1778
+ type: string
1779
+ required: false
1780
+ description: The `FSPIOP-Encryption` header field is a non-HTTP standard field used by the API for applying end-to-end encryption of the request.
1781
+ FSPIOP-Signature:
1782
+ name: FSPIOP-Signature
1783
+ in: header
1784
+ schema:
1785
+ type: string
1786
+ required: false
1787
+ description: The `FSPIOP-Signature` header field is a non-HTTP standard field used by the API for applying an end-to-end request signature.
1788
+ FSPIOP-URI:
1789
+ name: FSPIOP-URI
1790
+ in: header
1791
+ schema:
1792
+ type: string
1793
+ required: false
1794
+ description: The `FSPIOP-URI` header field is a non-HTTP standard field used by the API for signature verification, should contain the service URI. Required if signature verification is used, for more information, see [the API Signature document](https://github.com/mojaloop/docs/tree/main/Specification%20Document%20Set).
1795
+ FSPIOP-HTTP-Method:
1796
+ name: FSPIOP-HTTP-Method
1797
+ in: header
1798
+ schema:
1799
+ type: string
1800
+ required: false
1801
+ description: The `FSPIOP-HTTP-Method` header field is a non-HTTP standard field used by the API for signature verification, should contain the service HTTP method. Required if signature verification is used, for more information, see [the API Signature document](https://github.com/mojaloop/docs/tree/main/Specification%20Document%20Set).
1802
+ Accept:
1803
+ name: Accept
1804
+ in: header
1805
+ required: true
1806
+ schema:
1807
+ type: string
1808
+ description: The `Accept` header field indicates the version of the API the client would like the server to use.
1809
+ Content-Length:
1810
+ name: Content-Length
1811
+ in: header
1812
+ required: false
1813
+ schema:
1814
+ type: integer
1815
+ description: |-
1816
+ The `Content-Length` header field indicates the anticipated size of the payload body. Only sent if there is a body.
1817
+
1818
+ **Note:** The API supports a maximum size of 5242880 bytes (5 Megabytes).
1819
+ ID:
1820
+ name: ID
1821
+ in: path
1822
+ required: true
1823
+ schema:
1824
+ type: string
1825
+ description: The identifier value.