This guide explains how to use the Intake API to create claims, add reasons, transactions, and details about the claim, and submit the claim to be finalized.
...
- Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/retrieveCustomers to get a list of CustomerIds and other customer details
- The /claim/intake/retrieveCustomers endpoint also returns Name, EmailAddress, Phone, Address, and SecondaryPhone
- CustomerId is required when creating a new claim and can be used to retrieve accounts
Drawio |
---|
border | true |
---|
| |
---|
diagramName | ChoosingACustomer |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 611 |
---|
revision | 1 |
---|
|
...
- If needed, follow Choosing a Customer to get a valid CustomerId
- Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/retrieveAccounts to get a list of AccountNumbers and other account details
- The /claim/intake/retrieveAccounts endpoint takes in CustomerId as a parameter and the response will only return accounts for the passed in CustomerId
- Description, OpenDate, and Balance are also returned
- AccountNumber is required when creating a new claim
Drawio |
---|
border | true |
---|
| |
---|
diagramName | ChoosingAnAccount |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 611 |
---|
revision | 2 |
---|
|
...
- If needed, follow Choosing a Customer and Choosing an Account to get a valid CustomerId and AccountNumber
- Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/create to create a new claim
- The /claim/intake/create endpoint takes in CustomerId and AccountNumber as parameters and the claim will be created for the passed in IDs
- ClaimId is returned
Drawio |
---|
border | true |
---|
| |
---|
diagramName | CreatingAClaim |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 431 |
---|
revision | 3 |
---|
|
...
- After Creating A Claim, use the endpoint, www.example.com/QFDAPI/v1/claim/intake/retrieveReasons with a valid ClaimId to get the reason questionnaire for the claim
- The returned questionnaire contains questions to display so the user can classify the type and reason for the claim. The API returns appropriate questions for that given claim
- Using the returned questionnaire, a QuestionList of the users answered questions can be built to sent to /claim/intake/addClaimReasons. See Swaggerhub Documentation
- Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/addClaimReasons to submit the built QuestionList
- After submitting the users answers, the next step in the intake process is Retrieving and Adding Transactions
Drawio |
---|
border | true |
---|
| |
---|
diagramName | RetrievingAndAddingClaimReasons |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 641 |
---|
revision | 2 |
---|
|
...
Drawio |
---|
border | true |
---|
| |
---|
diagramName | RetrievingSubmittingQuestionnaire |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 641 |
---|
revision | 2 |
---|
|
Anchor |
---|
| RetrievingRecognizedTransactions |
---|
| RetrievingRecognizedTransactions |
---|
|
Selecting Recognized Transactions...
- When retrieving the questionnaire, if a question contains an APIDocumentationList that defines this endpoint, then recognized transactions can be identified using www.example.com/QFDAPI/v1/claim/intake/recognizeDisputedTransactions. See Swaggerhub Documentation
- The /claim/intake/recognizeDisputedTransactions takes in a TransactionList of TransactionIds, each TransactionId being a transaction that the user wants to mark as recognized. See Swaggerhub Documentation
- The TransactionIds to select can be retrieved using the same retrieve endpoint used in Retrieving and Adding Transactions
- /claim/intake/recognizedDisputedTransactions is required if the claim is card secure and the user has indicated that they have done business with the disputed merchant
Drawio |
---|
border | true |
---|
| |
---|
diagramName | SelectingRecognizedTransactions |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 641 |
---|
revision | 1 |
---|
|
Anchor |
---|
| RetrievingCreditTransactions |
---|
| RetrievingCreditTransactions |
---|
|
Retrieving and Adding Credit Transactions Anchor |
---|
| RetrievingSimilarTransactions |
---|
| RetrievingSimilarTransactions |
---|
|
Retrieving Similar Transactions
...