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.
Parameters | Type Value | Description |
---|---|---|
id | REQUIRED | Id of the Issuing Holder to be patched. |
status | OPTIONAL | You may block the Issuing Holder by passing blockedin the status or you may reactivate a blocked Issuing Holder by passing activein the status. |
name | OPTIONAL | Holder's display name. |
rules | OPTIONAL | Spending rules for the Issuing Holder. |
tags | OPTIONAL | List 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"}