@mojaloop/api-snippets 17.0.0 → 17.0.1

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 (26) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/docs/sdk-scheme-adapter-backend-v2_0_0-openapi3-snippets.yaml +2673 -0
  3. package/lib/example.d.ts +1 -1
  4. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/index.d.ts +0 -0
  5. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/index.js +0 -0
  6. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/index.js.map +1 -1
  7. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/json-schemas.json +8987 -8769
  8. package/lib/sdk-scheme-adapter/v2_0_0/backend/openapi.d.ts +4391 -0
  9. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/openapi.js +0 -0
  10. package/lib/sdk-scheme-adapter/v2_0_0/backend/openapi.js.map +1 -0
  11. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/schemas.d.ts +3158 -3295
  12. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/schemas.js +51 -58
  13. package/lib/sdk-scheme-adapter/v2_0_0/backend/schemas.js.map +1 -0
  14. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/types.d.ts +51 -58
  15. package/lib/sdk-scheme-adapter/v2_0_0/{inbound → backend}/types.js +0 -0
  16. package/lib/sdk-scheme-adapter/v2_0_0/backend/types.js.map +1 -0
  17. package/lib/sdk-scheme-adapter/v2_0_0/index.d.ts +2 -2
  18. package/lib/sdk-scheme-adapter/v2_0_0/index.js +3 -3
  19. package/package.json +22 -22
  20. package/sdk-scheme-adapter/v2_0_0/backend/openapi.yaml +1704 -0
  21. package/docs/sdk-scheme-adapter-inbound-v2_0_0-openapi3-snippets.yaml +0 -2889
  22. package/lib/sdk-scheme-adapter/v2_0_0/inbound/openapi.d.ts +0 -4350
  23. package/lib/sdk-scheme-adapter/v2_0_0/inbound/openapi.js.map +0 -1
  24. package/lib/sdk-scheme-adapter/v2_0_0/inbound/schemas.js.map +0 -1
  25. package/lib/sdk-scheme-adapter/v2_0_0/inbound/types.js.map +0 -1
  26. package/sdk-scheme-adapter/v2_0_0/inbound/openapi.yaml +0 -1074
