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 https://finix.sandbox-payments-api.com/instrument_updates/IUp9oSWhWUF31DPrJ8CojQeQ \
    -H "Content-Type: application/vnd.json+api" \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
    -F 'file=@path/to/local/file' \
    -F 'request = "{
        \"merchant_id\": \"MUucec6fHeaWo3VHYoSkUySM\",
        \"idempotency_id\": \"123xyz\"
}"'

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.