Respond to Received RFI

Submit a response to a Request for Information (RFI) received on a payment. The delivery method (RTP or FedNow) is automatically determined based on the paymentId. Obtain the caseId from GET /v1/rfi/{paymentId} (each rfiHistory[].request.caseId); it identifies the received RFI being answered. Validation rules:

  • caseId is required.
  • FedNow: status is required and must be one of INFO, IDUP, NINF, PDNG.
  • INFO → additionalInformation is required and is sent as the response remittance text.
  • IDUP → duplicatePaymentId is required (numeric end-to-end identifier of the identified duplicate payment).
  • NINF / PDNG → no additional fields (only caseId and status).
  • RTP: status does not apply and is ignored. additionalInformation (the answer value) is required; the service publishes it as the response remittance in the form "/MS01/<value>" (the MS01 code is applied by the service). endUserName is optional and, when provided, is used as the responding case party; when omitted the party defaults to system.
SecurityoAuth2
Request
path Parameters
paymentId
required
string

Unique payment identifier. The delivery method (RTP or FedNow) is automatically determined from this payment.

Request Body schema: application/json
required
caseId
required
string

Identifier of the received RFI being answered. Obtain it from GET /v1/rfi/{paymentId} -> rfiHistory[].request.caseId.

status
string

Resolution status. Required for FedNow; omit for RTP (RTP has no status). INFO = provide requested information; IDUP = identified duplicate; NINF = no information available; PDNG = pending.

Enum: "INFO" "IDUP" "NINF" "PDNG"
additionalInformation
string

Answer value. Required for FedNow INFO and for RTP. For RTP the value is published as remittance "/MS01/" (the MS01 code is applied by the service); for FedNow INFO it is sent as plain remittance text.

duplicatePaymentId
string

End-to-end identifier of the duplicate payment. Required when status is IDUP (FedNow).

endUserName
string

RTP only. Responding end-user name, used as the case party; defaults to "system" when omitted. Ignored for FedNow.

Responses
200

Successfully processed request

400

Bad Request - Invalid input parameters or validation errors

403

Forbidden - User is not authorized to perform this operation

404

The resource you were trying to reach is not found

405

Method Not Allowed - The HTTP method is not allowed for this endpoint

500

Internal Server Error - Unexpected error occurred while processing the request

503

Service unavailable

post/v1/rfi/{paymentId}/response
Request samples
application/json
{
  • "caseId": "20260703053951245071212128444",
  • "additionalInformation": "Information provided",
  • "endUserName": "Baskaran"
}
Response samples
application/json
{
  • "message": "Response to Request for Information has been submitted successfully",
  • "paymentId": "403306",
  • "deliveryMethod": "RTP",
  • "timestamp": "2026-07-08T07:00:09.4687354-04:00"
}