# RFI APIs source: https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-api_notused/index.md 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 a Customer and RSP. For more details, please see [How it Works](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/how-it-works/index.md). ## Open a Request {#open-a-request} 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 a Customer for response. After a response is submitted by Customer, 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 Customer. When requestStatus is OPEN or INPROGRESS, the Customer is expected to respond back to the request. The RFI Team may Cancel a request at any time. If this happens, the Customer 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 a Customer. The Customer needs to respond to the request. | | REVIEW | The RFI Team is assigned to review the received Customer response. | | INPROGRESS | The RFI Team requires additional information. The RFI has been reassigned to the Customer and the Customer 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 Customer receives a webhook notification. Notifications will be dispatched as the request is updated, informing the Customer of any changes or pending actions. Depending on the information added or requested, a Customer 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 | |--------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Customer is notified of the RFI request, or any associated updates | [Notification](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/notification/index.md) | The RFI system will send a webhook notification to the Customer 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](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/download-document-api/index.md) | The webhook notification may indicate that the RFI Team has attached documents to the request for the Customer to review and retrieve. If so, each attached document will have a unique value (documentId). This ID is required for the Customer 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](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/upload-document-api/index.md) | Required only if the Customer 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 Customer response to a RFI request | [Update API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/update-request-api/index.md) | 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) | ## Actions to retrieve a RFI request {#actions-to-retrieve-a-rfi-request} | Actions | API | Description | |-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------| | Retrieve the existing RFI Request | [Retrieve RFI Request](https://developer.mastercard.com/cross-border-services/documentation/api-ref/rfi-apis/retrieve-request-api/index.md) | This is used to retrieve the latest information of a RFI request. | ## RFI Response review and request closure {#rfi-response-review-and-request-closure} The RFI Team will review the additional information provided by the Customer. 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 Customer. The Customer receives a webhook notification with requestStatus =**InProgress** . The Customer 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 Customer 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.