create Retrieval Request

POST {{baseUrl}}/v6/claims/:claim-id/retrievalrequests

Prior to creating a chargeback, an issuer uses this endpoint to create a retrieval request for the acquirer to fulfill by providing a copy of the transaction information document (TID). The TID is used to satisfy a cardholder's inquiry or to satisfy an issuer's investigation of an original transaction.

NOTE: an issuer is not required to create a retrieval request in order to create a first chargeback on a claim.

NOTE: Below retrievalRequestReason codes will be accepted until October 23th, 2021.
6305 - Cardholder does not agree with amount billed
6321 - Cardholder does not recognize transaction
6322 - Request Transaction Certificate for a chip transaction
6323 - Cardholder needs information for personal records
6341 - Fraud investigation
6342 - Potential chargeback or compliance documentation is required
6343 - IIAS Audit (for healthcare transactions only)
6390 - Identifies a syntax error return

NOTE: Below retrievalRequestReason code will be accepted for creation of retrieval request starting on October 24th, 2021.
6343 - IIAS Audit (for healthcare transactions only)

Request Body

{"docNeeded"=>"2", "retrievalRequestReason"=>"6343", "instructionsForHealthcare"=>"Instructions to acquirer for fulfilling the retrieval request"}

HEADERS

RESPONSES

status: OK

{"requestId":"300002296235"}