Deprecated API Reference

This API Reference is being deprecated. Please use the New API Reference.

Fetch an Instrument Update

Fetch a specific Instrument Update from an Instrument Updates resource. For more information, see the Account Updater Guide.

Copy

Copied

curl https://finix.sandbox-payments-api.com/instrument_updates/IUp9oSWhWUF31DPrJ8CojQeQ/download \
    -H "Content-Type: application/vnd.json+api" \
    -H 'Finix-Version:2022-02-01' \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e

Example Response

Copy

Copied

{
  "id" : "IUp9oSWhWUF31DPrJ8CojQeQ",
  "created_at" : "2020-12-02T03:44:42.77Z",
  "updated_at" : "2020-12-02T03:44:42.81Z",
  "merchant" : "MUvQQt3RKe7FBZ6j9eMYoo3H", 
  "state" : PENDING, 
  "_links" : {
    "self" : {
      "href" : "https://finix.sandbox-payments-api.com/payment_intrument_updates/IUp9oSWhWUF31DPrJ8CojQeQ/download"
    }
  }
}

HTTP Request

GET https://finix.sandbox-payments-api.com/instrument_updates/INSTRUMENT_UPDATE_ID/download

URL Parameters

Field	Description
`INSTRUMENT_UPDATE_ID`	The ID of the `Instrument Update` you want to fetch, in the `Instrument Update` resource. This ID was returned when initially creating the `Instrument Update` object.

Response

The CSV that's available to download will return Payment Instruments in the following format:

payment_instrument_original	payment_instrument_new	result
PIlkNdfZibF8a7Prd2teGB1	PI3aQGaCM5nDMjqyTXcbUJzR	CARD_EXPIRATION_UPDATED
PIJPXW0HZ9lpO1nb6sog5DiX	PIdBHpy7BBSxd2z81VdKpVbT	CARD_NOT_FOUND
PI0ovZAS9yfEtgDrZnMaiLvi	PIhXS0jXNTmklyVk91EsohuZ	CONTACT_CARDHOLDER
PInOrrKY3G1U33hGYTQJ8cIY		CLOSED_ACCOUNT
PIlkAOt5kTVhuuxxbmOi9qn		INVALID_CARD
PIiRLbbG4i5daypWNzIrq2xD		NO_CHANGE_FOUND
PIy5llZGt6VxlDqbcTgATqeH		UNKNOWN