Worked on the Notification Callback Request and Notification Callback Response

This commit is contained in:
Azeez Muibi
2025-03-19 16:17:49 +01:00
parent f780a037a5
commit d06a257660
+97 -28
View File
@@ -361,29 +361,18 @@
}, },
"/NotificationCallback": { "/NotificationCallback": {
"post": { "post": {
"tags": [ "tags": [
"NotificationCallback" "NotificationCallback"
], ],
"summary": "Loan Information Request ", "summary": "Notification Callback",
"description": "Loan Information Request", "description": "This new feature will be used for informing Simbrella about status of the transactions that FBN have processed",
"operationId": "startEligibilityCheck", "operationId": "notificationCallback",
"requestBody": { "requestBody": {
"description": "Post JSON to conduct eligibility tests", "description": "Post JSON for notification callback",
"content": { "content": {
"application/json": { "application/json": {
"schema": { "schema": {
"$ref": "#/components/schemas/LoanInformationRequest" "$ref": "#/components/schemas/NotificationCallbackRequest"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/LoanInformationRequest"
}
},
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/LoanInformationRequest"
} }
} }
}, },
@@ -395,21 +384,16 @@
"content": { "content": {
"application/json": { "application/json": {
"schema": { "schema": {
"$ref": "#/components/schemas/LoanInformationResponse" "$ref": "#/components/schemas/NotificationCallbackResponse"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/LoanInformationResponse"
} }
} }
} }
}, },
"400": { "400": {
"description": "Invalid ID supplied" "description": "Invalid request parameters"
}, },
"404": { "404": {
"description": "Loan not found" "description": "Resource not found"
}, },
"422": { "422": {
"description": "Validation exception" "description": "Validation exception"
@@ -417,10 +401,7 @@
}, },
"security": [ "security": [
{ {
"petstore_auth": [ "basicAuth": []
"write:pets",
"read:pets"
]
} }
] ]
} }
@@ -1136,6 +1117,94 @@
"description": "Description of provided result code" "description": "Description of provided result code"
} }
} }
},
"NotificationCallbackRequest": {
"type": "object",
"required": [
"fbnTransactionId",
"transactionId",
"customerId",
"accountId",
"debtId",
"transactionType",
"amountProvided",
"amountCollected",
"responseCode",
"responseDescription"
],
"properties": {
"fbnTransactionId": {
"type": "string",
"example": "123456789",
"description": "Unique id of the transaction received from FBN in Eligibility or Provision requests"
},
"transactionId": {
"type": "string",
"example": "123456789",
"description": "Unique identifier of transaction in FIRSTBANK system"
},
"customerId": {
"type": "string",
"example": "CN621868",
"description": "Unique identifier of a customer"
},
"accountId": {
"type": "string",
"example": "ACN8263457",
"description": "Specific identifier of a user's account"
},
"debtId": {
"type": "string",
"example": "987654321",
"description": "Unique identifier of providing loan in Simbrella system"
},
"transactionType": {
"type": "string",
"example": "Disbursement",
"description": "Type of transaction initiated by Simbrella: 'Disbursement', 'Collection', or 'PenalCharge'"
},
"amountProvided": {
"type": "number",
"format": "double",
"example": 1000.00,
"description": "Amount provided to customer within Disbursement operation. Will equal to 0 when transaction type is Collection or PenalCharge."
},
"amountCollected": {
"type": "number",
"format": "double",
"example": 0.00,
"description": "Amount collected during execution of operation. Will equal to 0 when transaction type is Disbursement."
},
"responseCode": {
"type": "string",
"example": "00",
"description": "Result code of the notification"
},
"responseDescription": {
"type": "string",
"example": "Successful",
"description": "Result description of the notification, detailing status of the transaction"
}
}
},
"NotificationCallbackResponse": {
"type": "object",
"required": [
"resultCode",
"resultDescription"
],
"properties": {
"resultCode": {
"type": "string",
"example": "00",
"description": "Result code of successful request"
},
"resultDescription": {
"type": "string",
"example": "Successful",
"description": "Description of provided result code"
}
}
} }
}, },
"securitySchemes": { "securitySchemes": {