{"title":"Create cards","category":"default","creationDate":1571778840,"content":"<p>After you create an <a href=\"\/pt\/issuing\/onboard-users\/onboarding-steps\">account holder<\/a> and a <a href=\"\/pt\/issuing\/onboard-users\/onboarding-steps\">balance account<\/a>, you can start issuing cards. Cards can either be virtual or physical. Cards also have to be associated with a Visa or Mastercard pre-approved use case, called a <em>scheme program<\/em>. By default, Adyen handles the scheme program for you in the background.<\/p>\n<h3>PCI compliance<\/h3>\n<p>The scope for PCI compliance depends on your use case&mdash;the type of cards you'll issue and how the cards will be used. To know whether PCI compliance requirements apply to your use case, reach out to your Adyen contact.<\/p>\n<h3 id=\"visual-design\">Visual design for physical cards<\/h3>\n<p>Before you can create physical cards in the live environment, you must have a design for the card itself and the mailer it is sent in. Each card design must be approved by Visa or Mastercard.<\/p>\n<p>Your Adyen contact will help you to complete and specify the designs.<\/p>\n<h2 id=\"create\">Create a card<\/h2>\n<p>To issue a card, create a <span translate=\"no\"><strong>paymentInstrument<\/strong><\/span> resource. In the request, specify whether the card is:<\/p>\n<ul>\n<li><strong>Virtual<\/strong>: A card that has no physical form. You receive the card details in the API response.<\/li>\n<li><strong>Physical<\/strong>: A card that is printed and shipped to the user. You <em>do not<\/em> receive the card details in the API response. Sending a request to create a physical card also starts an order to manufacture the card.<\/li>\n<\/ul>\n\n<div id=\"tabkWm3o\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Physical&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When creating a physical card, you must include additional information, such as the card manufacturing profile and the delivery details.&lt;\\\/p&gt;\\n&lt;p&gt;To create a physical card, make a POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentInstruments&lt;\\\/a&gt; request specifying:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Parameter&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The payment instrument type, set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;card&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-balanceAccountId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balanceAccountId&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The balance account ID to associate with the card. You can &lt;a href=\\&quot;\\\/pt\\\/issuing\\\/manage-cards#update-balance-account-id\\&quot;&gt;change the balance account associated with a card at a later time&lt;\\\/a&gt; as long as the card &lt;code&gt;status&lt;\\\/code&gt; is set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments__reqParam_card-formFactor\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;card.formFactor&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The form factor of the card, set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;physical&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-card-cardholderName\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;card.cardholderName&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The name of the cardholder.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments__reqParam_card-brand\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;card.brand&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The card brand.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-card-brandVariant\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;card.brandVariant&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The brand variant of the card.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-card-configuration\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;card.configuration&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Object that contains the settings for the physical card, including &lt;a href=\\&quot;#visual-design\\&quot;&gt;design&lt;\\\/a&gt; and the &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments__reqParam_card-configuration-configurationProfileId\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;configurationProfileId&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-status\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;status&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td&gt;By default, cards are created with an &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;active&lt;\\\/strong&gt;&lt;\\\/span&gt;  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-status\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;status&lt;\\\/a&gt;. We recommended that you create physical cards with an &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt; status, to keep them secure from use until they are delivered to the cardholder.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;p&gt;In your request, you can also include optional parameters such as a human-readable  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-description\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;description&lt;\\\/a&gt; to help your staff differentiate between multiple cards under one balance account.&lt;\\\/p&gt;\\n&lt;p&gt;The following example shows how to create a physical card linked to a balance account with &lt;code&gt;id&lt;\\\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;BA1234123412341234&lt;\\\/strong&gt;&lt;\\\/span&gt;. In this example, we create a card with &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt; status.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Create a physical card&#039;\\&quot; :id=\\&quot;&#039;create-card-physical-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 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n    \\\\&amp;quot;issuingCountryCode\\\\&amp;quot;: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n    \\\\&amp;quot;balanceAccountId\\\\&amp;quot;: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n    \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;inactive\\\\&amp;quot;,\\\\n    \\\\&amp;quot;card\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;formFactor\\\\&amp;quot;: \\\\&amp;quot;physical\\\\&amp;quot;,\\\\n      \\\\&amp;quot;brand\\\\&amp;quot;: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n      \\\\&amp;quot;brandVariant\\\\&amp;quot;: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n      \\\\&amp;quot;cardholderName\\\\&amp;quot;: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n      \\\\&amp;quot;deliveryContact\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;address\\\\&amp;quot;: {\\\\n          \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;Amsterdam\\\\&amp;quot;,\\\\n          \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n          \\\\&amp;quot;stateOrProvince\\\\&amp;quot;: \\\\&amp;quot;NH\\\\&amp;quot;,\\\\n          \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;,\\\\n          \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;50\\\\&amp;quot;,\\\\n          \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;1020CD\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;name\\\\&amp;quot;: {\\\\n          \\\\&amp;quot;firstName\\\\&amp;quot;: \\\\&amp;quot;Sam\\\\&amp;quot;,\\\\n          \\\\&amp;quot;lastName\\\\&amp;quot;: \\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n        }\\\\n      },\\\\n      \\\\&amp;quot;configuration\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;configurationProfileId\\\\&amp;quot;: \\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;\\\\n      }\\\\n    },\\\\n    \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;{hint:Your human-readable description for the card.}S. Hopper - Main card{\\\\\\\/hint}\\\\&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)\\\\nDeliveryAddress deliveryAddress = new DeliveryAddress()\\\\n  .country(\\\\&amp;quot;NL\\\\&amp;quot;)\\\\n  .stateOrProvince(\\\\&amp;quot;NH\\\\&amp;quot;)\\\\n  .city(\\\\&amp;quot;Amsterdam\\\\&amp;quot;)\\\\n  .postalCode(\\\\&amp;quot;1020CD\\\\&amp;quot;)\\\\n  .line2(\\\\&amp;quot;50\\\\&amp;quot;)\\\\n  .line1(\\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;);\\\\n\\\\nName name = new Name()\\\\n  .firstName(\\\\&amp;quot;Sam\\\\&amp;quot;)\\\\n  .lastName(\\\\&amp;quot;Hopper\\\\&amp;quot;);\\\\n\\\\nCardConfiguration cardConfiguration = new CardConfiguration()\\\\n  .configurationProfileId(\\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;);\\\\n\\\\nDeliveryContact deliveryContact = new DeliveryContact()\\\\n  .address(deliveryAddress)\\\\n  .name(name);\\\\n\\\\nCardInfo cardInfo = new CardInfo()\\\\n  .brandVariant(\\\\&amp;quot;mcdebit\\\\&amp;quot;)\\\\n  .configuration(cardConfiguration)\\\\n  .formFactor(CardInfo.FormFactorEnum.PHYSICAL)\\\\n  .cardholderName(\\\\&amp;quot;Sam Hopper\\\\&amp;quot;)\\\\n  .deliveryContact(deliveryContact)\\\\n  .brand(\\\\&amp;quot;mc\\\\&amp;quot;);\\\\n\\\\nPaymentInstrumentInfo paymentInstrumentInfo = new PaymentInstrumentInfo()\\\\n  .balanceAccountId(\\\\&amp;quot;BA1234123412341234\\\\&amp;quot;)\\\\n  .description(\\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;)\\\\n  .type(PaymentInstrumentInfo.TypeEnum.CARD)\\\\n  .issuingCountryCode(\\\\&amp;quot;NL\\\\&amp;quot;)\\\\n  .card(cardInfo)\\\\n  .status(PaymentInstrumentInfo.StatusEnum.INACTIVE);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nPaymentInstrumentsApi service = new PaymentInstrumentsApi(client);\\\\nPaymentInstrument response = service.createPaymentInstrument(paymentInstrumentInfo, 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\\\\\\\\CardConfiguration;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\DeliveryContact;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\DeliveryAddress;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\Name;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\CardInfo;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentInfo;\\\\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$deliveryAddress = new DeliveryAddress();\\\\n$deliveryAddress\\\\n  -&amp;gt;setCountry(\\\\&amp;quot;NL\\\\&amp;quot;)\\\\n  -&amp;gt;setStateOrProvince(\\\\&amp;quot;NH\\\\&amp;quot;)\\\\n  -&amp;gt;setCity(\\\\&amp;quot;Amsterdam\\\\&amp;quot;)\\\\n  -&amp;gt;setPostalCode(\\\\&amp;quot;1020CD\\\\&amp;quot;)\\\\n  -&amp;gt;setLine2(\\\\&amp;quot;50\\\\&amp;quot;)\\\\n  -&amp;gt;setLine1(\\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;);\\\\n\\\\n$name = new Name();\\\\n$name\\\\n  -&amp;gt;setFirstName(\\\\&amp;quot;Sam\\\\&amp;quot;)\\\\n  -&amp;gt;setLastName(\\\\&amp;quot;Hopper\\\\&amp;quot;);\\\\n\\\\n$cardConfiguration = new CardConfiguration();\\\\n$cardConfiguration\\\\n  -&amp;gt;setConfigurationProfileId(\\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;);\\\\n\\\\n$deliveryContact = new DeliveryContact();\\\\n$deliveryContact\\\\n  -&amp;gt;setAddress($deliveryAddress)\\\\n  -&amp;gt;setName($name);\\\\n\\\\n$cardInfo = new CardInfo();\\\\n$cardInfo\\\\n  -&amp;gt;setBrandVariant(\\\\&amp;quot;mcdebit\\\\&amp;quot;)\\\\n  -&amp;gt;setConfiguration($cardConfiguration)\\\\n  -&amp;gt;setFormFactor(\\\\&amp;quot;physical\\\\&amp;quot;)\\\\n  -&amp;gt;setCardholderName(\\\\&amp;quot;Sam Hopper\\\\&amp;quot;)\\\\n  -&amp;gt;setDeliveryContact($deliveryContact)\\\\n  -&amp;gt;setBrand(\\\\&amp;quot;mc\\\\&amp;quot;);\\\\n\\\\n$paymentInstrumentInfo = new PaymentInstrumentInfo();\\\\n$paymentInstrumentInfo\\\\n  -&amp;gt;setBalanceAccountId(\\\\&amp;quot;BA1234123412341234\\\\&amp;quot;)\\\\n  -&amp;gt;setDescription(\\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;)\\\\n  -&amp;gt;setType(\\\\&amp;quot;card\\\\&amp;quot;)\\\\n  -&amp;gt;setIssuingCountryCode(\\\\&amp;quot;NL\\\\&amp;quot;)\\\\n  -&amp;gt;setCard($cardInfo)\\\\n  -&amp;gt;setStatus(\\\\&amp;quot;inactive\\\\&amp;quot;);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\n$service = new PaymentInstrumentsApi($client);\\\\n$response = $service-&amp;gt;createPaymentInstrument($paymentInstrumentInfo);&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)\\\\nDeliveryAddress deliveryAddress = new DeliveryAddress\\\\n{\\\\n  Country = \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  StateOrProvince = \\\\&amp;quot;NH\\\\&amp;quot;,\\\\n  City = \\\\&amp;quot;Amsterdam\\\\&amp;quot;,\\\\n  PostalCode = \\\\&amp;quot;1020CD\\\\&amp;quot;,\\\\n  Line2 = \\\\&amp;quot;50\\\\&amp;quot;,\\\\n  Line1 = \\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;\\\\n};\\\\n\\\\nName name = new Name\\\\n{\\\\n  FirstName = \\\\&amp;quot;Sam\\\\&amp;quot;,\\\\n  LastName = \\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n};\\\\n\\\\nCardConfiguration cardConfiguration = new CardConfiguration\\\\n{\\\\n  ConfigurationProfileId = \\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;\\\\n};\\\\n\\\\nDeliveryContact deliveryContact = new DeliveryContact\\\\n{\\\\n  Address = deliveryAddress,\\\\n  Name = name\\\\n};\\\\n\\\\nCardInfo cardInfo = new CardInfo\\\\n{\\\\n  BrandVariant = \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n  Configuration = cardConfiguration,\\\\n  FormFactor = CardInfo.FormFactorEnum.Physical,\\\\n  CardholderName = \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n  DeliveryContact = deliveryContact,\\\\n  Brand = \\\\&amp;quot;mc\\\\&amp;quot;\\\\n};\\\\n\\\\nPaymentInstrumentInfo paymentInstrumentInfo = new PaymentInstrumentInfo\\\\n{\\\\n  BalanceAccountId = \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  Description = \\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;,\\\\n  Type = PaymentInstrumentInfo.TypeEnum.Card,\\\\n  IssuingCountryCode = \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  Card = cardInfo,\\\\n  Status = PaymentInstrumentInfo.StatusEnum.Inactive\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nvar service = new PaymentInstrumentsService(client);\\\\nvar response = service.CreatePaymentInstrument(paymentInstrumentInfo);&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 paymentInstrumentInfo = {\\\\n  type: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n  issuingCountryCode: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  balanceAccountId: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  status: \\\\&amp;quot;inactive\\\\&amp;quot;,\\\\n  card: {\\\\n    formFactor: \\\\&amp;quot;physical\\\\&amp;quot;,\\\\n    brand: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n    brandVariant: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n    cardholderName: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n    deliveryContact: {\\\\n      address: {\\\\n        city: \\\\&amp;quot;Amsterdam\\\\&amp;quot;,\\\\n        country: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n        stateOrProvince: \\\\&amp;quot;NH\\\\&amp;quot;,\\\\n        line1: \\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;,\\\\n        line2: \\\\&amp;quot;50\\\\&amp;quot;,\\\\n        postalCode: \\\\&amp;quot;1020CD\\\\&amp;quot;\\\\n      },\\\\n      name: {\\\\n        firstName: \\\\&amp;quot;Sam\\\\&amp;quot;,\\\\n        lastName: \\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n      }\\\\n    },\\\\n    configuration: {\\\\n      configurationProfileId: \\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;\\\\n    }\\\\n  },\\\\n  description: \\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.createPaymentInstrument(paymentInstrumentInfo);&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)\\\\ndeliveryAddress := balancePlatform.DeliveryAddress{\\\\n  Country: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  StateOrProvince: common.PtrString(\\\\&amp;quot;NH\\\\&amp;quot;),\\\\n  City: common.PtrString(\\\\&amp;quot;Amsterdam\\\\&amp;quot;),\\\\n  PostalCode: common.PtrString(\\\\&amp;quot;1020CD\\\\&amp;quot;),\\\\n  Line2: common.PtrString(\\\\&amp;quot;50\\\\&amp;quot;),\\\\n  Line1: common.PtrString(\\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;),\\\\n}\\\\n\\\\nname := balancePlatform.Name{\\\\n  FirstName: \\\\&amp;quot;Sam\\\\&amp;quot;,\\\\n  LastName: \\\\&amp;quot;Hopper\\\\&amp;quot;,\\\\n}\\\\n\\\\ncardConfiguration := balancePlatform.CardConfiguration{\\\\n  ConfigurationProfileId: \\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;,\\\\n}\\\\n\\\\ndeliveryContact := balancePlatform.DeliveryContact{\\\\n  Address: deliveryAddress,\\\\n  Name: name,\\\\n}\\\\n\\\\ncardInfo := balancePlatform.CardInfo{\\\\n  BrandVariant: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n  Configuration: &amp;amp;cardConfiguration,\\\\n  FormFactor: \\\\&amp;quot;physical\\\\&amp;quot;,\\\\n  CardholderName: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n  DeliveryContact: &amp;amp;deliveryContact,\\\\n  Brand: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n}\\\\n\\\\npaymentInstrumentInfo := balancePlatform.PaymentInstrumentInfo{\\\\n  BalanceAccountId: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  Description: common.PtrString(\\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;),\\\\n  Type: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n  IssuingCountryCode: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  Card: &amp;amp;cardInfo,\\\\n  Status: common.PtrString(\\\\&amp;quot;inactive\\\\&amp;quot;),\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nservice := client.BalancePlatform()\\\\nreq := service.PaymentInstrumentsApi.CreatePaymentInstrumentInput().PaymentInstrumentInfo(paymentInstrumentInfo)\\\\nres, httpRes, err := service.PaymentInstrumentsApi.CreatePaymentInstrument(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;type\\\\&amp;quot;: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n  \\\\&amp;quot;issuingCountryCode\\\\&amp;quot;: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  \\\\&amp;quot;balanceAccountId\\\\&amp;quot;: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;inactive\\\\&amp;quot;,\\\\n  \\\\&amp;quot;card\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;formFactor\\\\&amp;quot;: \\\\&amp;quot;physical\\\\&amp;quot;,\\\\n    \\\\&amp;quot;brand\\\\&amp;quot;: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n    \\\\&amp;quot;brandVariant\\\\&amp;quot;: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n    \\\\&amp;quot;cardholderName\\\\&amp;quot;: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n    \\\\&amp;quot;deliveryContact\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;address\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;Amsterdam\\\\&amp;quot;,\\\\n        \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n        \\\\&amp;quot;stateOrProvince\\\\&amp;quot;: \\\\&amp;quot;NH\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;50\\\\&amp;quot;,\\\\n        \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;1020CD\\\\&amp;quot;\\\\n      },\\\\n      \\\\&amp;quot;name\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;firstName\\\\&amp;quot;: \\\\&amp;quot;Sam\\\\&amp;quot;,\\\\n        \\\\&amp;quot;lastName\\\\&amp;quot;: \\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n      }\\\\n    },\\\\n    \\\\&amp;quot;configuration\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;configurationProfileId\\\\&amp;quot;: \\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;\\\\n    }\\\\n  },\\\\n  \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.create_payment_instrument(request=json_request)&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  :type =&amp;gt; &#039;card&#039;,\\\\n  :issuingCountryCode =&amp;gt; &#039;NL&#039;,\\\\n  :balanceAccountId =&amp;gt; &#039;BA1234123412341234&#039;,\\\\n  :status =&amp;gt; &#039;inactive&#039;,\\\\n  :card =&amp;gt; {\\\\n    :formFactor =&amp;gt; &#039;physical&#039;,\\\\n    :brand =&amp;gt; &#039;mc&#039;,\\\\n    :brandVariant =&amp;gt; &#039;mcdebit&#039;,\\\\n    :cardholderName =&amp;gt; &#039;Sam Hopper&#039;,\\\\n    :deliveryContact =&amp;gt; {\\\\n      :address =&amp;gt; {\\\\n        :city =&amp;gt; &#039;Amsterdam&#039;,\\\\n        :country =&amp;gt; &#039;NL&#039;,\\\\n        :stateOrProvince =&amp;gt; &#039;NH&#039;,\\\\n        :line1 =&amp;gt; &#039;274 Brannan Street, Suite 600&#039;,\\\\n        :line2 =&amp;gt; &#039;50&#039;,\\\\n        :postalCode =&amp;gt; &#039;1020CD&#039;\\\\n      },\\\\n      :name =&amp;gt; {\\\\n        :firstName =&amp;gt; &#039;Sam&#039;,\\\\n        :lastName =&amp;gt; &#039;Hopper&#039;\\\\n      }\\\\n    },\\\\n    :configuration =&amp;gt; {\\\\n      :configurationProfileId =&amp;gt; &#039;YOUR_CONFIGURATION_PROFILE_ID&#039;\\\\n    }\\\\n  },\\\\n  :description =&amp;gt; &#039;S. Hopper - Main card&#039;\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.create_payment_instrument(request_body)&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 deliveryAddress: Types.balancePlatform.DeliveryAddress = {\\\\n  country: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  stateOrProvince: \\\\&amp;quot;NH\\\\&amp;quot;,\\\\n  city: \\\\&amp;quot;Amsterdam\\\\&amp;quot;,\\\\n  postalCode: \\\\&amp;quot;1020CD\\\\&amp;quot;,\\\\n  line2: \\\\&amp;quot;50\\\\&amp;quot;,\\\\n  line1: \\\\&amp;quot;274 Brannan Street, Suite 600\\\\&amp;quot;\\\\n};\\\\n\\\\nconst name: Types.balancePlatform.Name = {\\\\n  firstName: \\\\&amp;quot;Sam\\\\&amp;quot;,\\\\n  lastName: \\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n};\\\\n\\\\nconst cardConfiguration: Types.balancePlatform.CardConfiguration = {\\\\n  configurationProfileId: \\\\&amp;quot;YOUR_CONFIGURATION_PROFILE_ID\\\\&amp;quot;\\\\n};\\\\n\\\\nconst deliveryContact: Types.balancePlatform.DeliveryContact = {\\\\n  address: deliveryAddress,\\\\n  name: name\\\\n};\\\\n\\\\nconst cardInfo: Types.balancePlatform.CardInfo = {\\\\n  brandVariant: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n  configuration: cardConfiguration,\\\\n  formFactor: Types.balancePlatform.CardInfo.FormFactorEnum.Physical,\\\\n  cardholderName: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n  deliveryContact: deliveryContact,\\\\n  brand: \\\\&amp;quot;mc\\\\&amp;quot;\\\\n};\\\\n\\\\nconst paymentInstrumentInfo: Types.balancePlatform.PaymentInstrumentInfo = {\\\\n  balanceAccountId: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;S. Hopper - Main card\\\\&amp;quot;,\\\\n  type: Types.balancePlatform.PaymentInstrumentInfo.TypeEnum.Card,\\\\n  issuingCountryCode: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  card: cardInfo,\\\\n  status: Types.balancePlatform.PaymentInstrumentInfo.StatusEnum.Inactive\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.createPaymentInstrument(paymentInstrumentInfo);&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&lt;p&gt;The response returns the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;paymentInstrument&lt;\\\/strong&gt;&lt;\\\/span&gt; resource, identified by its unique &lt;code&gt;id&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response&#039;\\&quot; :id=\\&quot;&#039;create-card-physical-response&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n  \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA1234123412341234\\\\\\&quot;,\\\\n  \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;S.Hopper - Main card\\\\\\&quot;,\\\\n  \\\\\\&quot;issuingCountryCode\\\\\\&quot;: \\\\\\&quot;NL\\\\\\&quot;,\\\\n  \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;inactive\\\\\\&quot;,\\\\n  \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;card\\\\\\&quot;,\\\\n  \\\\\\&quot;card\\\\\\&quot;: {\\\\n    \\\\\\&quot;brand\\\\\\&quot;: \\\\\\&quot;mc\\\\\\&quot;,\\\\n    \\\\\\&quot;brandVariant\\\\\\&quot;: \\\\\\&quot;mcdebit\\\\\\&quot;,\\\\n    \\\\\\&quot;cardholderName\\\\\\&quot;: \\\\\\&quot;Sam Hopper\\\\\\&quot;,\\\\n    \\\\\\&quot;configuration\\\\\\&quot;: {\\\\n      \\\\\\&quot;configurationProfileId\\\\\\&quot;: \\\\\\&quot;YOUR_CONFIGURATION_PROFILE_ID\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;deliveryContact\\\\\\&quot;: {\\\\n      \\\\\\&quot;address\\\\\\&quot;: {\\\\n        \\\\\\&quot;city\\\\\\&quot;: \\\\\\&quot;Amsterdam\\\\\\&quot;,\\\\n        \\\\\\&quot;country\\\\\\&quot;: \\\\\\&quot;NL\\\\\\&quot;,\\\\n        \\\\\\&quot;stateOrProvince\\\\\\&quot;: \\\\\\&quot;NH\\\\\\&quot;,\\\\n        \\\\\\&quot;line1\\\\\\&quot;: \\\\\\&quot;274 Brannan Street, Suite 600\\\\\\&quot;,\\\\n        \\\\\\&quot;line2\\\\\\&quot;: \\\\\\&quot;50\\\\\\&quot;,\\\\n        \\\\\\&quot;postalCode\\\\\\&quot;: \\\\\\&quot;1020CD\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;name\\\\\\&quot;: {\\\\n        \\\\\\&quot;firstName\\\\\\&quot;: \\\\\\&quot;Sam\\\\\\&quot;,\\\\n        \\\\\\&quot;lastName\\\\\\&quot;: \\\\\\&quot;Hopper\\\\\\&quot;\\\\n      }\\\\n    },\\\\n    \\\\\\&quot;formFactor\\\\\\&quot;: \\\\\\&quot;physical\\\\\\&quot;,\\\\n    \\\\\\&quot;bin\\\\\\&quot;:\\\\\\&quot;555544\\\\\\&quot;,\\\\n    \\\\\\&quot;expiration\\\\\\&quot;:{\\\\n      \\\\\\&quot;month\\\\\\&quot;:\\\\\\&quot;08\\\\\\&quot;,\\\\n      \\\\\\&quot;year\\\\\\&quot;:\\\\\\&quot;2024\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;lastFour\\\\\\&quot;:\\\\\\&quot;1589\\\\\\&quot;\\\\n  },\\\\n  \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;PI3227C223222B5BPCMFXD2XG\\\\\\&quot;\\\\n}\\&quot;}]&#039; :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&lt;p&gt;In the test environment, you can create physical cards but you will not receive them.&lt;\\\/p&gt;\\n&lt;p&gt;However, you will asynchronously receive updates about your physical card order:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform-webhooks\\\/latest\\\/post\\\/balancePlatform.cardorder.created\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.cardorder.created&lt;\\\/a&gt;&amp;#58; card order created.&lt;\\\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform-webhooks\\\/latest\\\/post\\\/balancePlatform.cardorder.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.cardorder.updated&lt;\\\/a&gt;&amp;#58; card order updated.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;physical_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Virtual&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To create a virtual card, make a POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentInstruments&lt;\\\/a&gt; request specifying:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Parameter&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The payment instrument type, set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;card&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-balanceAccountId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balanceAccountId&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The balance account ID that should be associated with the card. You can also &lt;a href=\\&quot;\\\/pt\\\/issuing\\\/manage-cards#update-balance-account-id\\&quot;&gt;update the balance account associated with a card at a later time&lt;\\\/a&gt; as long as the card &lt;code&gt;status&lt;\\\/code&gt; is &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments__reqParam_card\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;card&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Object that contains the card configuration, such as: &lt;ul&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;The card  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-card-formFactor\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;formFactor&lt;\\\/a&gt;, set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;virtual&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;The &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments__reqParam_card-cardholderName\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;cardholderName&lt;\\\/a&gt; to be shown on the card.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;The card  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-card-brand\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;brand&lt;\\\/a&gt;.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;The card &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments__reqParam_card-brandVariant\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;brandVariant&lt;\\\/a&gt;.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-status\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;status&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td&gt;By default, cards are created with an &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;active&lt;\\\/strong&gt;&lt;\\\/span&gt;  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-status\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;status&lt;\\\/a&gt;. Depending on your use case, you might want to set the status to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;p&gt;In your request, you can also include optional parameters such as a human-readable  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/post\\\/paymentInstruments#request-description\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;description&lt;\\\/a&gt; to help your staff differentiate between multiple cards under one balance account.&lt;\\\/p&gt;\\n&lt;p&gt;The following example shows how to create a virtual card linked to a balance account with &lt;code&gt;id&lt;\\\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;BA1234123412341234&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;Create a virtual card&#039;\\&quot; :id=\\&quot;&#039;create-card-virtual-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 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n    \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;{hint:Your human-readable description for this card}S.Hopper - Main card{\\\\\\\/hint}\\\\&amp;quot;,\\\\n    \\\\&amp;quot;balanceAccountId\\\\&amp;quot;: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n    \\\\&amp;quot;issuingCountryCode\\\\&amp;quot;: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n    \\\\&amp;quot;card\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;cardholderName\\\\&amp;quot;: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n      \\\\&amp;quot;brand\\\\&amp;quot;: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n      \\\\&amp;quot;brandVariant\\\\&amp;quot;: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n      \\\\&amp;quot;formFactor\\\\&amp;quot;: \\\\&amp;quot;virtual\\\\&amp;quot;\\\\n    }\\\\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)\\\\nCardInfo cardInfo = new CardInfo()\\\\n  .brandVariant(\\\\&amp;quot;mcdebit\\\\&amp;quot;)\\\\n  .formFactor(CardInfo.FormFactorEnum.VIRTUAL)\\\\n  .cardholderName(\\\\&amp;quot;Sam Hopper\\\\&amp;quot;)\\\\n  .brand(\\\\&amp;quot;mc\\\\&amp;quot;);\\\\n\\\\nPaymentInstrumentInfo paymentInstrumentInfo = new PaymentInstrumentInfo()\\\\n  .balanceAccountId(\\\\&amp;quot;BA1234123412341234\\\\&amp;quot;)\\\\n  .description(\\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;)\\\\n  .type(PaymentInstrumentInfo.TypeEnum.CARD)\\\\n  .issuingCountryCode(\\\\&amp;quot;NL\\\\&amp;quot;)\\\\n  .card(cardInfo);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nPaymentInstrumentsApi service = new PaymentInstrumentsApi(client);\\\\nPaymentInstrument response = service.createPaymentInstrument(paymentInstrumentInfo, 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\\\\\\\\CardInfo;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\BalancePlatform\\\\\\\\PaymentInstrumentInfo;\\\\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$cardInfo = new CardInfo();\\\\n$cardInfo\\\\n  -&amp;gt;setBrandVariant(\\\\&amp;quot;mcdebit\\\\&amp;quot;)\\\\n  -&amp;gt;setFormFactor(\\\\&amp;quot;virtual\\\\&amp;quot;)\\\\n  -&amp;gt;setCardholderName(\\\\&amp;quot;Sam Hopper\\\\&amp;quot;)\\\\n  -&amp;gt;setBrand(\\\\&amp;quot;mc\\\\&amp;quot;);\\\\n\\\\n$paymentInstrumentInfo = new PaymentInstrumentInfo();\\\\n$paymentInstrumentInfo\\\\n  -&amp;gt;setBalanceAccountId(\\\\&amp;quot;BA1234123412341234\\\\&amp;quot;)\\\\n  -&amp;gt;setDescription(\\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;)\\\\n  -&amp;gt;setType(\\\\&amp;quot;card\\\\&amp;quot;)\\\\n  -&amp;gt;setIssuingCountryCode(\\\\&amp;quot;NL\\\\&amp;quot;)\\\\n  -&amp;gt;setCard($cardInfo);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\n$service = new PaymentInstrumentsApi($client);\\\\n$response = $service-&amp;gt;createPaymentInstrument($paymentInstrumentInfo);&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)\\\\nCardInfo cardInfo = new CardInfo\\\\n{\\\\n  BrandVariant = \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n  FormFactor = CardInfo.FormFactorEnum.Virtual,\\\\n  CardholderName = \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n  Brand = \\\\&amp;quot;mc\\\\&amp;quot;\\\\n};\\\\n\\\\nPaymentInstrumentInfo paymentInstrumentInfo = new PaymentInstrumentInfo\\\\n{\\\\n  BalanceAccountId = \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  Description = \\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;,\\\\n  Type = PaymentInstrumentInfo.TypeEnum.Card,\\\\n  IssuingCountryCode = \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  Card = cardInfo\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nvar service = new PaymentInstrumentsService(client);\\\\nvar response = service.CreatePaymentInstrument(paymentInstrumentInfo);&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 paymentInstrumentInfo = {\\\\n  type: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;,\\\\n  balanceAccountId: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  issuingCountryCode: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  card: {\\\\n    cardholderName: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n    brand: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n    brandVariant: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n    formFactor: \\\\&amp;quot;virtual\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.createPaymentInstrument(paymentInstrumentInfo);&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)\\\\ncardInfo := balancePlatform.CardInfo{\\\\n  BrandVariant: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n  FormFactor: \\\\&amp;quot;virtual\\\\&amp;quot;,\\\\n  CardholderName: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n  Brand: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n}\\\\n\\\\npaymentInstrumentInfo := balancePlatform.PaymentInstrumentInfo{\\\\n  BalanceAccountId: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  Description: common.PtrString(\\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;),\\\\n  Type: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n  IssuingCountryCode: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  Card: &amp;amp;cardInfo,\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nservice := client.BalancePlatform()\\\\nreq := service.PaymentInstrumentsApi.CreatePaymentInstrumentInput().PaymentInstrumentInfo(paymentInstrumentInfo)\\\\nres, httpRes, err := service.PaymentInstrumentsApi.CreatePaymentInstrument(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;type\\\\&amp;quot;: \\\\&amp;quot;card\\\\&amp;quot;,\\\\n  \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;,\\\\n  \\\\&amp;quot;balanceAccountId\\\\&amp;quot;: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  \\\\&amp;quot;issuingCountryCode\\\\&amp;quot;: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  \\\\&amp;quot;card\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;cardholderName\\\\&amp;quot;: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n    \\\\&amp;quot;brand\\\\&amp;quot;: \\\\&amp;quot;mc\\\\&amp;quot;,\\\\n    \\\\&amp;quot;brandVariant\\\\&amp;quot;: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n    \\\\&amp;quot;formFactor\\\\&amp;quot;: \\\\&amp;quot;virtual\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.create_payment_instrument(request=json_request)&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  :type =&amp;gt; &#039;card&#039;,\\\\n  :description =&amp;gt; &#039;S.Hopper - Main card&#039;,\\\\n  :balanceAccountId =&amp;gt; &#039;BA1234123412341234&#039;,\\\\n  :issuingCountryCode =&amp;gt; &#039;NL&#039;,\\\\n  :card =&amp;gt; {\\\\n    :cardholderName =&amp;gt; &#039;Sam Hopper&#039;,\\\\n    :brand =&amp;gt; &#039;mc&#039;,\\\\n    :brandVariant =&amp;gt; &#039;mcdebit&#039;,\\\\n    :formFactor =&amp;gt; &#039;virtual&#039;\\\\n  }\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.balancePlatform.payment_instruments_api.create_payment_instrument(request_body)&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 cardInfo: Types.balancePlatform.CardInfo = {\\\\n  brandVariant: \\\\&amp;quot;mcdebit\\\\&amp;quot;,\\\\n  formFactor: Types.balancePlatform.CardInfo.FormFactorEnum.Virtual,\\\\n  cardholderName: \\\\&amp;quot;Sam Hopper\\\\&amp;quot;,\\\\n  brand: \\\\&amp;quot;mc\\\\&amp;quot;\\\\n};\\\\n\\\\nconst paymentInstrumentInfo: Types.balancePlatform.PaymentInstrumentInfo = {\\\\n  balanceAccountId: \\\\&amp;quot;BA1234123412341234\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;S.Hopper - Main card\\\\&amp;quot;,\\\\n  type: Types.balancePlatform.PaymentInstrumentInfo.TypeEnum.Card,\\\\n  issuingCountryCode: \\\\&amp;quot;NL\\\\&amp;quot;,\\\\n  card: cardInfo\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst balancePlatformAPI = new BalancePlatformAPI(client);\\\\nconst response = balancePlatformAPI.PaymentInstrumentsApi.createPaymentInstrument(paymentInstrumentInfo);&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&lt;p&gt;The response returns the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;paymentInstrument&lt;\\\/strong&gt;&lt;\\\/span&gt; resource, identified by its unique &lt;code&gt;id&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response&#039;\\&quot; :id=\\&quot;&#039;create-card-virtual-response&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA1234123412341234\\\\\\&quot;,\\\\n    \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;S.Hopper - Main card\\\\\\&quot;,\\\\n    \\\\\\&quot;issuingCountryCode\\\\\\&quot;: \\\\\\&quot;NL\\\\\\&quot;,\\\\n    \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;active\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;card\\\\\\&quot;,\\\\n    \\\\\\&quot;card\\\\\\&quot;: {\\\\n        \\\\\\&quot;brand\\\\\\&quot;: \\\\\\&quot;mc\\\\\\&quot;,\\\\n        \\\\\\&quot;brandVariant\\\\\\&quot;: \\\\\\&quot;mcdebit\\\\\\&quot;,\\\\n        \\\\\\&quot;cardholderName\\\\\\&quot;: \\\\\\&quot;Sam Hopper\\\\\\&quot;,\\\\n        \\\\\\&quot;formFactor\\\\\\&quot;: \\\\\\&quot;virtual\\\\\\&quot;,\\\\n        \\\\\\&quot;bin\\\\\\&quot;: \\\\\\&quot;555544\\\\\\&quot;,\\\\n        \\\\\\&quot;cvc\\\\\\&quot;: \\\\\\&quot;686\\\\\\&quot;,\\\\n        \\\\\\&quot;expiration\\\\\\&quot;: {\\\\n            \\\\\\&quot;month\\\\\\&quot;: \\\\\\&quot;07\\\\\\&quot;,\\\\n            \\\\\\&quot;year\\\\\\&quot;: \\\\\\&quot;2023\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;lastFour\\\\\\&quot;: \\\\\\&quot;2787\\\\\\&quot;,\\\\n        \\\\\\&quot;number\\\\\\&quot;: \\\\\\&quot;5555444400092787\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;PI3227C223222B5BPCMFXD2XG\\\\\\&quot;\\\\n}\\&quot;}]&#039; :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;:null,&quot;oldTabId&quot;:&quot;virtual_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Assign authorized users to an issued card<\/h2>\n<p>If the account holder is a company, they may want to assign multiple employees as authorized users for the issued company cards they create. If a card has multiple users, all users of a card must be identified when the card(s) is created. We refer to these individuals as authorized users.<\/p>\n<h3>Requirements<\/h3>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">This feature is supported with an <a href=\"\/pt\/issuing\">issuing integration<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/issuing\/manage-access\/api-credentials-web-service\/\">API credentials<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">API credentials for both the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Configuration API<\/a> and  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Before reaching out to your Adyen contact to enable this feature, you must update all issued cards that will have multiple authorized users.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/issuing\/verification-overview\/capabilities\">Capabilities<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Authorized users must have the <span translate=\"no\"><strong>authorisedPaymentInstrumentUser<\/strong><\/span> capability to be able to use the card. Request this capability for all users before creating the card and assigning the users to it.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>To create and assign an authorized user to an issued card:<\/p>\n<ol>\n<li>\n<p>Create a legal entity for the user by making a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request. The following information must be provided for each authorized user:<\/p>\n<ul>\n<li>First and last name<\/li>\n<li>Date of birth (in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format)<\/li>\n<li>Country of residence<\/li>\n<\/ul>\n<p>You need to request the <span translate=\"no\"><strong>authorisedPaymentInstrumentUser<\/strong><\/span> capability for the user by adding the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-capabilities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">capabilities<\/a> array to your request. For an existing legal entity, make a PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request with the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-capabilities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">capabilities<\/a> array in the request body. The initial status of the capability is <code>pending<\/code>.<\/p>\n<p>The user must pass <a href=\"\/pt\/issuing\/verification-overview\/?tab=you_request_capabilities_for_users_0_1\">verification checks<\/a> and be allowed to use the <span translate=\"no\"><strong>authorisedPaymentInstrumentUser<\/strong><\/span> capability. It can take up to 48 hours for a legal entity to pass all verification checks. Therefore, we recommend that you wait at least 48 hours to check the status of the legal entity before you assign them as an authorized user.<\/p>\n<\/li>\n<li>\n<p>To check the user's  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)#responses-200-capabilities-verificationStatus\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">verificationStatus<\/a>, make a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/get\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request, specifying the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> as a path parameter. You must resolve any errors before assigning the legal entity as an authorized user of the card. All users must have the <span translate=\"no\"><strong>authorisedPaymentInstrumentUser<\/strong><\/span> allowed to be able to use the card.<\/p>\n<p>If the status is <code>invalid<\/code>, you need to provide additional information to pass the verification checks. If the status is <code>rejected<\/code>, this is final and the user cannot use the card.<\/p>\n<div class=\"notices green\">\n<p>Note that Adyen performs daily sanction checks against the legal entities of your cards' assigned authorized users. If their capability status changes to <code>invalid<\/code> or <code>rejected<\/code>, the card  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/post\/paymentInstruments#request-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a> is <span translate=\"no\"><strong>suspended<\/strong><\/span> and it cannot be used.<\/p>\n<\/div>\n<\/li>\n<li>\n<p><a href=\"#create\">Create a physical or virtual card<\/a>.<\/p>\n<\/li>\n<li>\n<p>Assign authorized users to the card by making a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/post\/paymentInstruments\/(paymentInstrumentId)\/authorisedCardUsers\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentInstruments\/{id}\/AuthorisedCardUsers<\/a> request with the ID of the payment instrument in the path. Include the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> of the authorized users you want to assign in your request.<\/p>\n<p>Only the corresponding <strong>204<\/strong> HTTP response code is returned if the request is successful.<\/p>\n<\/li>\n<li>\n<p>(Optional) To see the authorized card users for a card, make a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/paymentInstruments\/(paymentInstrumentId)\/authorisedCardUsers\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentInstruments\/{id}\/AuthorisedCardUsers<\/a> request with the ID of the payment instrument in the path.<\/p>\n<\/li>\n<\/ol>\n<p>To update the authorized users for a card, make a PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/patch\/paymentInstruments\/(paymentInstrumentId)\/authorisedCardUsers\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentInstruments\/{id}\/AuthorisedCardUsers<\/a> request with the ID of the payment instrument in the path. Note that this request replaces the entire list of authorized users for the card. For example, to remove one user from the list, include an updated list of users in your PATCH request. Only the corresponding <strong>204<\/strong> HTTP response code is returned if the request is successful.<\/p>\n<p>To delete all users for a card, make a DELETE  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/delete\/paymentInstruments\/(paymentInstrumentId)\/authorisedCardUsers\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentInstruments\/{id}\/AuthorisedCardUsers<\/a> request with the ID of the payment instrument in the path. Only the corresponding <strong>204<\/strong> HTTP response code is returned if the request is successful.<\/p>\n<h2 id=\"physical-cards-live\">Physical cards in live environment<\/h2>\n<p>Before you can create live physical cards, you must have a <a href=\"#visual-design\">design for the card itself and the mailer<\/a>.<\/p>\n<p>After you <a href=\"\/pt\/issuing\/create-cards?tab=physical_2\">create a card<\/a>, it is personalized, printed, and shipped with the information that you provided. If you need to stop a card from being personalized, update the status before it is sent to the manufacturer. Reach out to your Adyen contact to know the schedule for your balance platform.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/issuing\/create-cards","articleFields":{"description":"Learn how to create and activate cards.","next_steps_description":"Before your users can start making purchases with the newly issued card, you will have to choose how to fund the accounts, process payments, and manage the card lifecycle.","next_steps":[{"title":"Process payments","description":"Choose how to authorise card payments.","url":"\/issuing\/authorisation","required":true},{"title":"Manage funds","description":"Add funds to balance accounts.","url":"\/issuing\/add-manage-funds","required":true},{"title":"Manage cards","description":"Activate, suspend, or close a card.","url":"\/issuing\/manage-cards","required":true}],"last_edit_on":"19-01-2021 09:45","parameters":{"directoryPath":"\/issuing"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/issuing\/create-cards","title":"Create cards","content":"After you create an account holder and a balance account, you can start issuing cards. Cards can either be virtual or physical. Cards also have to be associated with a Visa or Mastercard pre-approved use case, called a scheme program. By default, Adyen handles the scheme program for you in the background.\nPCI compliance\nThe scope for PCI compliance depends on your use case&mdash;the type of cards you'll issue and how the cards will be used. To know whether PCI compliance requirements apply to your use case, reach out to your Adyen contact.\nVisual design for physical cards\nBefore you can create physical cards in the live environment, you must have a design for the card itself and the mailer it is sent in. Each card design must be approved by Visa or Mastercard.\nYour Adyen contact will help you to complete and specify the designs.\nCreate a card\nTo issue a card, create a paymentInstrument resource. In the request, specify whether the card is:\n\nVirtual: A card that has no physical form. You receive the card details in the API response.\nPhysical: A card that is printed and shipped to the user. You do not receive the card details in the API response. Sending a request to create a physical card also starts an order to manufacture the card.\n\n\n\n    \n        \n        \n    \n\n\nAssign authorized users to an issued card\nIf the account holder is a company, they may want to assign multiple employees as authorized users for the issued company cards they create. If a card has multiple users, all users of a card must be identified when the card(s) is created. We refer to these individuals as authorized users.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nThis feature is supported with an issuing integration.\n\n\nAPI credentials\nAPI credentials for both the  Configuration API and  Legal Entity Management API.\n\n\nLimitations\nBefore reaching out to your Adyen contact to enable this feature, you must update all issued cards that will have multiple authorized users.\n\n\nCapabilities\nAuthorized users must have the authorisedPaymentInstrumentUser capability to be able to use the card. Request this capability for all users before creating the card and assigning the users to it.\n\n\n\nTo create and assign an authorized user to an issued card:\n\n\nCreate a legal entity for the user by making a POST  \/legalEntities request. The following information must be provided for each authorized user:\n\nFirst and last name\nDate of birth (in YYYY-MM-DD format)\nCountry of residence\n\nYou need to request the authorisedPaymentInstrumentUser capability for the user by adding the  capabilities array to your request. For an existing legal entity, make a PATCH  \/legalEntities\/{id} request with the  capabilities array in the request body. The initial status of the capability is pending.\nThe user must pass verification checks and be allowed to use the authorisedPaymentInstrumentUser capability. It can take up to 48 hours for a legal entity to pass all verification checks. Therefore, we recommend that you wait at least 48 hours to check the status of the legal entity before you assign them as an authorized user.\n\n\nTo check the user's  verificationStatus, make a GET  \/legalEntities\/{id} request, specifying the  id as a path parameter. You must resolve any errors before assigning the legal entity as an authorized user of the card. All users must have the authorisedPaymentInstrumentUser allowed to be able to use the card.\nIf the status is invalid, you need to provide additional information to pass the verification checks. If the status is rejected, this is final and the user cannot use the card.\n\nNote that Adyen performs daily sanction checks against the legal entities of your cards' assigned authorized users. If their capability status changes to invalid or rejected, the card  status is suspended and it cannot be used.\n\n\n\nCreate a physical or virtual card.\n\n\nAssign authorized users to the card by making a POST  \/paymentInstruments\/{id}\/AuthorisedCardUsers request with the ID of the payment instrument in the path. Include the  id of the authorized users you want to assign in your request.\nOnly the corresponding 204 HTTP response code is returned if the request is successful.\n\n\n(Optional) To see the authorized card users for a card, make a GET  \/paymentInstruments\/{id}\/AuthorisedCardUsers request with the ID of the payment instrument in the path.\n\n\nTo update the authorized users for a card, make a PATCH  \/paymentInstruments\/{id}\/AuthorisedCardUsers request with the ID of the payment instrument in the path. Note that this request replaces the entire list of authorized users for the card. For example, to remove one user from the list, include an updated list of users in your PATCH request. Only the corresponding 204 HTTP response code is returned if the request is successful.\nTo delete all users for a card, make a DELETE  \/paymentInstruments\/{id}\/AuthorisedCardUsers request with the ID of the payment instrument in the path. Only the corresponding 204 HTTP response code is returned if the request is successful.\nPhysical cards in live environment\nBefore you can create live physical cards, you must have a design for the card itself and the mailer.\nAfter you create a card, it is personalized, printed, and shipped with the information that you provided. If you need to stop a card from being personalized, update the status before it is sent to the manufacturer. Reach out to your Adyen contact to know the schedule for your balance platform.","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Create cards"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/issuing","lvl2":"\/pt\/issuing\/create-cards"},"levels":3,"category":"Issuing","category_color":"green","tags":["Create","cards"]},"articleFiles":{"create-add-virtual-request.js":"<p alt=\"\">create-add-virtual-request.js<\/p>","create-card-physical-request.js":"<p alt=\"\">create-card-physical-request.js<\/p>","create-card-virtual-request.js":"<p alt=\"\">create-card-virtual-request.js<\/p>"}}
