# Request For Information
source: https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/request-for-information_notused/index.md

## Open a Request {#open-a-request}

Request for Information, commonly referred to as "RFI", is the process Cross-Border Services uses to enable information to be requested by a Receiving Service Provider (RSP), and responses to be shared between an Originating Institution (OI) and RSP.

Information is requested when information is needed to continue processing a payment. One RFI request can be created for **one or more payment** transactions.

## Request Status {#request-status}

After a request is created, it is in an Open status and assigned to an OI for response. After a response is submitted by OI, the information is reviewed by the Mastercard RFI Team ("RFI Team"). As a request goes through its workflow, the status will indicate its progress. Once no additional information is needed, the request is closed.  


The requestStatus determines the next action for the OI. When requestStatus is OPEN or INPROGRESS, the OI is expected to respond back to the request.  


The RFI Team may Cancel a request at any time. If this happens, the OI receives a notification and the RFI status will change to Cancelled.  


Statuses are provided in the table below:

|   Status   |                                                                                 Description                                                                                  |
|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| OPEN       | The request is assigned to an OI. The OI needs to respond to the request.                                                                                                    |
| REVIEW     | The RFI Team is assigned to review the received OI response.                                                                                                                 |
| INPROGRESS | The RFI Team requires additional information. The RFI has been reassigned to the OI and the OI needs to respond with the amendments or additional information.               |
| CLOSED     | The RFI Team reviewed and approved the request responses, and the request is now complete. Or, no response was received within 15 calendar days and the request has expired. |
| CANCELLED  | The RFI Team cancelled a request because the information was no longer required.                                                                                             |

## Notifications {#notifications}

When a RFI request is created, the OI receives a webhook notification. Notifications will be dispatched as the request is updated, informing the OI of any changes or pending actions. Depending on the information added or requested, an OI might have to complete one or more actions from the below tables to respond.

## Actions to obtain a RFI request {#actions-to-obtain-a-rfi-request}

|                           Actions                            |          API          |                                                                                                                                                                                                                        Description                                                                                                                                                                                                                        |
|--------------------------------------------------------------|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| OI is notified of the RFI request, or any associated updates | Notification API      | The RFI system will send a webhook notification to the OI which contains the information being requested. The initial notification will be the RequestId. It is a unique value assigned to each RFI request.                                                                                                                                                                                                                                              |
| Download documents attached to RFI request                   | Download Document API | The webhook notification may indicate that the RFI Team has attached documents to the request for the OI to review and retrieve. If so, each attached document will have a unique value (documentId). This ID is required for the OI to download the document using Download Document API. [FIND OUT MORE](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/how-it-works/index.md#documents-attached-to-rfi-request) |

## Actions to respond to a RFI request {#actions-to-respond-to-a-rfi-request}

|               Actions                |         API         |                                                                                                               Description                                                                                                                |
|--------------------------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Upload a document to RFI system      | Upload Document API | Required only if the OI wants to upload documents which can be later linked to a request. [FIND OUT MORE](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/how-it-works/index.md#upload-a-document) |
| Provide OI response to a RFI request | Update API          | Mandatory step to respond to a request. [FIND OUT MORE](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/how-it-works/index.md#submit-response)                                                     |

## RFI Response review and request closure {#rfi-response-review-and-request-closure}

The RFI Team will review the additional information provided by the OI. If all the information is approved, then the RFI will transition to a **Closed status** . When Closed, no further activity is required for the request. The request remains available in read-only mode.  

The RFI Team may require additional information to the original details provided. If this occurs, the request will be re-assigned to the OI. The OI receives a webhook notification with requestStatus = **InProgress** . The OI will be informed of the rejected response data, or additional information required. Review comments may be added indicating why the information was rejected, and what additional information is required. The OI is required to edit the rejected information and submit an updated response, after which the RFI will transition to **Review** status, and the review workflow will begin once again.
