Deprecated API Reference

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

Create Instrument Updates

To update the card details of your customers, create an Instrument Updates resource. Include the Payment Instrument IDs you want to update in a CSV. For more info, see the Account Updater Guide.

Copy
Copied
curl --request POST 'https://finix.sandbox-payments-api.com/instrument_updates' \
-u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
-H 'Finix-Version:2022-02-01' \
-F 'file=@"/Path/to/Local/File.csv"' \
-F 'request="{\"merchant\":\"MUucec6fHeaWo3VHYoSkUySM\",
\"idempotency_id\":\"123xyz testing\"
}"'

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"
    }
  }
}

HTTP Request

POST https://finix.sandbox-payments-api.com/instrument_updates

Request Arguments

Field Type Description
merchant string, optional ID of the Merchant object that you want to associate with the Account Updater batch for your own accounting purposes. You can only associate one Merchant to each Instrument Updates object.
idempotency_id string, optional A randomly generated value that will be associated with this Instrument Updates resource.

Response

Field Type Description
id string The ID of the Instrument Updates resource.
created_at string Timestamp of when the Instrument Updates resource was created.
updated_at string Timestamp of when the Instrument Updates resource was last updated.
merchant string The Merchant ID associated with the Instrument Updates.
state string The status of the Instrument Updates resource and update request.