@@ -1,1074 +0,0 @@
1
- openapi: 3.0.1
2
- info:
3
- title: Mojaloop SDK Inbound Scheme Adapter API
4
- description: >
5
- API specification for the Mojaloop SDK Inbound Scheme Adapter API – to be implemented by the Digital Financial Service Provider's (DFSP) backend.
6
-
7
-
8
- **Note on terminology:** The term "Switch" is equal to the term "Hub", and the term "FSP" is equal to the term "DFSP".
9
- license:
10
- name: Apache License Version 2.0, January 2004
11
- url: http://www.apache.org/licenses/
12
- version: 1.1.0
13
-
14
- paths:
15
- /participants/{idType}/{idValue}:
16
- get:
17
- summary: Asks for the identifier (fspId) of the scheme participant (FSP) that can handle transfers for the specified identifier type and value
18
- description: The HTTP request `GET /participants/{idType}/{idValue}` is used to find out in which FSP the requested party, defined by `{idType}` and `{idValue}`, is located.
19
- tags:
20
- - Participants
21
- parameters:
22
- - $ref: '#/components/parameters/idType'
23
- - $ref: '#/components/parameters/idValue'
24
- responses:
25
- 200:
26
- description: Response containing details of the requested party
27
- content:
28
- application/json:
29
- schema:
30
- $ref: '#/components/schemas/participantsResponse'
31
- 400:
32
- $ref: '#/components/responses/400'
33
- 404:
34
- $ref: '#/components/responses/404'
35
- 500:
36
- $ref: '#/components/responses/500'
37
-
38
- /participants/{idType}/{idValue}/{idSubValue}:
39
- get:
40
- summary: Asks for the identifier (fspId) of the scheme participant (FSP) that can handle transfers for the specified identifier type and value
41
- description: The HTTP request `GET /participants/{idType}/{idValue}/{idSubValue}` is used to find out in which FSP the requested party, defined by `{idType}`, `{idValue}` and `{idSubValue}` is located.
42
- tags:
43
- - Participants
44
- parameters:
45
- - $ref: '#/components/parameters/idType'
46
- - $ref: '#/components/parameters/idValue'
47
- - $ref: '#/components/parameters/idSubValue'
48
- responses:
49
- 200:
50
- description: Response containing details of the requested party
51
- content:
52
- application/json:
53
- schema:
54
- $ref: '#/components/schemas/participantsResponse'
55
- 400:
56
- $ref: '#/components/responses/400'
57
- 404:
58
- $ref: '#/components/responses/404'
59
- 500:
60
- $ref: '#/components/responses/500'
61
-
62
- /parties/{idType}/{idValue}:
63
- get:
64
- summary: Requests information relating to a transfer party identified by the specified identifier type and value
65
- description: The HTTP request `GET /parties/{idType}/{idValue}` is used to look up information regarding the requested transfer party, identified by `{idType}` and `{idValue}`.
66
- tags:
67
- - Parties
68
- parameters:
69
- - $ref: '#/components/parameters/idType'
70
- - $ref: '#/components/parameters/idValue'
71
- responses:
72
- 200:
73
- description: Response containing details of the requested party
74
- content:
75
- application/json:
76
- schema:
77
- $ref: '#/components/schemas/transferParty'
78
- 400:
79
- $ref: '#/components/responses/400'
80
- 404:
81
- $ref: '#/components/responses/404'
82
- 500:
83
- $ref: '#/components/responses/500'
84
-
85
- /parties/{idType}/{idValue}/{idSubValue}:
86
- get:
87
- summary: Requests information relating to a transfer party identified by the specified identifier type and value
88
- description: The HTTP request `GET /parties/{idType}/{idValue}/{idSubValue}` is used to look up information regarding the requested transfer party, identified by `{idType}`, `{idValue}` and `{idSubValue}`.
89
- tags:
90
- - Parties
91
- parameters:
92
- - $ref: '#/components/parameters/idType'
93
- - $ref: '#/components/parameters/idValue'
94
- - $ref: '#/components/parameters/idSubValue'
95
- responses:
96
- 200:
97
- description: Response containing details of the requested party
98
- content:
99
- application/json:
100
- schema:
101
- $ref: '#/components/schemas/transferParty'
102
- 400:
103
- $ref: '#/components/responses/400'
104
- 404:
105
- $ref: '#/components/responses/404'
106
- 500:
107
- $ref: '#/components/responses/500'
108
-
109
- /quoterequests:
110
- post:
111
- summary: Requests a quote for the specified transfer
112
- description: The HTTP request `POST /quoterequests` is used to request the creation of a quote for the provided financial transaction.
113
- tags:
114
- - Quotes
115
- requestBody:
116
- description: Request for a transfer quotation
117
- content:
118
- application/json:
119
- schema:
120
- $ref: '#/components/schemas/quoteRequest'
121
- responses:
122
- 200:
123
- description: A response to the transfer quotation request
124
- content:
125
- application/json:
126
- schema:
127
- $ref: '#/components/schemas/quoteResponse'
128
- 400:
129
- $ref: '#/components/responses/400'
130
- 500:
131
- $ref: '#/components/responses/500'
132
-
133
- /transfers:
134
- post:
135
- summary: Transfers funds from an external account to an internal account
136
- description: The HTTP request `POST /transfers` is used to request the creation of a transfer for the transfer party.
137
- tags:
138
- - Transfers
139
- requestBody:
140
- description: An incoming transfer request
141
- content:
142
- application/json:
143
- schema:
144
- $ref: '#/components/schemas/transferRequest'
145
- responses:
146
- 200:
147
- description: The transfer was accepted
148
- content:
149
- application/json:
150
- schema:
151
- $ref: '#/components/schemas/transferResponse'
152
- 400:
153
- $ref: '#/components/responses/400'
154
- 500:
155
- $ref: '#/components/responses/500'
156
-
157
- /transfers/{transferId}:
158
- parameters:
159
- - $ref: '#/components/parameters/transferId'
160
- get:
161
- summary: Retrieves information for a specific transfer
162
- description: The HTTP request `GET /transfers/{transferId}` is used to get information regarding a transfer created or requested earlier. The `{transferId}` in the URI should contain the `transferId` that was used for the creation of the transfer.
163
- tags:
164
- - Transfers
165
- responses:
166
- 200:
167
- description: The transfer was accepted
168
- content:
169
- application/json:
170
- schema:
171
- $ref: '#/components/schemas/transferDetailsResponse'
172
- 500:
173
- $ref: '#/components/responses/500'
174
- put:
175
- summary: Receive notification for a specific transfer
176
- description: The HTTP request `PUT /transfers/{transferId}` is used to receive notification for transfer being fulfiled when the FSP is a Payee
177
- tags:
178
- - Transfers
179
- requestBody:
180
- description: An incoming notification for fulfiled transfer
181
- content:
182
- application/json:
183
- schema:
184
- $ref: '#/components/schemas/fulfilNotification'
185
- responses:
186
- 200:
187
- description: The notification was accepted
188
- 500:
189
- $ref: '#/components/responses/500'
190
-
191
- /bulkTransactions/{bulkTransactionId}:
192
- parameters:
193
- - $ref: '../components/parameters/bulkTransactionId.yaml'
194
- put:
195
- summary: Request is used for bulk transaction confirmations
196
- description: >-
197
- The HTTP request `PUT /bulkTransactions/{bulkTransactionId}` is used to request
198
- information regarding a bulk transaction, i.e. when autoAcceptParty or
199
- autoAcceptQuote is false then the payer need to provide confirmation to
200
- proceed with further processing of the request. The `{bulkTransactionId}` in
201
- the URI should contain the `bulkTransactionId` that was used for the
202
- creation of the bulk transfer.
203
- tags:
204
- - BulkTransactions
205
- requestBody:
206
- description: An incoming notification for fulfiled transfer
207
- content:
208
- application/json:
209
- schema:
210
- $ref: '../components/schemas/bulkTransactionResponse.yaml'
211
- responses:
212
- 200:
213
- description: The notification was accepted
214
- 500:
215
- $ref: '#/components/responses/500'
216
-
217
- components:
218
- schemas:
219
-
220
- amountType:
221
- type: string
222
- enum:
223
- - SEND
224
- - RECEIVE
225
- description: SEND for send amount, RECEIVE for receive amount.
226
-
227
- currency:
228
- maxLength: 3
229
- minLength: 3
230
- type: string
231
- enum:
232
- - AED
233
- - AFN
234
- - ALL
235
- - AMD
236
- - ANG
237
- - AOA
238
- - ARS
239
- - AUD
240
- - AWG
241
- - AZN
242
- - BAM
243
- - BBD
244
- - BDT
245
- - BGN
246
- - BHD
247
- - BIF
248
- - BMD
249
- - BND
250
- - BOB
251
- - BRL
252
- - BSD
253
- - BTN
254
- - BWP
255
- - BYN
256
- - BZD
257
- - CAD
258
- - CDF
259
- - CHF
260
- - CLP
261
- - CNY
262
- - COP
263
- - CRC
264
- - CUC
265
- - CUP
266
- - CVE
267
- - CZK
268
- - DJF
269
- - DKK
270
- - DOP
271
- - DZD
272
- - EGP
273
- - ERN
274
- - ETB
275
- - EUR
276
- - FJD
277
- - FKP
278
- - GBP
279
- - GEL
280
- - GGP
281
- - GHS
282
- - GIP
283
- - GMD
284
- - GNF
285
- - GTQ
286
- - GYD
287
- - HKD
288
- - HNL
289
- - HRK
290
- - HTG
291
- - HUF
292
- - IDR
293
- - ILS
294
- - IMP
295
- - INR
296
- - IQD
297
- - IRR
298
- - ISK
299
- - JEP
300
- - JMD
301
- - JOD
302
- - JPY
303
- - KES
304
- - KGS
305
- - KHR
306
- - KMF
307
- - KPW
308
- - KRW
309
- - KWD
310
- - KYD
311
- - KZT
312
- - LAK
313
- - LBP
314
- - LKR
315
- - LRD
316
- - LSL
317
- - LYD
318
- - MAD
319
- - MDL
320
- - MGA
321
- - MKD
322
- - MMK
323
- - MNT
324
- - MOP
325
- - MRO
326
- - MUR
327
- - MVR
328
- - MWK
329
- - MXN
330
- - MYR
331
- - MZN
332
- - NAD
333
- - NGN
334
- - NIO
335
- - NOK
336
- - NPR
337
- - NZD
338
- - OMR
339
- - PAB
340
- - PEN
341
- - PGK
342
- - PHP
343
- - PKR
344
- - PLN
345
- - PYG
346
- - QAR
347
- - RON
348
- - RSD
349
- - RUB
350
- - RWF
351
- - SAR
352
- - SBD
353
- - SCR
354
- - SDG
355
- - SEK
356
- - SGD
357
- - SHP
358
- - SLL
359
- - SOS
360
- - SPL
361
- - SRD
362
- - STD
363
- - SVC
364
- - SYP
365
- - SZL
366
- - THB
367
- - TJS
368
- - TMT
369
- - TND
370
- - TOP
371
- - TRY
372
- - TTD
373
- - TVD
374
- - TWD
375
- - TZS
376
- - UAH
377
- - UGX
378
- - USD
379
- - UYU
380
- - UZS
381
- - VEF
382
- - VND
383
- - VUV
384
- - WST
385
- - XAF
386
- - XCD
387
- - XDR
388
- - XOF
389
- - XPF
390
- - XTS
391
- - XXX
392
- - YER
393
- - ZAR
394
- - ZMW
395
- - ZWD
396
-
397
- dateOfBirth:
398
- type: string
399
- 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)$
400
- description: Date of birth in the form YYYY-MM-DD.
401
-
402
- errorResponse:
403
- type: object
404
- required:
405
- - statusCode
406
- properties:
407
- statusCode:
408
- type: string
409
- description: Error code as string.
410
- message:
411
- type: string
412
- description: Error message text.
413
-
414
- fspId:
415
- type: string
416
- minLength: 1
417
- maxLength: 32
418
- description: FSP identifier.
419
-
420
- extensionList:
421
- type: array
422
- items:
423
- $ref: '#/components/schemas/extensionItem'
424
- minItems: 0
425
- maxItems: 16
426
-
427
- geoCode:
428
- type: object
429
- description: Indicates the geographic location from where the transaction was initiated.
430
- properties:
431
- latitude:
432
- $ref: '#/components/schemas/latitude'
433
- longitude:
434
- $ref: '#/components/schemas/longitude'
435
- required:
436
- - latitude
437
- - longitude
438
-
439
- idType:
440
- type: string
441
- enum:
442
- - MSISDN
443
- - ACCOUNT_ID
444
- description: |
445
- Below are the allowed values for the enumeration.
446
-
447
- - MSISDN - An MSISDN (Mobile Station International Subscriber Directory Number, that is, the phone number) is used as reference to a participant. The MSISDN identifier should be in international format according to the [ITU-T E.164 standard](https://www.itu.int/rec/T-REC-E.164/en). Optionally, the MSISDN may be prefixed by a single plus sign, indicating the international prefix.
448
-
449
- - ACCOUNT_ID - A bank account number or FSP account ID should be used as reference to a participant. The ACCOUNT_ID identifier can be in any format, as formats can greatly differ depending on country and FSP.
450
-
451
- personalIdType:
452
- type: string
453
- enum:
454
- - PASSPORT
455
- - NATIONAL_REGISTRATION
456
- - DRIVING_LICENSE
457
- - ALIEN_REGISTRATION
458
- - NATIONAL_ID_CARD
459
- - EMPLOYER_ID
460
- - TAX_ID_NUMBER
461
- - SENIOR_CITIZENS_CARD
462
- - MARRIAGE_CERTIFICATE
463
- - HEALTH_CARD
464
- - VOTERS_ID
465
- - UNITED_NATIONS
466
- - OTHER_ID
467
- description: |
468
- Below are the allowed values for the enumeration.
469
-
470
- - PASSPORT - Apassport number isused in reference to a party.
471
-
472
- - NATIONAL_REGISTRATION - Anational registration number isused in reference to a party.
473
-
474
- - DRIVING_LICENSE - Adriving license isused in reference to a party.
475
-
476
- - ALIEN_REGISTRATION - An alien registration number isused in reference to a party.
477
-
478
- - NATIONAL_ID_CARD - Anational ID card number isused in reference to a party.
479
-
480
- - EMPLOYER_ID - Atax identification number isused in reference to a party.
481
-
482
- - TAX_ID_NUMBER - Atax identification number isused in reference to a party.
483
-
484
- - SENIOR_CITIZENS_CARD - Asenior citizens card number isused in reference to a party.
485
-
486
- - MARRIAGE_CERTIFICATE - Amarriage certificate number isused in reference to a party.
487
-
488
- - HEALTH_CARD - Ahealth card number isused in reference to a party.
489
-
490
- - VOTERS_ID - Avoter’s identification number isused in reference to a party.
491
-
492
- - UNITED_NATIONS - An UN (United Nations) number isused in reference to a party.
493
-
494
- - OTHER_ID - Any other type of identification type number isused in reference to a party.
495
-
496
- idValue:
497
- type: string
498
- minLength: 1
499
- maxLength: 128
500
- description: Identifier of the party.
501
-
502
- idSubValue:
503
- type: string
504
- minLength: 1
505
- maxLength: 128
506
- description: Either a sub-identifier of a `{idValue}`, or a sub-type of the `{idType}`, normally a `{personalIdType}`
507
-
508
- initiator:
509
- type: string
510
- enum:
511
- - PAYER
512
- - PAYEE
513
- description: Specifies if the initiator of the transfer is the Payer or Payee.
514
-
515
- extensionItem:
516
- type: object
517
- properties:
518
- key:
519
- type: string
520
- minLength: 1
521
- maxLength: 32
522
- value:
523
- type: string
524
- minLength: 1
525
- maxLength: 128
526
-
527
- initiatorType:
528
- type: string
529
- enum:
530
- - CONSUMER
531
- - AGENT
532
- - BUSINESS
533
- - DEVICE
534
- description: Specifies the type of the transaction initiator.
535
-
536
- latitude:
537
- type: string
538
- pattern: ^(\+|-)?(?:90(?:(?:\.0{1,6})?)|(?:[0-9]|[1-8][0-9])(?:(?:\.[0-9]{1,6})?))$
539
- description: The API data type Latitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
540
-
541
- longitude:
542
- type: string
543
- pattern: ^(\+|-)?(?:180(?:(?:\.0{1,6})?)|(?:[0-9]|[1-9][0-9]|1[0-7][0-9])(?:(?:\.[0-9]{1,6})?))$
544
- description: The API data type Longitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
545
-
546
- money:
547
- pattern: ^([0]|([1-9][0-9]{0,17}))([.][0-9]{0,3}[1-9])?$
548
- type: string
549
-
550
- participantsResponse:
551
- type: object
552
- properties:
553
- fspId:
554
- $ref: '#/components/schemas/fspId'
555
-
556
- payerType:
557
- type: string
558
- enum:
559
- - CONSUMER
560
- - AGENT
561
- - BUSINESS
562
- - DEVICE
563
-
564
- quoteId:
565
- pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
566
- type: string
567
- description: A Mojaloop API quote identifier (UUID).
568
-
569
- quoteRequest:
570
- type: object
571
- description: A request for a quote for transfer from the DFSP backend.
572
- required:
573
- - quoteId
574
- - transactionId
575
- - to
576
- - from
577
- - amountType
578
- - amount
579
- - currency
580
- - transactionType
581
- - initiator
582
- - initiatorType
583
- properties:
584
- quoteId:
585
- $ref: '#/components/schemas/quoteId'
586
- transactionId:
587
- $ref: '#/components/schemas/transactionId'
588
- description: Identifier for the transaction, decided by the Payer FSP during the creation of the quote.
589
- to:
590
- $ref: '#/components/schemas/transferParty'
591
- description: Information about the Payee in the proposed financial transaction.
592
- from:
593
- $ref: '#/components/schemas/transferParty'
594
- description: Information about the Payer in the proposed financial transaction.
595
- amountType:
596
- $ref: '#/components/schemas/amountType'
597
- description: SEND for send amount, RECEIVE for receive amount.
598
- amount:
599
- $ref: '#/components/schemas/money'
600
- 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.
601
- currency:
602
- $ref: '#/components/schemas/currency'
603
- feesAmount:
604
- $ref: '#/components/schemas/money'
605
- 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.
606
- feesCurrency:
607
- $ref: '#/components/schemas/currency'
608
- transactionType:
609
- $ref: '#/components/schemas/transactionType'
610
- description: Type of transaction for which the quote is requested.
611
- initiator:
612
- $ref: '#/components/schemas/initiator'
613
- description: Specifies if the initiator of the transfer is the Payer or Payee.
614
- initiatorType:
615
- $ref: '#/components/schemas/initiatorType'
616
- description: Specifies the type of the transaction initiator.
617
- geoCode:
618
- $ref: '#/components/schemas/geoCode'
619
- description: Longitude and Latitude of the initiating party. Can be used to detect fraud.
620
- note:
621
- type: string
622
- minLength: 1
623
- maxLength: 128
624
- description: An optional note associated with the requested transfer.
625
- expiration:
626
- $ref: '#/components/schemas/timestamp'
627
- description: An optional deadline for responding to the quote request.
628
- extensionList:
629
- $ref: '#/components/schemas/extensionList'
630
-
631
- quoteResponse:
632
- type: object
633
- description: A response to a request for a quote.
634
- required:
635
- - quoteId
636
- - transactionId
637
- - transferAmount
638
- - transferAmountCurrency
639
- properties:
640
- quoteId:
641
- $ref: '#/components/schemas/quoteId'
642
- description: ID of the quote that this response relates to.
643
- transactionId:
644
- $ref: '#/components/schemas/transactionId'
645
- description: Identifier for the transaction, decided by the Payer FSP during the creation of the quote.
646
- transferAmount:
647
- $ref: '#/components/schemas/money'
648
- description: The amount of money that the Payer FSP should transfer to the Payee FSP.
649
- transferAmountCurrency:
650
- $ref: '#/components/schemas/currency'
651
- description: The currency of the `transferAmount`.
652
- payeeReceiveAmount:
653
- $ref: '#/components/schemas/money'
654
- description: The amount that the Payee should receive in the end-to-end transaction. Optional as the Payee FSP might not want to disclose any optional Payee fees.
655
- payeeReceiveAmountCurrency:
656
- $ref: '#/components/schemas/currency'
657
- description: The currency of the `payeeReceiveAmount`.
658
- payeeFspFeeAmount:
659
- $ref: '#/components/schemas/money'
660
- description: Payee FSP’s part of the transaction fee.
661
- payeeFspFeeAmountCurrency:
662
- $ref: '#/components/schemas/currency'
663
- description: The currency of the `payeeFspFeeAmount`.
664
- payeeFspCommissionAmount:
665
- $ref: '#/components/schemas/money'
666
- description: Transaction commission from the Payee FSP.
667
- payeeFspCommissionAmountCurrency:
668
- $ref: '#/components/schemas/currency'
669
- description: Currency of the `payeeFspCommissionAmount`.
670
- expiration:
671
- $ref: '#/components/schemas/timestamp'
672
- description: Timestamp specifying the validity period of the quotation.
673
- geoCode:
674
- $ref: '#/components/schemas/geoCode'
675
- description: Longitude and Latitude of the Payee. Can be used to detect fraud.
676
- extensionList:
677
- $ref: '#/components/schemas/extensionList'
678
-
679
- timestamp:
680
- type: string
681
- 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)$
682
- description: An ISO-8601 formatted timestamp.
683
-
684
- transactionId:
685
- pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
686
- type: string
687
- description: ID of the transaction, the ID is decided by the Payer FSP during the creation of the quote.
688
-
689
- transactionType:
690
- type: string
691
- enum:
692
- - TRANSFER
693
-
694
- scenario:
695
- type: string
696
- enum:
697
- - TRANSFER
698
-
699
- amountCurrency:
700
- type: object
701
- description: Object containing Amount and Currency of the transfer.
702
- required:
703
- - amount
704
- - currency
705
- properties:
706
- amount:
707
- $ref: '#/components/schemas/money'
708
- currency:
709
- $ref: '#/components/schemas/currency'
710
-
711
- transactionTypeObject:
712
- type: object
713
- description: Object containing transfer object.
714
- required:
715
- - scenario
716
- - initiator
717
- - initiatorType
718
- properties:
719
- scenario:
720
- $ref: '#/components/schemas/scenario'
721
- initiator:
722
- $ref: '#/components/schemas/initiator'
723
- initiatorType:
724
- $ref: '#/components/schemas/initiatorType'
725
- description: Specifies the type of the transaction initiator.
726
-
727
- ilpPacketData:
728
- type: object
729
- description: Object containing transfer object.
730
- required:
731
- - quoteId
732
- - transactionId
733
- - payer
734
- - payee
735
- - amount
736
- - transactionType
737
- properties:
738
- quoteId:
739
- $ref: '#/components/schemas/quoteId'
740
- transactionId:
741
- $ref: '#/components/schemas/transactionId'
742
- description: Identifier for the transaction, decided by the Payer FSP during the creation of the quote.
743
- payer:
744
- $ref: '#/components/schemas/transferParty'
745
- description: Information about the Payer in the proposed financial transaction.
746
- payee:
747
- $ref: '#/components/schemas/transferParty'
748
- description: Information about the Payee in the proposed financial transaction.
749
- amount:
750
- $ref: '#/components/schemas/amountCurrency'
751
- description: Amount and currency of the transaction
752
- transactionType:
753
- $ref: '#/components/schemas/transactionTypeObject'
754
- description: Information about type of transaction and initiator.
755
-
756
- transferId:
757
- pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
758
- type: string
759
- description: A Mojaloop API transfer identifier (UUID).
760
-
761
- transferParty:
762
- type: object
763
- required:
764
- - idType
765
- - idValue
766
- properties:
767
- type:
768
- $ref: '#/components/schemas/payerType'
769
- idType:
770
- $ref: '#/components/schemas/idType'
771
- idValue:
772
- type: string
773
- description: The identifier string used to identify the sender.
774
- idSubValue:
775
- $ref: '#/components/schemas/idSubValue'
776
- displayName:
777
- type: string
778
- description: Display name of the sender, if known.
779
- firstName:
780
- type: string
781
- description: Party first name.
782
- middleName:
783
- type: string
784
- description: Party middle name.
785
- lastName:
786
- type: string
787
- description: Party last name.
788
- dateOfBirth:
789
- $ref: '#/components/schemas/dateOfBirth'
790
- merchantClassificationCode:
791
- type: string
792
- description: Up to 4 digits specifying the sender's merchant classification, if known and applicable.
793
- fspId:
794
- type: string
795
- description: Mojaloop scheme FSPID of the DFSP which owns the party account.
796
- extensionList:
797
- $ref: '#/components/schemas/extensionList'
798
-
799
- transferState:
800
- type: string
801
- enum:
802
- - RECEIVED
803
- - RESERVED
804
- - COMMITTED
805
- - ABORTED
806
- description: >
807
- Below are the allowed values for the enumeration
808
- - RECEIVED DFSP has received the transfer.
809
- - RESERVED DFSP has reserved the transfer.
810
- - COMMITTED DFSP has successfully performed the transfer.
811
- - ABORTED DFSP has aborted the transfer due a rejection or failure to perform the transfer.
812
-
813
- transferRequest:
814
- type: object
815
- required:
816
- - transferId
817
- - quote
818
- - from
819
- - to
820
- - amountType
821
- - currency
822
- - amount
823
- - transactionType
824
- - ilpPacket
825
- properties:
826
- transferId:
827
- $ref: '#/components/schemas/transferId'
828
- quote:
829
- $ref: '#/components/schemas/quoteResponse'
830
- quoteRequestExtensions:
831
- $ref: '#/components/schemas/extensionList'
832
- from:
833
- $ref: '#/components/schemas/transferParty'
834
- to:
835
- $ref: '#/components/schemas/transferParty'
836
- amountType:
837
- $ref: '#/components/schemas/amountType'
838
- currency:
839
- $ref: '#/components/schemas/currency'
840
- amount:
841
- $ref: '#/components/schemas/money'
842
- transactionType:
843
- $ref: '#/components/schemas/transactionType'
844
- ilpPacket:
845
- type: object
846
- required:
847
- - data
848
- properties:
849
- data:
850
- $ref: '#/components/schemas/ilpPacketData'
851
- note:
852
- maxLength: 128
853
- type: string
854
-
855
- transferResponse:
856
- type: object
857
- required:
858
- - homeTransactionId
859
- properties:
860
- homeTransactionId:
861
- type: string
862
- description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
863
- fulfilment:
864
- $ref: '../components/schemas/IlpFulfilment.yaml'
865
- description: Fulfilment from the DFSP backend, used for testing purposes to inject an invalid fulfilment via a rule.
866
- transferState:
867
- $ref: '#/components/schemas/transferState'
868
- description: Transfer state from the DFSP backend, used for testing purposes to inject an desired transfer state via a rule.
869
- example: ABORTED
870
- completedTimestamp:
871
- $ref: '#/components/schemas/timestamp'
872
- description: Completed timestamp from the DFSP backend, used for testing purposes to inject a given completed timestamp via a rule.
873
- example: "2020-05-19T08:38:08.699-04:00"
874
-
875
- transferDetailsResponse:
876
- type: object
877
- required:
878
- - homeTransactionId
879
- - from
880
- - to
881
- - amountType
882
- - currency
883
- - amount
884
- - transferState
885
- - transactionType
886
- - timestamp
887
- properties:
888
- homeTransactionId:
889
- type: string
890
- description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
891
- from:
892
- $ref: '#/components/schemas/transferParty'
893
- to:
894
- $ref: '#/components/schemas/transferParty'
895
- amountType:
896
- $ref: '#/components/schemas/amountType'
897
- currency:
898
- $ref: '#/components/schemas/currency'
899
- amount:
900
- $ref: '#/components/schemas/money'
901
- transferState:
902
- $ref: '#/components/schemas/transferState'
903
- timestamp:
904
- $ref: '#/components/schemas/timestamp'
905
- transactionType:
906
- $ref: '#/components/schemas/transactionType'
907
- note:
908
- maxLength: 128
909
- type: string
910
- extensions:
911
- $ref: '#/components/schemas/extensionList'
912
-
913
- transferStatus:
914
- type: string
915
- enum:
916
- - ERROR_OCCURRED
917
- - WAITING_FOR_PARTY_ACCEPTANCE
918
- - WAITING_FOR_QUOTE_ACCEPTANCE
919
- - COMPLETED
920
-
921
- fulfilNotification:
922
- title: TransfersIDPatchResponse
923
- type: object
924
- description: PUT /transfers/{transferId} object
925
- properties:
926
- transferId:
927
- $ref: '#/components/schemas/transferId'
928
- direction:
929
- type: string
930
- enum:
931
- - INBOUND
932
- quoteRequest:
933
- type: object
934
- properties:
935
- headers:
936
- type: object
937
- body:
938
- type: object
939
- quoteResponse:
940
- type: object
941
- properties:
942
- headers:
943
- type: object
944
- body:
945
- type: object
946
- prepare:
947
- type: object
948
- properties:
949
- headers:
950
- type: object
951
- body:
952
- type: object
953
- fulfil:
954
- type: object
955
- properties:
956
- headers:
957
- type: object
958
- body:
959
- type: object
960
- quote:
961
- type: object
962
- properties:
963
- request:
964
- type: object
965
- internalRequest:
966
- type: object
967
- response:
968
- type: object
969
- mojaloopResponse:
970
- type: object
971
- fulfilment:
972
- type: string
973
- currentState:
974
- $ref: '#/components/schemas/transferStatus'
975
- lastError:
976
- $ref: '../components/schemas/transferError.yaml'
977
- initiatedTimestamp:
978
- $ref: '#/components/schemas/timestamp'
979
- finalNotification:
980
- type: object
981
- properties:
982
- completedTimestamp:
983
- $ref: '#/components/schemas/timestamp'
984
- description: Time and date when the transaction was completed.
985
- example: "2020-05-19T08:38:08.699-04:00"
986
- transferState:
987
- $ref: '#/components/schemas/transferState'
988
- description: State of the transfer.
989
- example: COMMITTED
990
- extensionList:
991
- $ref: '#/components/schemas/extensionList'
992
- description: Optional extension, specific to deployment.
993
- required:
994
- - completedTimestamp
995
- - transferState
996
-
997
- extensionListComplex:
998
- type: object
999
- description: Data model for the complex type ExtensionList
1000
- properties:
1001
- extension:
1002
- type: array
1003
- items:
1004
- $ref: '#/components/schemas/extensionItem'
1005
- minItems: 1
1006
- maxItems: 16
1007
- description: Number of Extension elements
1008
- required:
1009
- - extension
1010
-
1011
- generalError:
1012
- type: object
1013
- description: This object may represent a number of different error object types and so its properties may vary significantly.
1014
-
1015
- responses:
1016
- '400':
1017
- description: Malformed or missing required headers or parameters
1018
- content:
1019
- application/json:
1020
- schema:
1021
- $ref: '#/components/schemas/errorResponse'
1022
- '404':
1023
- description: The party specified by the provided identifier type and value is not known to the server
1024
- '500':
1025
- description: An error occurred processing the request
1026
- content:
1027
- application/json:
1028
- schema:
1029
- $ref: '#/components/schemas/errorResponse'
1030
-
1031
- parameters:
1032
- transferId:
1033
- name: transferId
1034
- in: path
1035
- required: true
1036
- schema:
1037
- type: string
1038
-
1039
- idType:
1040
- name: idType
1041
- in: path
1042
- required: true
1043
- schema:
1044
- type: string
1045
- enum:
1046
- - MSISDN
1047
- - ACCOUNT_ID
1048
- description: |
1049
- Below are the allowed values for the enumeration.
1050
-
1051
- - MSISDN - An MSISDN (Mobile Station International Subscriber Directory Number, that is, the phone number) is used as reference to a participant. The MSISDN identifier should be in international format according to the [ITU-T E.164 standard](https://www.itu.int/rec/T-REC-E.164/en). Optionally, the MSISDN may be prefixed by a single plus sign, indicating the international prefix.
1052
-
1053
- - ACCOUNT_ID - A bank account number or FSP account ID should be used as reference to a participant. The ACCOUNT_ID identifier can be in any format, as formats can greatly differ depending on country and FSP.
1054
-
1055
- idValue:
1056
- name: idValue
1057
- in: path
1058
- required: true
1059
- schema:
1060
- type: string
1061
- minLength: 1
1062
- maxLength: 128
1063
- description: Identifier of the party.
1064
-
1065
- idSubValue:
1066
- name: idSubValue
1067
- in: path
1068
- required: true
1069
- schema:
1070
- type: string
1071
- minLength: 1
1072
- maxLength: 128
1073
- description: Either a sub-identifier of a `{idValue}`, or a sub-type of the `{idType}`, normally a `{personalIdType}`
1074
-