@mojaloop/api-snippets 17.3.0-snapshot.0 → 17.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.
- package/CHANGELOG.md +14 -0
- package/audit-ci.jsonc +1 -1
- package/docs/fspiop-rest-v1.0-openapi3-snippets.yaml +204 -805
- package/docs/fspiop-rest-v1.1-openapi3-snippets.yaml +2432 -2447
- package/docs/fspiop-rest-v2.0-openapi3-snippets.yaml +3149 -3163
- package/docs/sdk-scheme-adapter-backend-v2_0_0-openapi3-snippets.yaml +103 -346
- package/docs/sdk-scheme-adapter-backend-v2_1_0-openapi3-snippets.yaml +131 -449
- package/docs/sdk-scheme-adapter-outbound-v2_0_0-openapi3-snippets.yaml +144 -478
- package/docs/sdk-scheme-adapter-outbound-v2_1_0-openapi3-snippets.yaml +179 -606
- package/docs/thirdparty-openapi3-snippets.yaml +296 -886
- package/fspiop/v1_1/openapi3/openapi.yaml +10 -2
- package/fspiop/v2_0/openapi3/openapi.yaml +11 -1
- package/lib/fspiop/v1_1/openapi.d.ts +524 -542
- package/lib/fspiop/v2_0/openapi.d.ts +685 -703
- package/lib/scripts/openapi-refactor.d.ts +29 -0
- package/lib/scripts/openapi-refactor.js +70 -0
- package/lib/scripts/openapi-refactor.js.map +1 -0
- package/package.json +14 -9
@@ -1,24 +1,16 @@
|
|
1
1
|
openapi: 3.0.1
|
2
2
|
info:
|
3
3
|
title: Mojaloop SDK Backend API
|
4
|
-
description:
|
4
|
+
description: |
|
5
5
|
API specification for the SDK Backend API.
|
6
6
|
|
7
|
+
To be implemented by the Digital Financial Service Provider (DFSP) to work in tandem with the Mojaloop SDK (`mojaloop/sdk-scheme-adapter`).
|
7
8
|
|
8
|
-
|
9
|
-
in tandem with the Mojaloop SDK (`mojaloop/sdk-scheme-adapter`).
|
9
|
+
This API is not to be confused with the Mojaloop SDK's Inbound or Outbound API.
|
10
10
|
|
11
|
+
TODO: More explanation and links about the SDK adapter's Inbound and Outbound API.
|
11
12
|
|
12
|
-
|
13
|
-
API.
|
14
|
-
|
15
|
-
|
16
|
-
TODO: More explanation and links about the SDK adapter's Inbound and
|
17
|
-
Outbound API.
|
18
|
-
|
19
|
-
|
20
|
-
**Note on terminology:** The term "Switch" is equal to the term "Hub", and
|
21
|
-
the term "FSP" is equal to the term "DFSP".
|
13
|
+
**Note on terminology:** The term "Switch" is equal to the term "Hub", and the term "FSP" is equal to the term "DFSP".
|
22
14
|
license:
|
23
15
|
name: Apache License Version 2.0, January 2004
|
24
16
|
url: http://www.apache.org/licenses/
|
@@ -72,20 +64,12 @@ paths:
|
|
72
64
|
$ref: '#/components/responses/404'
|
73
65
|
'500':
|
74
66
|
$ref: '#/components/responses/500'
|
75
|
-
summary:
|
76
|
-
Requests information relating to a bulk quote identified by the
|
77
|
-
specified identifier value.
|
67
|
+
summary: Requests information relating to a bulk quote identified by the specified identifier value.
|
78
68
|
tags:
|
79
69
|
- BulkQuotes
|
80
70
|
/bulkTransactions/{bulkTransactionId}:
|
81
71
|
put:
|
82
|
-
description:
|
83
|
-
The HTTP request `PUT /bulkTransactions/{bulkTransactionId}` is used to
|
84
|
-
amend information regarding a bulk transaction, i.e. when
|
85
|
-
autoAcceptParty or autoAcceptQuote is false then the payer need to
|
86
|
-
provide confirmation to proceed with further processing of the request.
|
87
|
-
The `{bulkTransactionId}` in the URI should contain the
|
88
|
-
`bulkTransactionId` that was used for the creation of the bulk transfer.
|
72
|
+
description: The HTTP request `PUT /bulkTransactions/{bulkTransactionId}` is used to amend information regarding a bulk transaction, i.e. when autoAcceptParty or autoAcceptQuote is false then the payer need to provide confirmation to proceed with further processing of the request. The `{bulkTransactionId}` in the URI should contain the `bulkTransactionId` that was used for the creation of the bulk transfer.
|
89
73
|
operationId: BackendBulkTransactionsPut
|
90
74
|
parameters:
|
91
75
|
- $ref: '#/components/parameters/bulkTransactionId'
|
@@ -106,9 +90,7 @@ paths:
|
|
106
90
|
- BulkTransactionsPut
|
107
91
|
/requestToPay/{transactionRequestId}:
|
108
92
|
put:
|
109
|
-
description:
|
110
|
-
It is used to notify the DFSP backend about the status of the
|
111
|
-
requestToPayTransfer.
|
93
|
+
description: It is used to notify the DFSP backend about the status of the requestToPayTransfer.
|
112
94
|
operationId: RequestToPayPut
|
113
95
|
parameters:
|
114
96
|
- $ref: '#/components/parameters/transactionRequestId'
|
@@ -147,9 +129,7 @@ paths:
|
|
147
129
|
$ref: '#/components/responses/400'
|
148
130
|
'500':
|
149
131
|
$ref: '#/components/responses/500'
|
150
|
-
summary:
|
151
|
-
Execute bulk transfer of funds from an external account to internal
|
152
|
-
accounts.
|
132
|
+
summary: Execute bulk transfer of funds from an external account to internal accounts.
|
153
133
|
tags:
|
154
134
|
- BulkTransfers
|
155
135
|
/bulkTransfers/{idValue}:
|
@@ -170,9 +150,7 @@ paths:
|
|
170
150
|
$ref: '#/components/responses/404'
|
171
151
|
'500':
|
172
152
|
$ref: '#/components/responses/500'
|
173
|
-
summary:
|
174
|
-
Requests information relating to a bulk transfer identified by the
|
175
|
-
specified identifier value.
|
153
|
+
summary: Requests information relating to a bulk transfer identified by the specified identifier value.
|
176
154
|
tags:
|
177
155
|
- BulkTransfers
|
178
156
|
/otp/{transactionRequestId}:
|
@@ -198,10 +176,7 @@ paths:
|
|
198
176
|
- OTP
|
199
177
|
/participants/{idType}/{idValue}:
|
200
178
|
get:
|
201
|
-
description:
|
202
|
-
The HTTP request `GET /participants/{idType}/{idValue}` is used to find
|
203
|
-
out in which FSP the requested party, defined by `{idType}` and
|
204
|
-
`{idValue}`, is located.
|
179
|
+
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.
|
205
180
|
operationId: BackendParticipantsGetByTypeAndID
|
206
181
|
parameters:
|
207
182
|
- $ref: '#/components/parameters/idType'
|
@@ -219,17 +194,12 @@ paths:
|
|
219
194
|
$ref: '#/components/responses/404'
|
220
195
|
'500':
|
221
196
|
$ref: '#/components/responses/500'
|
222
|
-
summary:
|
223
|
-
Asks for the identifier (fspId) of the scheme participant (FSP) that can
|
224
|
-
handle transfers for the specified identifier type and value.
|
197
|
+
summary: Asks for the identifier (fspId) of the scheme participant (FSP) that can handle transfers for the specified identifier type and value.
|
225
198
|
tags:
|
226
199
|
- Participants
|
227
200
|
/participants/{idType}/{idValue}/{idSubValue}:
|
228
201
|
get:
|
229
|
-
description:
|
230
|
-
The HTTP request `GET /participants/{idType}/{idValue}/{idSubValue}` is
|
231
|
-
used to find out in which FSP the requested party, defined by
|
232
|
-
`{idType}`, `{idValue}` and `{idSubValue}` is located.
|
202
|
+
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.
|
233
203
|
operationId: BackendParticipantsGetByTypeIDAndSubId
|
234
204
|
parameters:
|
235
205
|
- $ref: '#/components/parameters/idType'
|
@@ -248,17 +218,12 @@ paths:
|
|
248
218
|
$ref: '#/components/responses/404'
|
249
219
|
'500':
|
250
220
|
$ref: '#/components/responses/500'
|
251
|
-
summary:
|
252
|
-
Asks for the identifier (fspId) of the scheme participant (FSP) that can
|
253
|
-
handle transfers for the specified identifier type and value.
|
221
|
+
summary: Asks for the identifier (fspId) of the scheme participant (FSP) that can handle transfers for the specified identifier type and value.
|
254
222
|
tags:
|
255
223
|
- Participants
|
256
224
|
/parties/{idType}/{idValue}:
|
257
225
|
get:
|
258
|
-
description:
|
259
|
-
The HTTP request `GET /parties/{idType}/{idValue}` is used to look up
|
260
|
-
information regarding the requested transfer party, identified by
|
261
|
-
`{idType}` and `{idValue}`.
|
226
|
+
description: The HTTP request `GET /parties/{idType}/{idValue}` is used to look up information regarding the requested transfer party, identified by `{idType}` and `{idValue}`.
|
262
227
|
operationId: BackendPartiesGetByTypeAndID
|
263
228
|
parameters:
|
264
229
|
- $ref: '#/components/parameters/idType'
|
@@ -276,17 +241,12 @@ paths:
|
|
276
241
|
$ref: '#/components/responses/404'
|
277
242
|
'500':
|
278
243
|
$ref: '#/components/responses/500'
|
279
|
-
summary:
|
280
|
-
Requests information relating to a transfer party identified by the
|
281
|
-
specified identifier type and value.
|
244
|
+
summary: Requests information relating to a transfer party identified by the specified identifier type and value.
|
282
245
|
tags:
|
283
246
|
- Parties
|
284
247
|
/parties/{idType}/{idValue}/{idSubValue}:
|
285
248
|
get:
|
286
|
-
description:
|
287
|
-
The HTTP request `GET /parties/{idType}/{idValue}/{idSubValue}` is used
|
288
|
-
to look up information regarding the requested transfer party,
|
289
|
-
identified by `{idType}`, `{idValue}` and `{idSubValue}`.
|
249
|
+
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}`.
|
290
250
|
operationId: BackendPartiesGetByTypeIdAndSubId
|
291
251
|
parameters:
|
292
252
|
- $ref: '#/components/parameters/idType'
|
@@ -305,16 +265,12 @@ paths:
|
|
305
265
|
$ref: '#/components/responses/404'
|
306
266
|
'500':
|
307
267
|
$ref: '#/components/responses/500'
|
308
|
-
summary:
|
309
|
-
Requests information relating to a transfer party identified by the
|
310
|
-
specified identifier type, value and subId value.
|
268
|
+
summary: Requests information relating to a transfer party identified by the specified identifier type, value and subId value.
|
311
269
|
tags:
|
312
270
|
- Parties
|
313
271
|
/quoterequests:
|
314
272
|
post:
|
315
|
-
description:
|
316
|
-
The HTTP request `POST /quoterequests` is used to request the creation
|
317
|
-
of a quote for the provided financial transaction.
|
273
|
+
description: The HTTP request `POST /quoterequests` is used to request the creation of a quote for the provided financial transaction.
|
318
274
|
operationId: BackendQuoteRequest
|
319
275
|
requestBody:
|
320
276
|
content:
|
@@ -361,9 +317,7 @@ paths:
|
|
361
317
|
- TransactionRequest
|
362
318
|
/transfers:
|
363
319
|
post:
|
364
|
-
description:
|
365
|
-
The HTTP request `POST /transfers` is used to request the creation of a
|
366
|
-
transfer for the transfer party.
|
320
|
+
description: The HTTP request `POST /transfers` is used to request the creation of a transfer for the transfer party.
|
367
321
|
operationId: BackendTransfersPost
|
368
322
|
requestBody:
|
369
323
|
content:
|
@@ -387,11 +341,7 @@ paths:
|
|
387
341
|
- Transfers
|
388
342
|
/transfers/{transferId}:
|
389
343
|
get:
|
390
|
-
description:
|
391
|
-
The HTTP request `GET /transfers/{transferId}` is used to get
|
392
|
-
information regarding a transfer created or requested earlier. The
|
393
|
-
`{transferId}` in the URI should contain the `transferId` that was used
|
394
|
-
for the creation of the transfer.
|
344
|
+
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.
|
395
345
|
operationId: BackendTransfersGet
|
396
346
|
parameters:
|
397
347
|
- $ref: '#/components/parameters/transferId'
|
@@ -408,9 +358,7 @@ paths:
|
|
408
358
|
tags:
|
409
359
|
- Transfers
|
410
360
|
put:
|
411
|
-
description:
|
412
|
-
The HTTP request `PUT /transfers/{transferId}` is used to receive
|
413
|
-
notification for transfer being fulfiled when the FSP is a Payee.
|
361
|
+
description: The HTTP request `PUT /transfers/{transferId}` is used to receive notification for transfer being fulfiled when the FSP is a Payee.
|
414
362
|
operationId: BackendTransfersPut
|
415
363
|
parameters:
|
416
364
|
- $ref: '#/components/parameters/transferId'
|
@@ -431,9 +379,7 @@ paths:
|
|
431
379
|
components:
|
432
380
|
parameters:
|
433
381
|
idSubValue:
|
434
|
-
description:
|
435
|
-
A sub-identifier of the party identifier, or a sub-type of the party
|
436
|
-
identifier's type. For example, `PASSPORT`, `DRIVING_LICENSE`.
|
382
|
+
description: A sub-identifier of the party identifier, or a sub-type of the party identifier's type. For example, `PASSPORT`, `DRIVING_LICENSE`.
|
437
383
|
in: path
|
438
384
|
name: idSubValue
|
439
385
|
required: true
|
@@ -471,9 +417,7 @@ components:
|
|
471
417
|
required: true
|
472
418
|
schema:
|
473
419
|
$ref: '#/components/schemas/CorrelationId'
|
474
|
-
description:
|
475
|
-
Identifier of the bulk transaction to continue as returned in the
|
476
|
-
response to a `POST /bulkTransaction` request.
|
420
|
+
description: Identifier of the bulk transaction to continue as returned in the response to a `POST /bulkTransaction` request.
|
477
421
|
responses:
|
478
422
|
'400':
|
479
423
|
content:
|
@@ -482,9 +426,7 @@ components:
|
|
482
426
|
$ref: '#/components/schemas/errorResponse'
|
483
427
|
description: Malformed or missing required headers or parameters.
|
484
428
|
'404':
|
485
|
-
description:
|
486
|
-
The party specified by the provided identifier type and value is not
|
487
|
-
known to the server.
|
429
|
+
description: The party specified by the provided identifier type and value is not known to the server.
|
488
430
|
'500':
|
489
431
|
content:
|
490
432
|
application/json:
|
@@ -495,8 +437,7 @@ components:
|
|
495
437
|
DateOfBirth:
|
496
438
|
title: DateofBirth (type Date)
|
497
439
|
type: string
|
498
|
-
pattern:
|
499
|
-
^(?:[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)$
|
440
|
+
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)$
|
500
441
|
description: Date of Birth of the Party.
|
501
442
|
example: '1966-06-16'
|
502
443
|
FirstName:
|
@@ -504,9 +445,7 @@ components:
|
|
504
445
|
type: string
|
505
446
|
minLength: 1
|
506
447
|
maxLength: 128
|
507
|
-
pattern:
|
508
|
-
^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control}
|
509
|
-
.,''-]{1,128}$
|
448
|
+
pattern: ^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control} .,''-]{1,128}$
|
510
449
|
description: First name of the Party (Name Type).
|
511
450
|
example: Henrik
|
512
451
|
FspId:
|
@@ -645,27 +584,20 @@ components:
|
|
645
584
|
type: string
|
646
585
|
minLength: 1
|
647
586
|
maxLength: 128
|
648
|
-
pattern:
|
649
|
-
^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control}
|
650
|
-
.,''-]{1,128}$
|
587
|
+
pattern: ^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control} .,''-]{1,128}$
|
651
588
|
description: Last name of the Party (Name Type).
|
652
589
|
example: Karlsson
|
653
590
|
MerchantClassificationCode:
|
654
591
|
title: MerchantClassificationCode
|
655
592
|
type: string
|
656
593
|
pattern: ^[\d]{1,4}$
|
657
|
-
description:
|
658
|
-
A limited set of pre-defined numbers. This list would be a limited set
|
659
|
-
of numbers identifying a set of popular merchant types like School Fees,
|
660
|
-
Pubs and Restaurants, Groceries, etc.
|
594
|
+
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.
|
661
595
|
MiddleName:
|
662
596
|
title: MiddleName
|
663
597
|
type: string
|
664
598
|
minLength: 1
|
665
599
|
maxLength: 128
|
666
|
-
pattern:
|
667
|
-
^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control}
|
668
|
-
.,''-]{1,128}$
|
600
|
+
pattern: ^(?!\s*$)[\p{L}\p{gc=Mark}\p{digit}\p{gc=Connector_Punctuation}\p{Join_Control} .,''-]{1,128}$
|
669
601
|
description: Middle name of the Party (Name Type).
|
670
602
|
example: Johannes
|
671
603
|
amountCurrency:
|
@@ -686,8 +618,7 @@ components:
|
|
686
618
|
type: string
|
687
619
|
bulkQuoteId:
|
688
620
|
description: A Mojaloop API bulk quote identifier (UUID).
|
689
|
-
pattern:
|
690
|
-
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
621
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
691
622
|
type: string
|
692
623
|
bulkQuoteRequest:
|
693
624
|
description: A request for a bulk quote.
|
@@ -719,9 +650,7 @@ components:
|
|
719
650
|
expiration:
|
720
651
|
$ref: '#/components/schemas/timestamp'
|
721
652
|
individualQuoteResults:
|
722
|
-
description:
|
723
|
-
Fees for each individual transaction, if any of them are charged per
|
724
|
-
transaction.
|
653
|
+
description: Fees for each individual transaction, if any of them are charged per transaction.
|
725
654
|
items:
|
726
655
|
oneOf:
|
727
656
|
- $ref: '#/components/schemas/IndividualQuoteResultSuccess'
|
@@ -735,8 +664,7 @@ components:
|
|
735
664
|
type: object
|
736
665
|
bulkTransferId:
|
737
666
|
description: A Mojaloop API transfer identifier (UUID).
|
738
|
-
pattern:
|
739
|
-
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
667
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
740
668
|
type: string
|
741
669
|
bulkTransferRequest:
|
742
670
|
properties:
|
@@ -761,9 +689,7 @@ components:
|
|
761
689
|
bulkTransferId:
|
762
690
|
$ref: '#/components/schemas/bulkTransferId'
|
763
691
|
homeTransactionId:
|
764
|
-
description:
|
765
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
766
|
-
between the switch and DFSP backend systems.
|
692
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the switch and DFSP backend systems.
|
767
693
|
type: string
|
768
694
|
individualTransferResults:
|
769
695
|
items:
|
@@ -945,18 +871,11 @@ components:
|
|
945
871
|
type: string
|
946
872
|
dateOfBirth:
|
947
873
|
description: Date of birth in the form YYYY-MM-DD.
|
948
|
-
pattern:
|
949
|
-
^(?:[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)$
|
874
|
+
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)$
|
950
875
|
type: string
|
951
876
|
errorCode:
|
952
|
-
description:
|
953
|
-
The API data type errorCode is a JSON String of four characters,
|
954
|
-
consisting of digits only. Negative numbers are not allowed. A leading
|
955
|
-
zero is not allowed. Each error code in the API is a four-digit number,
|
956
|
-
for example, 1234, where the first number (1 in the example) represents
|
957
|
-
the high-level error category, the second number (2 in the example)
|
958
|
-
represents the low-level error category, and the last two numbers (34 in
|
959
|
-
the example) represents the specific error.
|
877
|
+
description: |
|
878
|
+
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) represents the specific error.
|
960
879
|
pattern: ^[1-9]\d{3}$
|
961
880
|
title: ErrorCode
|
962
881
|
type: string
|
@@ -986,13 +905,9 @@ components:
|
|
986
905
|
description: Error message text
|
987
906
|
type: string
|
988
907
|
statusCode:
|
989
|
-
description:
|
990
|
-
Backend error code from FSP. Ideally, statusCode is FSPIOP
|
991
|
-
|
992
|
-
with the same code.
|
993
|
-
|
994
|
-
Otherwise, a suitable generic FSPIOP will be used with the
|
995
|
-
errorResponse in the FSPIOP error message.
|
908
|
+
description: |
|
909
|
+
Backend error code from FSP. Ideally, statusCode is FSPIOP conforming. SDK will use status code to retrieve an FSPIOP error with the same code.
|
910
|
+
Otherwise, a suitable generic FSPIOP will be used with the errorResponse in the FSPIOP error message.
|
996
911
|
type: string
|
997
912
|
type: object
|
998
913
|
extensionItem:
|
@@ -1101,14 +1016,10 @@ components:
|
|
1101
1016
|
title: TransfersIDPatchResponse
|
1102
1017
|
type: object
|
1103
1018
|
generalError:
|
1104
|
-
description:
|
1105
|
-
This object may represent a number of different error object types and
|
1106
|
-
so its properties may vary significantly.
|
1019
|
+
description: This object may represent a number of different error object types and so its properties may vary significantly.
|
1107
1020
|
type: object
|
1108
1021
|
geoCode:
|
1109
|
-
description:
|
1110
|
-
Indicates the geographic location from where the transaction was
|
1111
|
-
initiated.
|
1022
|
+
description: Indicates the geographic location from where the transaction was initiated.
|
1112
1023
|
properties:
|
1113
1024
|
latitude:
|
1114
1025
|
$ref: '#/components/schemas/latitude'
|
@@ -1175,18 +1086,12 @@ components:
|
|
1175
1086
|
- DEVICE
|
1176
1087
|
type: string
|
1177
1088
|
latitude:
|
1178
|
-
description:
|
1179
|
-
|
1180
|
-
restricted by a regular expression for interoperability reasons.
|
1181
|
-
pattern: >-
|
1182
|
-
^(\+|-)?(?:90(?:(?:\.0{1,6})?)|(?:[0-9]|[1-8][0-9])(?:(?:\.[0-9]{1,6})?))$
|
1089
|
+
description: The API data type Latitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
|
1090
|
+
pattern: ^(\+|-)?(?:90(?:(?:\.0{1,6})?)|(?:[0-9]|[1-8][0-9])(?:(?:\.[0-9]{1,6})?))$
|
1183
1091
|
type: string
|
1184
1092
|
longitude:
|
1185
|
-
description:
|
1186
|
-
|
1187
|
-
restricted by a regular expression for interoperability reasons.
|
1188
|
-
pattern: >-
|
1189
|
-
^(\+|-)?(?:180(?:(?:\.0{1,6})?)|(?:[0-9]|[1-9][0-9]|1[0-7][0-9])(?:(?:\.[0-9]{1,6})?))$
|
1093
|
+
description: The API data type Longitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
|
1094
|
+
pattern: ^(\+|-)?(?:180(?:(?:\.0{1,6})?)|(?:[0-9]|[1-9][0-9]|1[0-7][0-9])(?:(?:\.[0-9]{1,6})?))$
|
1190
1095
|
type: string
|
1191
1096
|
money:
|
1192
1097
|
pattern: ^([0]|([1-9][0-9]{0,17}))([.][0-9]{0,3}[1-9])?$
|
@@ -1213,17 +1118,14 @@ components:
|
|
1213
1118
|
type: string
|
1214
1119
|
quoteId:
|
1215
1120
|
description: A Mojaloop API quote identifier (UUID).
|
1216
|
-
pattern:
|
1217
|
-
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1121
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1218
1122
|
type: string
|
1219
1123
|
quoteRequest:
|
1220
1124
|
description: A request for a quote for transfer from the DFSP backend.
|
1221
1125
|
properties:
|
1222
1126
|
homeR2PTransactionId:
|
1223
1127
|
type: string
|
1224
|
-
description:
|
1225
|
-
Linked homeR2PTransactionId which was generated as part of POST
|
1226
|
-
/requestToPay to SDK incase of requestToPay transfer.
|
1128
|
+
description: Linked homeR2PTransactionId which was generated as part of POST /requestToPay to SDK incase of requestToPay transfer.
|
1227
1129
|
amount:
|
1228
1130
|
$ref: '#/components/schemas/money'
|
1229
1131
|
amountType:
|
@@ -1316,15 +1218,11 @@ components:
|
|
1316
1218
|
type: string
|
1317
1219
|
timestamp:
|
1318
1220
|
description: An ISO-8601 formatted timestamp.
|
1319
|
-
pattern:
|
1320
|
-
^(?:[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)$
|
1221
|
+
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)$
|
1321
1222
|
type: string
|
1322
1223
|
transactionId:
|
1323
|
-
description:
|
1324
|
-
|
1325
|
-
creation of the quote.
|
1326
|
-
pattern: >-
|
1327
|
-
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1224
|
+
description: ID of the transaction, the ID is decided by the Payer FSP during the creation of the quote.
|
1225
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1328
1226
|
type: string
|
1329
1227
|
transactionRequest:
|
1330
1228
|
description: A request for a pull based transfer.
|
@@ -1370,17 +1268,14 @@ components:
|
|
1370
1268
|
type: object
|
1371
1269
|
transactionRequestId:
|
1372
1270
|
description: A Mojaloop API transaction request identifier (UUID).
|
1373
|
-
pattern:
|
1374
|
-
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1271
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1375
1272
|
type: string
|
1376
1273
|
transactionRequestResponse:
|
1377
1274
|
description: A response to a request for a quote.
|
1378
1275
|
properties:
|
1379
1276
|
homeR2PTransactionId:
|
1380
1277
|
type: string
|
1381
|
-
description:
|
1382
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
1383
|
-
between the Switch and DFSP backend systems.
|
1278
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
|
1384
1279
|
transactionId:
|
1385
1280
|
$ref: '#/components/schemas/transactionId'
|
1386
1281
|
transactionRequestState:
|
@@ -1397,9 +1292,7 @@ components:
|
|
1397
1292
|
- REJECTED
|
1398
1293
|
type: string
|
1399
1294
|
transactionSubScenario:
|
1400
|
-
description:
|
1401
|
-
Possible sub-scenario, defined locally within the scheme (UndefinedEnum
|
1402
|
-
Type). Based on FSPIOP TransactionSubScenario.
|
1295
|
+
description: Possible sub-scenario, defined locally within the scheme (UndefinedEnum Type). Based on FSPIOP TransactionSubScenario.
|
1403
1296
|
example: LOCALLY_DEFINED_SUBSCENARIO
|
1404
1297
|
pattern: ^[A-Z_]{1,32}$
|
1405
1298
|
title: transactionSubScenario
|
@@ -1439,9 +1332,7 @@ components:
|
|
1439
1332
|
from:
|
1440
1333
|
$ref: '#/components/schemas/transferParty'
|
1441
1334
|
homeTransactionId:
|
1442
|
-
description:
|
1443
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
1444
|
-
between the Switch and DFSP backend systems.
|
1335
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
|
1445
1336
|
type: string
|
1446
1337
|
note:
|
1447
1338
|
maxLength: 128
|
@@ -1469,8 +1360,7 @@ components:
|
|
1469
1360
|
type: object
|
1470
1361
|
transferId:
|
1471
1362
|
description: A Mojaloop API transfer identifier (UUID).
|
1472
|
-
pattern:
|
1473
|
-
^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1363
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1474
1364
|
type: string
|
1475
1365
|
transferParty:
|
1476
1366
|
properties:
|
@@ -1498,9 +1388,7 @@ components:
|
|
1498
1388
|
description: Party last name.
|
1499
1389
|
type: string
|
1500
1390
|
merchantClassificationCode:
|
1501
|
-
description:
|
1502
|
-
Up to 4 digits specifying the sender's merchant classification, if
|
1503
|
-
known and applicable.
|
1391
|
+
description: Up to 4 digits specifying the sender's merchant classification, if known and applicable.
|
1504
1392
|
type: string
|
1505
1393
|
middleName:
|
1506
1394
|
description: Party middle name.
|
@@ -1515,9 +1403,7 @@ components:
|
|
1515
1403
|
properties:
|
1516
1404
|
homeR2PTransactionId:
|
1517
1405
|
type: string
|
1518
|
-
description:
|
1519
|
-
Linked homeR2PTransactionId which was generated as part of POST
|
1520
|
-
/requestToPay to SDK incase of requestToPay transfer.
|
1406
|
+
description: Linked homeR2PTransactionId which was generated as part of POST /requestToPay to SDK incase of requestToPay transfer.
|
1521
1407
|
amount:
|
1522
1408
|
$ref: '#/components/schemas/money'
|
1523
1409
|
amountType:
|
@@ -1568,9 +1454,7 @@ components:
|
|
1568
1454
|
fulfilment:
|
1569
1455
|
$ref: '#/components/schemas/IlpFulfilment'
|
1570
1456
|
homeTransactionId:
|
1571
|
-
description:
|
1572
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
1573
|
-
between the Switch and DFSP backend systems.
|
1457
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
|
1574
1458
|
type: string
|
1575
1459
|
transferState:
|
1576
1460
|
$ref: '#/components/schemas/transferState'
|
@@ -1578,12 +1462,8 @@ components:
|
|
1578
1462
|
- homeTransactionId
|
1579
1463
|
type: object
|
1580
1464
|
transferState:
|
1581
|
-
description:
|
1582
|
-
Below are the allowed values for the enumeration - RECEIVED DFSP has
|
1583
|
-
received the transfer. - RESERVED DFSP has reserved the transfer. -
|
1584
|
-
COMMITTED DFSP has successfully performed the transfer. - ABORTED DFSP
|
1585
|
-
has aborted the transfer due a rejection or failure to perform the
|
1586
|
-
transfer.
|
1465
|
+
description: |
|
1466
|
+
Below are the allowed values for the enumeration - RECEIVED DFSP has received the transfer. - RESERVED DFSP has reserved the transfer. - COMMITTED DFSP has successfully performed the transfer. - ABORTED DFSP has aborted the transfer due a rejection or failure to perform the transfer.
|
1587
1467
|
enum:
|
1588
1468
|
- RECEIVED
|
1589
1469
|
- RESERVED
|
@@ -1602,9 +1482,7 @@ components:
|
|
1602
1482
|
properties:
|
1603
1483
|
homeR2PTransactionId:
|
1604
1484
|
type: string
|
1605
|
-
description:
|
1606
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
1607
|
-
between the Switch and DFSP backend systems.
|
1485
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
|
1608
1486
|
transactionRequestState:
|
1609
1487
|
$ref: '#/components/schemas/transactionRequestState'
|
1610
1488
|
required:
|
@@ -1613,22 +1491,13 @@ components:
|
|
1613
1491
|
title: TransactionSubScenario
|
1614
1492
|
type: string
|
1615
1493
|
pattern: ^[A-Z_]{1,32}$
|
1616
|
-
description:
|
1617
|
-
Possible sub-scenario, defined locally within the scheme (UndefinedEnum
|
1618
|
-
Type).
|
1494
|
+
description: Possible sub-scenario, defined locally within the scheme (UndefinedEnum Type).
|
1619
1495
|
example: LOCALLY_DEFINED_SUBSCENARIO
|
1620
1496
|
CorrelationId:
|
1621
1497
|
title: CorrelationId
|
1622
1498
|
type: string
|
1623
|
-
pattern:
|
1624
|
-
|
1625
|
-
description: >-
|
1626
|
-
Identifier that correlates all messages of the same sequence. The API
|
1627
|
-
data type UUID (Universally Unique Identifier) is a JSON String in
|
1628
|
-
canonical format, conforming to [RFC
|
1629
|
-
4122](https://tools.ietf.org/html/rfc4122), that is restricted by a
|
1630
|
-
regular expression for interoperability reasons. A UUID is always 36
|
1631
|
-
characters long, 32 hexadecimal symbols and 4 dashes (‘-‘).
|
1499
|
+
pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
|
1500
|
+
description: Identifier that correlates all messages of the same sequence. The API data type UUID (Universally Unique Identifier) is a JSON String in canonical format, conforming to [RFC 4122](https://tools.ietf.org/html/rfc4122), that is restricted by a regular expression for interoperability reasons. A UUID is always 36 characters long, 32 hexadecimal symbols and 4 dashes (‘-‘).
|
1632
1501
|
example: b51ec534-ee48-4575-b6a9-ead2955b8069
|
1633
1502
|
bulkTransactionStatus:
|
1634
1503
|
type: string
|
@@ -1649,11 +1518,7 @@ components:
|
|
1649
1518
|
- true
|
1650
1519
|
Currency:
|
1651
1520
|
title: Currency
|
1652
|
-
description:
|
1653
|
-
The currency codes defined in [ISO
|
1654
|
-
4217](https://www.iso.org/iso-4217-currency-codes.html) as three-letter
|
1655
|
-
alphabetic codes are used as the standard naming representation for
|
1656
|
-
currencies.
|
1521
|
+
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.
|
1657
1522
|
type: string
|
1658
1523
|
minLength: 3
|
1659
1524
|
maxLength: 3
|
@@ -1826,13 +1691,7 @@ components:
|
|
1826
1691
|
title: Amount
|
1827
1692
|
type: string
|
1828
1693
|
pattern: ^([0]|([1-9][0-9]{0,17}))([.][0-9]{0,3}[1-9])?$
|
1829
|
-
description:
|
1830
|
-
The API data type Amount is a JSON String in a canonical format that is
|
1831
|
-
restricted by a regular expression for interoperability reasons. This
|
1832
|
-
pattern does not allow any trailing zeroes at all, but allows an amount
|
1833
|
-
without a minor currency unit. It also only allows four digits in the
|
1834
|
-
minor currency unit; a negative value is not allowed. Using more than 18
|
1835
|
-
digits in the major currency unit is not allowed.
|
1694
|
+
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.
|
1836
1695
|
example: '123.45'
|
1837
1696
|
bulkPerTransferFeeLimit:
|
1838
1697
|
type: object
|
@@ -1862,17 +1721,8 @@ components:
|
|
1862
1721
|
DateTime:
|
1863
1722
|
title: DateTime
|
1864
1723
|
type: string
|
1865
|
-
pattern:
|
1866
|
-
|
1867
|
-
description: >-
|
1868
|
-
The API data type DateTime is a JSON String in a lexical format that is
|
1869
|
-
restricted by a regular expression for interoperability reasons. The
|
1870
|
-
format is according to [ISO
|
1871
|
-
8601](https://www.iso.org/iso-8601-date-and-time-format.html), expressed
|
1872
|
-
in a combined date, time and time zone format. A more readable version
|
1873
|
-
of the format is yyyy-MM-ddTHH:mm:ss.SSS[-HH:MM]. Examples are
|
1874
|
-
"2016-05-24T08:38:08.699-04:00", "2016-05-24T08:38:08.699Z" (where Z
|
1875
|
-
indicates Zulu time zone, same as UTC).
|
1724
|
+
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)$
|
1725
|
+
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).
|
1876
1726
|
example: '2016-05-24T08:38:08.699-04:00'
|
1877
1727
|
bulkTransactionOptions:
|
1878
1728
|
type: object
|
@@ -1882,33 +1732,20 @@ components:
|
|
1882
1732
|
- bulkExpiration
|
1883
1733
|
properties:
|
1884
1734
|
onlyValidateParty:
|
1885
|
-
description:
|
1886
|
-
Set to true if only party validation is required. This means the
|
1887
|
-
quotes and transfers will not run. This is useful for only party
|
1888
|
-
resolution.
|
1735
|
+
description: Set to true if only party validation is required. This means the quotes and transfers will not run. This is useful for only party resolution.
|
1889
1736
|
type: boolean
|
1890
1737
|
autoAcceptParty:
|
1891
1738
|
$ref: '#/components/schemas/autoAcceptPartyOption'
|
1892
1739
|
autoAcceptQuote:
|
1893
|
-
description:
|
1894
|
-
Set to true if the quote response is accepted without confirmation
|
1895
|
-
from the payer. The fees applied by the payee will be acceptable to
|
1896
|
-
the payer abiding by the limits set by optional
|
1897
|
-
'perTransferFeeLimits' array.
|
1740
|
+
description: Set to true if the quote response is accepted without confirmation from the payer. The fees applied by the payee will be acceptable to the payer abiding by the limits set by optional 'perTransferFeeLimits' array.
|
1898
1741
|
type: object
|
1899
1742
|
oneOf:
|
1900
1743
|
- $ref: '#/components/schemas/autoAcceptQuote'
|
1901
1744
|
skipPartyLookup:
|
1902
|
-
description:
|
1903
|
-
Set to true if supplying an FSPID for the payee party and no party
|
1904
|
-
resolution is needed. This may be useful if a previous party
|
1905
|
-
resolution has been performed.
|
1745
|
+
description: Set to true if supplying an FSPID for the payee party and no party resolution is needed. This may be useful if a previous party resolution has been performed.
|
1906
1746
|
type: boolean
|
1907
1747
|
synchronous:
|
1908
|
-
description:
|
1909
|
-
Set to true if the bulkTransfer requests need be handled
|
1910
|
-
synchronous. Otherwise the requests will be handled asynchronously,
|
1911
|
-
meaning there will be callbacks whenever the processing is done
|
1748
|
+
description: Set to true if the bulkTransfer requests need be handled synchronous. Otherwise the requests will be handled asynchronously, meaning there will be callbacks whenever the processing is done
|
1912
1749
|
type: boolean
|
1913
1750
|
bulkExpiration:
|
1914
1751
|
$ref: '#/components/schemas/DateTime'
|
@@ -1924,52 +1761,16 @@ components:
|
|
1924
1761
|
- ACCOUNT_ID
|
1925
1762
|
- IBAN
|
1926
1763
|
- ALIAS
|
1927
|
-
description:
|
1764
|
+
description: |-
|
1928
1765
|
Below are the allowed values for the enumeration.
|
1929
|
-
|
1930
|
-
-
|
1931
|
-
|
1932
|
-
participant. The
|
1933
|
-
|
1934
|
-
|
1935
|
-
|
1936
|
-
|
1937
|
-
|
1938
|
-
- EMAIL - An email is used as reference to a participant. The format of
|
1939
|
-
the email should be according to the informational [RFC
|
1940
|
-
3696](https://tools.ietf.org/html/rfc3696).
|
1941
|
-
|
1942
|
-
- PERSONAL_ID - A personal identifier is used as reference to a
|
1943
|
-
participant. Examples of personal identification are passport number,
|
1944
|
-
birth certificate number, and national registration number. The
|
1945
|
-
identifier number is added in the PartyIdentifier element. The personal
|
1946
|
-
identifier type is added in the PartySubIdOrType element.
|
1947
|
-
|
1948
|
-
- BUSINESS - A specific Business (for example, an organization or a
|
1949
|
-
company) is used as reference to a participant. The BUSINESS identifier
|
1950
|
-
can be in any format. To make a transaction connected to a specific
|
1951
|
-
username or bill number in a Business, the PartySubIdOrType element
|
1952
|
-
should be used.
|
1953
|
-
|
1954
|
-
- DEVICE - A specific device (for example, a POS or ATM) ID connected to
|
1955
|
-
a specific business or organization is used as reference to a Party. For
|
1956
|
-
referencing a specific device under a specific business or organization,
|
1957
|
-
use the PartySubIdOrType element.
|
1958
|
-
|
1959
|
-
- ACCOUNT_ID - A bank account number or FSP account ID should be used as
|
1960
|
-
reference to a participant. The ACCOUNT_ID identifier can be in any
|
1961
|
-
format, as formats can greatly differ depending on country and FSP.
|
1962
|
-
|
1963
|
-
- IBAN - A bank account number or FSP account ID is used as reference to
|
1964
|
-
a participant. The IBAN identifier can consist of up to 34 alphanumeric
|
1965
|
-
characters and should be entered without whitespace.
|
1966
|
-
|
1967
|
-
- ALIAS An alias is used as reference to a participant. The alias should
|
1968
|
-
be created in the FSP as an alternative reference to an account owner.
|
1969
|
-
Another example of an alias is a username in the FSP system. The ALIAS
|
1970
|
-
identifier can be in any format. It is also possible to use the
|
1971
|
-
PartySubIdOrType element for identifying an account under an Alias
|
1972
|
-
defined by the PartyIdentifier.
|
1766
|
+
- 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.
|
1767
|
+
- EMAIL - An email is used as reference to a participant. The format of the email should be according to the informational [RFC 3696](https://tools.ietf.org/html/rfc3696).
|
1768
|
+
- PERSONAL_ID - A personal identifier is used as reference to a participant. Examples of personal identification are passport number, birth certificate number, and national registration number. The identifier number is added in the PartyIdentifier element. The personal identifier type is added in the PartySubIdOrType element.
|
1769
|
+
- BUSINESS - A specific Business (for example, an organization or a company) is used as reference to a participant. The BUSINESS identifier can be in any format. To make a transaction connected to a specific username or bill number in a Business, the PartySubIdOrType element should be used.
|
1770
|
+
- DEVICE - A specific device (for example, a POS or ATM) ID connected to a specific business or organization is used as reference to a Party. For referencing a specific device under a specific business or organization, use the PartySubIdOrType element.
|
1771
|
+
- 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.
|
1772
|
+
- IBAN - A bank account number or FSP account ID is used as reference to a participant. The IBAN identifier can consist of up to 34 alphanumeric characters and should be entered without whitespace.
|
1773
|
+
- ALIAS An alias is used as reference to a participant. The alias should be created in the FSP as an alternative reference to an account owner. Another example of an alias is a username in the FSP system. The ALIAS identifier can be in any format. It is also possible to use the PartySubIdOrType element for identifying an account under an Alias defined by the PartyIdentifier.
|
1973
1774
|
PartyIdentifier:
|
1974
1775
|
title: PartyIdentifier
|
1975
1776
|
type: string
|
@@ -1982,9 +1783,7 @@ components:
|
|
1982
1783
|
type: string
|
1983
1784
|
minLength: 1
|
1984
1785
|
maxLength: 128
|
1985
|
-
description:
|
1986
|
-
Either a sub-identifier of a PartyIdentifier, or a sub-type of the
|
1987
|
-
PartyIdType, normally a PersonalIdentifierType.
|
1786
|
+
description: Either a sub-identifier of a PartyIdentifier, or a sub-type of the PartyIdType, normally a PersonalIdentifierType.
|
1988
1787
|
ExtensionKey:
|
1989
1788
|
title: ExtensionKey
|
1990
1789
|
type: string
|
@@ -2012,9 +1811,7 @@ components:
|
|
2012
1811
|
ExtensionList:
|
2013
1812
|
title: ExtensionList
|
2014
1813
|
type: object
|
2015
|
-
description:
|
2016
|
-
Data model for the complex type ExtensionList. An optional list of
|
2017
|
-
extensions, specific to deployment.
|
1814
|
+
description: Data model for the complex type ExtensionList. An optional list of extensions, specific to deployment.
|
2018
1815
|
properties:
|
2019
1816
|
extension:
|
2020
1817
|
type: array
|
@@ -2028,9 +1825,7 @@ components:
|
|
2028
1825
|
PartyIdInfo:
|
2029
1826
|
title: PartyIdInfo
|
2030
1827
|
type: object
|
2031
|
-
description:
|
2032
|
-
Data model for the complex type PartyIdInfo. An ExtensionList element
|
2033
|
-
has been added to this reqeust in version v1.1
|
1828
|
+
description: Data model for the complex type PartyIdInfo. An ExtensionList element has been added to this reqeust in version v1.1
|
2034
1829
|
properties:
|
2035
1830
|
partyIdType:
|
2036
1831
|
$ref: '#/components/schemas/PartyIdType'
|
@@ -2092,14 +1887,10 @@ components:
|
|
2092
1887
|
enum:
|
2093
1888
|
- SEND
|
2094
1889
|
- RECEIVE
|
2095
|
-
description:
|
1890
|
+
description: |-
|
2096
1891
|
Below are the allowed values for the enumeration AmountType.
|
2097
|
-
|
2098
|
-
-
|
2099
|
-
should be withdrawn from the Payer account including any fees.
|
2100
|
-
|
2101
|
-
- RECEIVE - Amount the Payer would like the Payee to receive, that is,
|
2102
|
-
the amount that should be sent to the receiver exclusive of any fees.
|
1892
|
+
- SEND - Amount the Payer would like to send, that is, the amount that should be withdrawn from the Payer account including any fees.
|
1893
|
+
- 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.
|
2103
1894
|
example: RECEIVE
|
2104
1895
|
Note:
|
2105
1896
|
title: Note
|
@@ -2123,27 +1914,19 @@ components:
|
|
2123
1914
|
Latitude:
|
2124
1915
|
title: Latitude
|
2125
1916
|
type: string
|
2126
|
-
pattern:
|
2127
|
-
|
2128
|
-
description: >-
|
2129
|
-
The API data type Latitude is a JSON String in a lexical format that is
|
2130
|
-
restricted by a regular expression for interoperability reasons.
|
1917
|
+
pattern: ^(\+|-)?(?:90(?:(?:\.0{1,6})?)|(?:[0-9]|[1-8][0-9])(?:(?:\.[0-9]{1,6})?))$
|
1918
|
+
description: The API data type Latitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
|
2131
1919
|
example: '+45.4215'
|
2132
1920
|
Longitude:
|
2133
1921
|
title: Longitude
|
2134
1922
|
type: string
|
2135
|
-
pattern:
|
2136
|
-
|
2137
|
-
description: >-
|
2138
|
-
The API data type Longitude is a JSON String in a lexical format that is
|
2139
|
-
restricted by a regular expression for interoperability reasons.
|
1923
|
+
pattern: ^(\+|-)?(?:180(?:(?:\.0{1,6})?)|(?:[0-9]|[1-9][0-9]|1[0-7][0-9])(?:(?:\.[0-9]{1,6})?))$
|
1924
|
+
description: The API data type Longitude is a JSON String in a lexical format that is restricted by a regular expression for interoperability reasons.
|
2140
1925
|
example: '+75.6972'
|
2141
1926
|
GeoCode:
|
2142
1927
|
title: GeoCode
|
2143
1928
|
type: object
|
2144
|
-
description:
|
2145
|
-
Data model for the complex type GeoCode. Indicates the geographic
|
2146
|
-
location from where the transaction was initiated.
|
1929
|
+
description: Data model for the complex type GeoCode. Indicates the geographic location from where the transaction was initiated.
|
2147
1930
|
properties:
|
2148
1931
|
latitude:
|
2149
1932
|
$ref: '#/components/schemas/Latitude'
|
@@ -2159,8 +1942,7 @@ components:
|
|
2159
1942
|
minLength: 1
|
2160
1943
|
maxLength: 32768
|
2161
1944
|
description: Information for recipient (transport layer information).
|
2162
|
-
example:
|
2163
|
-
AYIBgQAAAAAAAASwNGxldmVsb25lLmRmc3AxLm1lci45T2RTOF81MDdqUUZERmZlakgyOVc4bXFmNEpLMHlGTFGCAUBQU0svMS4wCk5vbmNlOiB1SXlweUYzY3pYSXBFdzVVc05TYWh3CkVuY3J5cHRpb246IG5vbmUKUGF5bWVudC1JZDogMTMyMzZhM2ItOGZhOC00MTYzLTg0NDctNGMzZWQzZGE5OGE3CgpDb250ZW50LUxlbmd0aDogMTM1CkNvbnRlbnQtVHlwZTogYXBwbGljYXRpb24vanNvbgpTZW5kZXItSWRlbnRpZmllcjogOTI4MDYzOTEKCiJ7XCJmZWVcIjowLFwidHJhbnNmZXJDb2RlXCI6XCJpbnZvaWNlXCIsXCJkZWJpdE5hbWVcIjpcImFsaWNlIGNvb3BlclwiLFwiY3JlZGl0TmFtZVwiOlwibWVyIGNoYW50XCIsXCJkZWJpdElkZW50aWZpZXJcIjpcIjkyODA2MzkxXCJ9IgA
|
1945
|
+
example: AYIBgQAAAAAAAASwNGxldmVsb25lLmRmc3AxLm1lci45T2RTOF81MDdqUUZERmZlakgyOVc4bXFmNEpLMHlGTFGCAUBQU0svMS4wCk5vbmNlOiB1SXlweUYzY3pYSXBFdzVVc05TYWh3CkVuY3J5cHRpb246IG5vbmUKUGF5bWVudC1JZDogMTMyMzZhM2ItOGZhOC00MTYzLTg0NDctNGMzZWQzZGE5OGE3CgpDb250ZW50LUxlbmd0aDogMTM1CkNvbnRlbnQtVHlwZTogYXBwbGljYXRpb24vanNvbgpTZW5kZXItSWRlbnRpZmllcjogOTI4MDYzOTEKCiJ7XCJmZWVcIjowLFwidHJhbnNmZXJDb2RlXCI6XCJpbnZvaWNlXCIsXCJkZWJpdE5hbWVcIjpcImFsaWNlIGNvb3BlclwiLFwiY3JlZGl0TmFtZVwiOlwibWVyIGNoYW50XCIsXCJkZWJpdElkZW50aWZpZXJcIjpcIjkyODA2MzkxXCJ9IgA
|
2164
1946
|
IlpCondition:
|
2165
1947
|
title: IlpCondition
|
2166
1948
|
type: string
|
@@ -2171,14 +1953,7 @@ components:
|
|
2171
1953
|
title: ErrorCode
|
2172
1954
|
type: string
|
2173
1955
|
pattern: ^[1-9]\d{3}$
|
2174
|
-
description:
|
2175
|
-
The API data type ErrorCode is a JSON String of four characters,
|
2176
|
-
consisting of digits only. Negative numbers are not allowed. A leading
|
2177
|
-
zero is not allowed. Each error code in the API is a four-digit number,
|
2178
|
-
for example, 1234, where the first number (1 in the example) represents
|
2179
|
-
the high-level error category, the second number (2 in the example)
|
2180
|
-
represents the low-level error category, and the last two numbers (34 in
|
2181
|
-
the example) represent the specific error.
|
1956
|
+
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.
|
2182
1957
|
example: '5100'
|
2183
1958
|
ErrorDescription:
|
2184
1959
|
title: ErrorDescription
|
@@ -2207,15 +1982,11 @@ components:
|
|
2207
1982
|
$ref: '#/components/schemas/ErrorInformation'
|
2208
1983
|
quoteError:
|
2209
1984
|
type: object
|
2210
|
-
description:
|
2211
|
-
This object represents a Mojaloop API error received at any time during
|
2212
|
-
the quote process
|
1985
|
+
description: This object represents a Mojaloop API error received at any time during the quote process
|
2213
1986
|
properties:
|
2214
1987
|
httpStatusCode:
|
2215
1988
|
type: integer
|
2216
|
-
description:
|
2217
|
-
The HTTP status code returned to the caller. This is the same as the
|
2218
|
-
actual HTTP status code returned with the response.
|
1989
|
+
description: The HTTP status code returned to the caller. This is the same as the actual HTTP status code returned with the response.
|
2219
1990
|
mojaloopError:
|
2220
1991
|
$ref: '#/components/schemas/mojaloopError'
|
2221
1992
|
individualQuoteResult:
|
@@ -2258,30 +2029,20 @@ components:
|
|
2258
2029
|
- RESERVED
|
2259
2030
|
- COMMITTED
|
2260
2031
|
- ABORTED
|
2261
|
-
description:
|
2032
|
+
description: |-
|
2262
2033
|
Below are the allowed values for the enumeration.
|
2263
|
-
|
2264
2034
|
- RECEIVED - Next ledger has received the transfer.
|
2265
|
-
|
2266
2035
|
- RESERVED - Next ledger has reserved the transfer.
|
2267
|
-
|
2268
2036
|
- COMMITTED - Next ledger has successfully performed the transfer.
|
2269
|
-
|
2270
|
-
- ABORTED - Next ledger has aborted the transfer due to a rejection or
|
2271
|
-
failure to perform the transfer.
|
2037
|
+
- ABORTED - Next ledger has aborted the transfer due to a rejection or failure to perform the transfer.
|
2272
2038
|
example: RESERVED
|
2273
2039
|
transferError:
|
2274
2040
|
type: object
|
2275
|
-
description:
|
2276
|
-
This may be a Mojaloop API error returned from another entity in the
|
2277
|
-
scheme or an object representing other types of error e.g. exceptions
|
2278
|
-
that may occur inside the scheme adapter.
|
2041
|
+
description: This may be a Mojaloop API error returned from another entity in the scheme or an object representing other types of error e.g. exceptions that may occur inside the scheme adapter.
|
2279
2042
|
properties:
|
2280
2043
|
httpStatusCode:
|
2281
2044
|
type: integer
|
2282
|
-
description:
|
2283
|
-
The HTTP status code returned to the caller. This is the same as the
|
2284
|
-
actual HTTP status code returned with the response.
|
2045
|
+
description: The HTTP status code returned to the caller. This is the same as the actual HTTP status code returned with the response.
|
2285
2046
|
mojaloopError:
|
2286
2047
|
$ref: '#/components/schemas/mojaloopError'
|
2287
2048
|
individualTransferResult:
|
@@ -2308,9 +2069,7 @@ components:
|
|
2308
2069
|
$ref: '#/components/schemas/CorrelationId'
|
2309
2070
|
homeTransactionId:
|
2310
2071
|
type: string
|
2311
|
-
description:
|
2312
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
2313
|
-
between the Switch and DFSP backend systems.
|
2072
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
|
2314
2073
|
transactionId:
|
2315
2074
|
$ref: '#/components/schemas/CorrelationId'
|
2316
2075
|
to:
|
@@ -2349,9 +2108,7 @@ components:
|
|
2349
2108
|
properties:
|
2350
2109
|
bulkHomeTransactionID:
|
2351
2110
|
type: string
|
2352
|
-
description:
|
2353
|
-
Transaction ID from the DFSP backend, used to reconcile transactions
|
2354
|
-
between the Switch and DFSP backend systems.
|
2111
|
+
description: Transaction ID from the DFSP backend, used to reconcile transactions between the Switch and DFSP backend systems.
|
2355
2112
|
bulkTransactionId:
|
2356
2113
|
$ref: '#/components/schemas/CorrelationId'
|
2357
2114
|
currentState:
|