{"title":"Manage cards","category":"default","creationDate":1571787360,"content":"<p>After you create and issue cards to your users, you will need to manage the whole lifecycle of your cards, including:<\/p>\n<ul>\n<li><a href=\"#update-balance-account-id\">Updating the balance account linked to a card through the API<\/a>.<\/li>\n<li><a href=\"#activate-card\">Activating a card to enable payment processing<\/a>.<\/li>\n<li><a href=\"#suspend-card\">Suspending a card to temporarily stop payment processing<\/a>.<\/li>\n<li><a href=\"#close-card\">Permanently closing a card<\/a>.<\/li>\n<li><a href=\"#view-card-payments\">Viewing card payments in the Customer Area<\/a>.<\/li>\n<\/ul>\n<h2 id=\"update-balance-account-id\">Update the balance account linked to a card<\/h2>\n<p>Some use cases might require that you update the balance account linked to a card after the card has been created. You can do this only if the card is in <span translate=\"no\"><strong>inactive<\/strong><\/span> status.<\/p>\n<p>To update the balance account ID, make a PATCH <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/balanceplatform\/latest\/patch\/paymentInstruments\/{id}\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentInstruments\/{id}<\/a> request and send the new <code>balanceAccountId<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update the balance account ID'\" :id=\"'update-card-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/bcl\\\/v2\\\/paymentInstruments\\\/PI3227C223222B5BPCMFXD2XG \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X PATCH \\\\\\n-d '{\\n    \\&quot;balanceAccountId\\&quot;:\\&quot;BA32272223222B5CM82WL892M\\&quot;\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v25.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.balancePlatform.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.service.balancePlatform.*;\\n\\nClient client = new Client(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest()\\n  .balanceAccountId(\\&quot;BA32272223222B5CM82WL892M\\&quot;);\\n\\n\\\/\\\/ Make the API call\\nPaymentInstrumentsApi service = new PaymentInstrumentsApi(client);\\nUpdatePaymentInstrument response = service.updatePaymentInstrument(\\&quot;id\\&quot;, paymentInstrumentUpdateRequest, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen PHP API Library v17.4.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\BalancePlatform\\\\PaymentInstrumentUpdateRequest;\\nuse Adyen\\\\Service\\\\BalancePlatform\\\\PaymentInstrumentsApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest();\\n$paymentInstrumentUpdateRequest\\n  -&gt;setBalanceAccountId(\\&quot;BA32272223222B5CM82WL892M\\&quot;);\\n\\n\\\/\\\/ Make the API call\\n$service = new PaymentInstrumentsApi($client);\\n$response = $service-&gt;updatePaymentInstrument('id', $paymentInstrumentUpdateRequest);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v14.4.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.BalancePlatform;\\nusing Adyen.Service.BalancePlatform;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest\\n{\\n  BalanceAccountId = \\&quot;BA32272223222B5CM82WL892M\\&quot;\\n};\\n\\n\\\/\\\/ Make the API call\\nvar service = new PaymentInstrumentsService(client);\\nvar response = service.UpdatePaymentInstrument(\\&quot;id\\&quot;, paymentInstrumentUpdateRequest);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nconst { Client, BalancePlatformAPI } = require('@adyen\\\/api-library');\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object(s)\\nconst paymentInstrumentUpdateRequest = {\\n  balanceAccountId: \\&quot;BA32272223222B5CM82WL892M\\&quot;\\n}\\n\\n\\\/\\\/ Make the API call\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\&quot;id\\&quot;, paymentInstrumentUpdateRequest);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v9.3.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/balancePlatform\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\npaymentInstrumentUpdateRequest := balancePlatform.PaymentInstrumentUpdateRequest{\\n  BalanceAccountId: common.PtrString(\\&quot;BA32272223222B5CM82WL892M\\&quot;),\\n}\\n\\n\\\/\\\/ Make the API call\\nservice := client.BalancePlatform()\\nreq := service.PaymentInstrumentsApi.UpdatePaymentInstrumentInput(\\&quot;id\\&quot;).PaymentInstrumentUpdateRequest(paymentInstrumentUpdateRequest)\\nres, httpRes, err := service.PaymentInstrumentsApi.UpdatePaymentInstrument(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v12.2.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;balanceAccountId\\&quot;: \\&quot;BA32272223222B5CM82WL892M\\&quot;\\n}\\n\\n# Make the API call\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request=json_request, id=\\&quot;id\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v9.3.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :balanceAccountId =&gt; 'BA32272223222B5CM82WL892M'\\n}\\n\\n# Make the API call\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request_body, 'id')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nimport { Client, BalancePlatformAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object(s)\\nconst paymentInstrumentUpdateRequest: Types.balancePlatform.PaymentInstrumentUpdateRequest = {\\n  balanceAccountId: \\&quot;BA32272223222B5CM82WL892M\\&quot;\\n};\\n\\n\\\/\\\/ Make the API call\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\&quot;id\\&quot;, paymentInstrumentUpdateRequest);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>The response contains the <span translate=\"no\"><strong>paymentInstrument<\/strong><\/span> resource, with the updated <code>balanceAccountId<\/code>.<\/p>\n<h2 id=\"activate-card\">Activate a card<\/h2>\n<p>To secure physical cards, we recommended that you keep them inactive until the user receives the card.<\/p>\n<p>You can activate cards using the Customer Area or the Balance Platform API.<\/p>\n\n<div id=\"tabjHQFN\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To activate a card:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Log in to the &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Financial products&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Payment instruments&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the appropriate payment instrument from the list.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Change card status&lt;\\\/strong&gt; in the upper right corner.&lt;\\\/li&gt;\\n&lt;li&gt;In the pop-up window, set the &lt;strong&gt;New Status&lt;\\\/strong&gt; to &lt;strong&gt;Active&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Change status&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;activate-ca&quot;,&quot;oldTabId&quot;:&quot;activate-ca_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To activate a card, make a PATCH &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/patch\\\/paymentInstruments\\\/{id}\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentInstruments\\\/{id}&lt;\\\/a&gt; request and set its &lt;code&gt;status&lt;\\\/code&gt; to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;active&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Activate a card&#039;\\&quot; :id=\\&quot;&#039;activate-card-request&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/balanceplatform-api-test.adyen.com\\\\\\\/bcl\\\\\\\/v2\\\\\\\/paymentInstruments\\\\\\\/PI3227C223222B5BPCMFXD2XG \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;status\\\\&amp;quot;:\\\\&amp;quot;active\\\\&amp;quot;\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v25.0.0\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.balancePlatform.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.balancePlatform.*;\\\\n\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest()\\\\n  .status(PaymentInstrumentUpdateRequest.StatusEnum.ACTIVE);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nPaymentInstrumentsApi service = new PaymentInstrumentsApi(client);\\\\nUpdatePaymentInstrument response = service.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen PHP API Library v17.4.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentUpdateRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentsApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\n$paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest();\\\\n$paymentInstrumentUpdateRequest\\\\n  -&amp;gt;setStatus(\\\\&amp;quot;active\\\\&amp;quot;);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\n$service = new PaymentInstrumentsApi($client);\\\\n$response = $service-&amp;gt;updatePaymentInstrument(&#039;id&#039;, $paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .net API Library v14.4.0\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.BalancePlatform;\\\\nusing Adyen.Service.BalancePlatform;\\\\n\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest\\\\n{\\\\n  Status = PaymentInstrumentUpdateRequest.StatusEnum.Active\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nvar service = new PaymentInstrumentsService(client);\\\\nvar response = service.UpdatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nconst { Client, BalancePlatformAPI } = require(&#039;@adyen\\\\\\\/api-library&#039;);\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst paymentInstrumentUpdateRequest = {\\\\n  status: \\\\&amp;quot;active\\\\&amp;quot;\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v9.3.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/balancePlatform\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\npaymentInstrumentUpdateRequest := balancePlatform.PaymentInstrumentUpdateRequest{\\\\n  Status: common.PtrString(\\\\&amp;quot;active\\\\&amp;quot;),\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nservice := client.BalancePlatform()\\\\nreq := service.PaymentInstrumentsApi.UpdatePaymentInstrumentInput(\\\\&amp;quot;id\\\\&amp;quot;).PaymentInstrumentUpdateRequest(paymentInstrumentUpdateRequest)\\\\nres, httpRes, err := service.PaymentInstrumentsApi.UpdatePaymentInstrument(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v12.2.0\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;active\\\\&amp;quot;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request=json_request, id=\\\\&amp;quot;id\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v9.3.0\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  :status =&amp;gt; &#039;active&#039;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request_body, &#039;id&#039;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nimport { Client, BalancePlatformAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst paymentInstrumentUpdateRequest: Types.balancePlatform.PaymentInstrumentUpdateRequest = {\\\\n  status: Types.balancePlatform.PaymentInstrumentUpdateRequest.StatusEnum.Active\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;activate-api&quot;,&quot;oldTabId&quot;:&quot;activate-api_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>After the card is activated, it can start processing payments.<\/p>\n<h2 id=\"suspend-card\">Suspend a card<\/h2>\n<p>You can suspend a payment instrument to temporarily prevent payment processing. You can activate the card again at any time. To permanently deactivate a card, see <a href=\"#close-card\">Close a card<\/a>.<\/p>\n<p>You can suspend cards using the Customer Area or the Balance Platform API.<\/p>\n\n<div id=\"taba4ilp\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To suspend a card:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Log in to the &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Financial products&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Payment instruments&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the appropriate payment instrument from the list.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Change card status&lt;\\\/strong&gt; in the upper right corner.&lt;\\\/li&gt;\\n&lt;li&gt;In the pop-up window, set the &lt;strong&gt;New Status&lt;\\\/strong&gt; to &lt;strong&gt;Suspended&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Reason&lt;\\\/strong&gt; dropdown list, select the appropriate reason for the status change.&lt;\\\/li&gt;\\n&lt;li&gt;If you have selected &lt;strong&gt;Other&lt;\\\/strong&gt; as a reason, you are also required to add a note.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Change status&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;suspend-ca&quot;,&quot;oldTabId&quot;:&quot;suspend-ca_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To suspend a card, make a PATCH &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/patch\\\/paymentInstruments\\\/{id}\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentInstruments\\\/{id}&lt;\\\/a&gt; request with the following parameters:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;status&lt;\\\/code&gt;: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;suspended&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;statusReason&lt;\\\/code&gt;: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;lost&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;stolen&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;damaged&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;suspectedFraud&lt;\\\/strong&gt;&lt;\\\/span&gt;, or &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;other&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;statusComment&lt;\\\/code&gt; : Required if &lt;code&gt;statusReason&lt;\\\/code&gt; is &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;other&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Suspend a card&#039;\\&quot; :id=\\&quot;&#039;suspend-card-request&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/balanceplatform-api-test.adyen.com\\\\\\\/bcl\\\\\\\/v2\\\\\\\/paymentInstruments\\\\\\\/PI3227C223222B5BPCMFXD2XG \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;status\\\\&amp;quot;:\\\\&amp;quot;suspended\\\\&amp;quot;,\\\\n    \\\\&amp;quot;statusReason\\\\&amp;quot;:\\\\&amp;quot;lost\\\\&amp;quot;\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v25.0.0\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.balancePlatform.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.balancePlatform.*;\\\\n\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest()\\\\n  .statusReason(PaymentInstrumentUpdateRequest.StatusReasonEnum.LOST)\\\\n  .status(PaymentInstrumentUpdateRequest.StatusEnum.SUSPENDED);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nPaymentInstrumentsApi service = new PaymentInstrumentsApi(client);\\\\nUpdatePaymentInstrument response = service.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen PHP API Library v17.4.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentUpdateRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentsApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\n$paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest();\\\\n$paymentInstrumentUpdateRequest\\\\n  -&amp;gt;setStatusReason(\\\\&amp;quot;lost\\\\&amp;quot;)\\\\n  -&amp;gt;setStatus(\\\\&amp;quot;suspended\\\\&amp;quot;);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\n$service = new PaymentInstrumentsApi($client);\\\\n$response = $service-&amp;gt;updatePaymentInstrument(&#039;id&#039;, $paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .net API Library v14.4.0\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.BalancePlatform;\\\\nusing Adyen.Service.BalancePlatform;\\\\n\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest\\\\n{\\\\n  StatusReason = PaymentInstrumentUpdateRequest.StatusReasonEnum.Lost,\\\\n  Status = PaymentInstrumentUpdateRequest.StatusEnum.Suspended\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nvar service = new PaymentInstrumentsService(client);\\\\nvar response = service.UpdatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nconst { Client, BalancePlatformAPI } = require(&#039;@adyen\\\\\\\/api-library&#039;);\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst paymentInstrumentUpdateRequest = {\\\\n  status: \\\\&amp;quot;suspended\\\\&amp;quot;,\\\\n  statusReason: \\\\&amp;quot;lost\\\\&amp;quot;\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v9.3.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/balancePlatform\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\npaymentInstrumentUpdateRequest := balancePlatform.PaymentInstrumentUpdateRequest{\\\\n  StatusReason: common.PtrString(\\\\&amp;quot;lost\\\\&amp;quot;),\\\\n  Status: common.PtrString(\\\\&amp;quot;suspended\\\\&amp;quot;),\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nservice := client.BalancePlatform()\\\\nreq := service.PaymentInstrumentsApi.UpdatePaymentInstrumentInput(\\\\&amp;quot;id\\\\&amp;quot;).PaymentInstrumentUpdateRequest(paymentInstrumentUpdateRequest)\\\\nres, httpRes, err := service.PaymentInstrumentsApi.UpdatePaymentInstrument(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v12.2.0\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;suspended\\\\&amp;quot;,\\\\n  \\\\&amp;quot;statusReason\\\\&amp;quot;: \\\\&amp;quot;lost\\\\&amp;quot;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request=json_request, id=\\\\&amp;quot;id\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v9.3.0\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  :status =&amp;gt; &#039;suspended&#039;,\\\\n  :statusReason =&amp;gt; &#039;lost&#039;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request_body, &#039;id&#039;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nimport { Client, BalancePlatformAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst paymentInstrumentUpdateRequest: Types.balancePlatform.PaymentInstrumentUpdateRequest = {\\\\n  statusReason: Types.balancePlatform.PaymentInstrumentUpdateRequest.StatusReasonEnum.Lost,\\\\n  status: Types.balancePlatform.PaymentInstrumentUpdateRequest.StatusEnum.Suspended\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;suspend-api&quot;,&quot;oldTabId&quot;:&quot;suspend-api_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>The card can no longer be used for payments. To re-enable payments, you need to <a href=\"#activate-card\">set the <code>status<\/code> back to <span translate=\"no\"><strong>active<\/strong><\/span><\/a>.<\/p>\n<h2 id=\"close-card\">Close a card<\/h2>\n<p>Closing a card is a permanent action and cannot be reversed. If you want to temporarily prevent processing, you can <a href=\"#suspend-card\">suspend the card<\/a> instead.<\/p>\n<p>You can close cards using the Balance Platform API or Customer Area.<\/p>\n\n<div id=\"tabFIvoL\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To close a card:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Log in to the &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Financial products&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Payment instruments&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the appropriate payment instrument from the list.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Change card status&lt;\\\/strong&gt; in the upper right corner.&lt;\\\/li&gt;\\n&lt;li&gt;In the pop-up window, set the &lt;strong&gt;New Status&lt;\\\/strong&gt; to &lt;strong&gt;Closed&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Reason&lt;\\\/strong&gt; dropdown list, select the appropriate reason for the status change.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Change status&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;close-ca&quot;,&quot;oldTabId&quot;:&quot;close-ca_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To close a card, make a PATCH &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/patch\\\/paymentInstruments\\\/{id}\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentInstruments\\\/{id}&lt;\\\/a&gt; request with the following parameters:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;status&lt;\\\/code&gt;: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;closed&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;statusReason&lt;\\\/code&gt;: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;lost&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;stolen&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;damaged&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;suspectedFraud&lt;\\\/strong&gt;&lt;\\\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;endOfLife&lt;\\\/strong&gt;&lt;\\\/span&gt;, or &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;accountClosure&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Here is an example of how you close a card with payment instrument &lt;code&gt;id&lt;\\\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;PI3227C223222B5BPCMFXD2XG&lt;\\\/strong&gt;&lt;\\\/span&gt;:&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Close a card&#039;\\&quot; :id=\\&quot;&#039;close-card-request&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/balanceplatform-api-test.adyen.com\\\\\\\/bcl\\\\\\\/v2\\\\\\\/paymentInstruments\\\\\\\/PI3227C223222B5BPCMFXD2XG \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;status\\\\&amp;quot;:\\\\&amp;quot;closed\\\\&amp;quot;,\\\\n    \\\\&amp;quot;statusReason\\\\&amp;quot;:\\\\&amp;quot;endOfLife\\\\&amp;quot;\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v25.0.0\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.balancePlatform.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.balancePlatform.*;\\\\n\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest()\\\\n  .statusReason(PaymentInstrumentUpdateRequest.StatusReasonEnum.ENDOFLIFE)\\\\n  .status(PaymentInstrumentUpdateRequest.StatusEnum.CLOSED);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nPaymentInstrumentsApi service = new PaymentInstrumentsApi(client);\\\\nUpdatePaymentInstrument response = service.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen PHP API Library v17.4.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentUpdateRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentsApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\n$paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest();\\\\n$paymentInstrumentUpdateRequest\\\\n  -&amp;gt;setStatusReason(\\\\&amp;quot;endOfLife\\\\&amp;quot;)\\\\n  -&amp;gt;setStatus(\\\\&amp;quot;closed\\\\&amp;quot;);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\n$service = new PaymentInstrumentsApi($client);\\\\n$response = $service-&amp;gt;updatePaymentInstrument(&#039;id&#039;, $paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .net API Library v14.4.0\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.BalancePlatform;\\\\nusing Adyen.Service.BalancePlatform;\\\\n\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nPaymentInstrumentUpdateRequest paymentInstrumentUpdateRequest = new PaymentInstrumentUpdateRequest\\\\n{\\\\n  StatusReason = PaymentInstrumentUpdateRequest.StatusReasonEnum.EndOfLife,\\\\n  Status = PaymentInstrumentUpdateRequest.StatusEnum.Closed\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nvar service = new PaymentInstrumentsService(client);\\\\nvar response = service.UpdatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nconst { Client, BalancePlatformAPI } = require(&#039;@adyen\\\\\\\/api-library&#039;);\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst paymentInstrumentUpdateRequest = {\\\\n  status: \\\\&amp;quot;closed\\\\&amp;quot;,\\\\n  statusReason: \\\\&amp;quot;endOfLife\\\\&amp;quot;\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v9.3.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/balancePlatform\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\npaymentInstrumentUpdateRequest := balancePlatform.PaymentInstrumentUpdateRequest{\\\\n  StatusReason: common.PtrString(\\\\&amp;quot;endOfLife\\\\&amp;quot;),\\\\n  Status: common.PtrString(\\\\&amp;quot;closed\\\\&amp;quot;),\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nservice := client.BalancePlatform()\\\\nreq := service.PaymentInstrumentsApi.UpdatePaymentInstrumentInput(\\\\&amp;quot;id\\\\&amp;quot;).PaymentInstrumentUpdateRequest(paymentInstrumentUpdateRequest)\\\\nres, httpRes, err := service.PaymentInstrumentsApi.UpdatePaymentInstrument(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v12.2.0\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;closed\\\\&amp;quot;,\\\\n  \\\\&amp;quot;statusReason\\\\&amp;quot;: \\\\&amp;quot;endOfLife\\\\&amp;quot;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request=json_request, id=\\\\&amp;quot;id\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v9.3.0\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  :status =&amp;gt; &#039;closed&#039;,\\\\n  :statusReason =&amp;gt; &#039;endOfLife&#039;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.update_payment_instrument(request_body, &#039;id&#039;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nimport { Client, BalancePlatformAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst paymentInstrumentUpdateRequest: Types.balancePlatform.PaymentInstrumentUpdateRequest = {\\\\n  statusReason: Types.balancePlatform.PaymentInstrumentUpdateRequest.StatusReasonEnum.EndOfLife,\\\\n  status: Types.balancePlatform.PaymentInstrumentUpdateRequest.StatusEnum.Closed\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.updatePaymentInstrument(\\\\&amp;quot;id\\\\&amp;quot;, paymentInstrumentUpdateRequest);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;close-api&quot;,&quot;oldTabId&quot;:&quot;close-api_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>The card can no longer be used for payments.<\/p>\n<h2 id=\"view-card-payments\">View card payments<\/h2>\n<p>You can view all payments made with a card in the Customer Area.<\/p>\n<ol>\n<li>Log in to the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>Financial products<\/strong> &gt; <strong>Payment instruments<\/strong>.<\/li>\n<li>Select the appropriate payment instrument from the list.<\/li>\n<li>Select <strong>View payments<\/strong> in the upper right corner.<\/li>\n<\/ol>\n<p>A list is shown, displaying all payments made with the card. By default, the results are filtered to the last 6 months.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/issuing\/manage-cards","articleFields":{"description":"Learn how to change the status of a card.","next_steps":[{"title":"Process payments","description":"Learn how to handle payments made with Adyen-issued cards.","url":"\/issuing\/authorisation","required":true},{"title":"Create cards","description":"Create cards for your users.","url":"\/issuing\/create-cards","required":false}],"last_edit_on":"18-12-2019 15:48","parameters":{"directoryPath":"\/issuing"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/issuing\/manage-cards","title":"Manage cards","content":"After you create and issue cards to your users, you will need to manage the whole lifecycle of your cards, including:\n\nUpdating the balance account linked to a card through the API.\nActivating a card to enable payment processing.\nSuspending a card to temporarily stop payment processing.\nPermanently closing a card.\nViewing card payments in the Customer Area.\n\nUpdate the balance account linked to a card\nSome use cases might require that you update the balance account linked to a card after the card has been created. You can do this only if the card is in inactive status.\nTo update the balance account ID, make a PATCH \/paymentInstruments\/{id} request and send the new balanceAccountId.\n\n    \n\nThe response contains the paymentInstrument resource, with the updated balanceAccountId.\nActivate a card\nTo secure physical cards, we recommended that you keep them inactive until the user receives the card.\nYou can activate cards using the Customer Area or the Balance Platform API.\n\n\n    \n        \n        \n    \n\n\nAfter the card is activated, it can start processing payments.\nSuspend a card\nYou can suspend a payment instrument to temporarily prevent payment processing. You can activate the card again at any time. To permanently deactivate a card, see Close a card.\nYou can suspend cards using the Customer Area or the Balance Platform API.\n\n\n    \n        \n        \n    \n\n\nThe card can no longer be used for payments. To re-enable payments, you need to set the status back to active.\nClose a card\nClosing a card is a permanent action and cannot be reversed. If you want to temporarily prevent processing, you can suspend the card instead.\nYou can close cards using the Balance Platform API or Customer Area.\n\n\n    \n        \n        \n    \n\n\nThe card can no longer be used for payments.\nView card payments\nYou can view all payments made with a card in the Customer Area.\n\nLog in to the Customer Area.\nGo to Financial products &gt; Payment instruments.\nSelect the appropriate payment instrument from the list.\nSelect View payments in the upper right corner.\n\nA list is shown, displaying all payments made with the card. By default, the results are filtered to the last 6 months.","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Manage cards"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/issuing","lvl2":"\/pt\/issuing\/manage-cards"},"levels":3,"category":"Issuing","category_color":"green","tags":["Manage","cards"]},"articleFiles":{"activate-card-request.js":"<p alt=\"\">activate-card-request.js<\/p>","close-card-request.js":"<p alt=\"\">close-card-request.js<\/p>","suspend-card-request.js":"<p alt=\"\">suspend-card-request.js<\/p>","update-card-request.js":"<p alt=\"\">update-card-request.js<\/p>"}}
