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.