Update an issuing holder by ID

PATCH {{baseInfraUrl}}/{{version}}/issuing-holder/:holderId

You can patch an Issuing Holder to block a cardholder, to change spending rules or to change registered information.

ParametersType ValueDescription
idREQUIREDId of the Issuing Holder to be patched.
statusOPTIONALYou may block the Issuing Holder by passing blocked in the status or you may reactivate a blocked Issuing Holder by passing active in the status.
nameOPTIONALHolder's display name.
rulesOPTIONALSpending rules for the Issuing Holder.
tagsOPTIONALList of strings for tagging.

Request Body

{"displayName"=>"Updated Card", "status"=>"active", "tags"=>["food"], "rules"=>[{"name"=>"Example Rule", "countries"=>[{"code"=>"BRA"}], "interval"=>"week", "amount"=>900000, "categories"=>[{"code"=>"fastFoodRestaurants"}], "currencyCode"=>"BRL", "methods"=>[{"code"=>"token"}, {"code"=>"manual"}]}]}

RESPONSES

status: OK

{"holder":{"created":"2022-05-17T20:03:05.939249+00:00","externalId":"123456789","id":"5055990386917376","name":"Updated Holder","rules":[{"amount":900000,"currencyCode":"BRL","id":"4826637614972928","interval":"week","name":"Example Rule"}],"status":"active","tags":["food"],"taxId":"012.345.678-90","updated":"2022-05-17T20:04:53.451379+00:00"},"message":"Card Holder(s) successfully updated"}