--- title: "Create a Payment Instrument" method: POST path: "/payment_instruments" tags: ["Payment Instruments"] --- # Create a Payment Instrument `POST /payment_instruments` Create a `Payment Instrument` resource using a card or bank account. {% admonition type="warning" name="Payment Instruments PCI Scope" %} The creation of `Payment Instruments` directly via Finix's API should only be done for testing purposes. You must use [our hosted fields](/guides/online-payments/payment-tokenization/tokenization-forms) or the javascript client to remain out of PCI scope. {% /admonition %} ## Headers - `Finix-Version` string - `Content-Type` string ## Request body - union - CreatePaymentInstrumentCard - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `expiration_month` integer, required — The expiration month of the card (e.g. 12 for December). - `expiration_year` integer, required — The 4-digit expiration year of the card. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string, required — The name of the card owner. This value can get truncated to comply with processor requirements. - `number` string, required — The card or bank account number (no dashes in between numbers). - `security_code` string, nullable — The 3-or 4-digit security code for the card (i.e., the CVV code). While providing a CVV is optional, it is recommended to include it wherever possible to prevent fraud. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party_token` string — Stringified token provided by Apple or Google. Required if using Apple or Google Pay. - `type` 'PAYMENT_CARD', required — Type of `Payment Instrument`. - CreatePaymentInstrumentAccountUpdater - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `expiration_month` integer, required — The expiration month of the card (e.g. 12 for December). - `expiration_year` integer, required — The 4-digit expiration year of the card. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string, required — The name of the card owner. This value can get truncated to comply with processor requirements. - `number` string, required — The card or bank account number (no dashes in between numbers). - `security_code` string, nullable — The 3-or 4-digit security code for the card (i.e., the CVV code). While providing a CVV is optional, it is recommended to include it wherever possible to prevent fraud. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party_token` string — Stringified token provided by Apple or Google. Required if using Apple or Google Pay. - `type` 'PAYMENT_CARD', required — Type of `Payment Instrument`. - CreatePaymentInstrumentNetworkTokens - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `expiration_month` integer, required — The expiration month of the card (e.g. 12 for December). - `expiration_year` integer, required — The 4-digit expiration year of the card. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string, required — The name of the card owner. This value can get truncated to comply with processor requirements. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `number` string, required — The card or bank account number (no dashes in between numbers). - `security_code` string, nullable — The 3-or 4-digit security code for the card (i.e., the CVV code). While providing a CVV is optional, it is recommended to include it wherever possible to prevent fraud. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party_token` string — Stringified token provided by Apple or Google. Required if using Apple or Google Pay. - `type` 'PAYMENT_CARD', required — Type of `Payment Instrument`. - CreatePaymentInstrumentBankAccount - `account_number` string, required — The bank account number (no dashes in between numbers). - `account_type` 'BUSINESS_CHECKING' | 'BUSINESS_SAVINGS' | 'PERSONAL_CHECKING' | 'PERSONAL_SAVINGS', required — The type of bank account. Use the following respective enum when creating a `Payment Instrument` for: - `attempt_bank_account_validation_check` boolean — Verify and validate the `Payment Instrument` to ensure it is suitable for [ACH Direct Debits](/guides/online-payments/bank-payments/ach-direct-debits). Set to `true` to confirm that the `Payment Instrument` can be used for ACH payments. - `bank_code` string, required — The routing number of the bank account. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string — The name of the bank account owner. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `type` 'BANK_ACCOUNT', required — Type of `Payment Instrument`. - CreatePaymentInstrumentPlaidBankAccount - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `third_party` 'PLAID', required — A third-party service that allows for connecting to a bank account. - `third_party_token` string, required — A Plaid `processor_token` created with `processor: finix`. The token must have access to Plaid's `auth` and `identity` products, which can be configured when creating the Plaid `link_token`. For more information, see [Plaid's integration guide](https://plaid.com/docs/auth/partnerships/finix/) and [Finix's Plaid guide](/guides/online-payments/bank-payments/plaid-integration). - `type` 'BANK_ACCOUNT', required — Type of `Payment Instrument`. - CreatePaymentInstrumentCanadianBankAccount - `account_number` string, required — The bank account number (no dashes in between numbers). Canadian bank account numbers cannot exceed 15 characters. - `account_type` 'BUSINESS_CHECKING' | 'BUSINESS_SAVINGS' | 'PERSONAL_CHECKING' | 'PERSONAL_SAVINGS', required — The type of bank account. - `country` 'CAN', required — The 3-letter country code. - `currency` 'CAD', required — The ISO 4217 3-letter currency code. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `institution_number` string, nullable, required — Canadian bank identifier (EFT). Exactly 3 digits that identify the financial institution (e.g., 004 = TD, 002 = Scotiabank). Stored as a string to preserve leading zeros. - `name` string — The name of the bank account owner. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `transit_number` string, nullable, required — Canadian branch/branch-transit identifier (EFT). Exactly 5 digits that identify the branch where the account is held. Stored as a string to preserve leading zeros. - `type` 'BANK_ACCOUNT', required — Type of `Payment Instrument`. - CreatePaymentInstrumentTokenCard - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string — The name of the bank account or card owner. This value can get truncated to comply with processor requirements. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `token` string, required — ID of the `Token` that was returned from the tokenization client or hosted fields - `type` 'TOKEN', required — Type of `Payment Instrument`. - CreatePaymentInstrumentTokenAccountUpdater - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `attempt_bank_account_validation_check` boolean — Verify and validate the `Payment Instrument` to confirm it can be used for [ACH Direct Debits.](/guides/online-payments/bank-payments/ach-direct-debits) - Set to **True** to verify the `Payment Instrument` can be used for ACH payments. - Only `Payment Instruments` created from bank accounts can be used for ACH payments. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string — The name of the bank account or card owner. This value can get truncated to comply with processor requirements. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `token` string, required — ID of the `Token` that was returned from the tokenization client or hosted fields - `type` 'TOKEN', required — Type of `Payment Instrument`. - CreatePaymentInstrumentTokenBankAccount - `attempt_bank_account_validation_check` boolean — Verify and validate the `Payment Instrument` to confirm it can be used for [ACH Direct Debits.](/guides/online-payments/bank-payments/ach-direct-debits) - Set to **True** to verify the `Payment Instrument` can be used for ACH payments. - Only `Payment Instruments` created from bank accounts can be used for ACH payments. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string — The name of the bank account or card owner. This value can get truncated to comply with processor requirements. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `token` string, required — ID of the `Token` that was returned from the tokenization client or hosted fields. - `type` 'TOKEN', required — Type of `Payment Instrument`. - CreatePaymentInstrumentTokenNetworkTokens - `attempt_bank_account_validation_check` boolean — Verify and validate the `Payment Instrument` to confirm it can be used for [ACH Direct Debits.](/guides/online-payments/bank-payments/ach-direct-debits) - Set to **True** to verify the `Payment Instrument` can be used for ACH payments. - Only `Payment Instruments` created from bank accounts can be used for ACH payments. - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `name` string — The name of the bank account or card owner. This value can get truncated to comply with processor requirements. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `token` string, required — ID of the `Token` that was returned from the tokenization client or hosted fields - `type` 'TOKEN', required — Type of `Payment Instrument`. - CreatePaymentInstrumentApplePay - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `identity` string, required — The `Identity#id` of the buyer and owner of the card. - `merchant_identity` string, required — The `id` of the identity used when registering the business with Apple Pay through our registration API. - `name` string — The `id` of the `Identity` used when registering the seller with Apple Pay through our registration API. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party_token` string, required — Stringified token provided by Apple. Required to process Apple Pay transactions. - `type` 'APPLE_PAY', required — Type of `Payment Instrument`. - CreatePaymentInstrumentGooglePay - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `merchant_identity` string, required — The `id` of the identity used when registering the business with Google Pay through our registration API. - `name` string — The name of the bank account or card owner. This value can get truncated to comply with processor requirements. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party_token` string, required — Stringified token provided by Google. Required to process Google Pay transactions. - `type` 'GOOGLE_PAY', required — Type of `Payment Instrument`. - CreatePaymentInstrumentApplePayPassthrough - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `cryptogram` string, required — Wallet-generated cryptogram from the decrypted Apple Pay token. Required when `number` is provided. - `electronic_commerce_indicator_code` string — One-or-two-digit value indicating the authentication method used. The card network and issuer factor this into liability and risk decisions on the authorization. - `expiration_month` integer — Card expiration month (1-12). - `expiration_year` integer — Card expiration year (4-digit). - `identity` string, required — The `Identity#id` of the buyer and owner of the card. - `merchant_identity` string, required — The `id` of the identity used when registering the business with Apple Pay through our registration API. - `name` string — The name of the card owner. - `number` string, required — Network token PAN (DPAN) from the decrypted Apple Pay token. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `type` 'APPLE_PAY', required — Type of `Payment Instrument`. - CreatePaymentInstrumentGooglePayPassthrough - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `cryptogram` string — Wallet-generated cryptogram from the decrypted Google Pay token. Not required for PAN_ONLY tokens, which do not produce a cryptogram. - `electronic_commerce_indicator_code` string — One-or-two-digit value indicating the authentication method used. The card network and issuer factor this into liability and risk decisions on the authorization. - `expiration_month` integer — Card expiration month (1-12). - `expiration_year` integer — Card expiration year (4-digit). - `identity` string, required — The ID of the `Identity` used to create the `Payment Instrument` resource. - `merchant_identity` string, required — The `id` of the identity used when registering the business with Google Pay through our registration API. - `name` string — The name of the bank account or card owner. This value can get truncated to comply with processor requirements. - `number` string, required — Network token PAN (DPAN) from the decrypted Google Pay token. May be a raw PAN for Google Pay. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `type` 'GOOGLE_PAY', required — Type of `Payment Instrument`. ## Response `201` A single Payment Instrument - union - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `account_type` 'BUSINESS_CHECKING' | 'BUSINESS_SAVINGS' | 'PERSONAL_CHECKING' | 'PERSONAL_SAVINGS' — The bank account type. - `application` string — ID of the `Application` the resource was created under. - `bank_account_validation_check` 'INCONCLUSIVE' | 'INVALID' | 'NOT_ATTEMPTED' | 'VALID' — Possible values returned when `attempt_bank_account_validation_check` is `true` or the `Payment Instrument` is used for a `Transfer`: - `INCONCLUSIVE`: A verification check was conducted, but the bank account could not be found or verified with the issuing bank. Please contact the buyer to confirm the details collected or request an alternate method of payment. - `INVALID`: The Payment Instrument was involved in transactions that returned one or more of the following ACH errors: - Account Does Not Allow ACH Transactions - Account is Closed - Account Funds are Frozen - Deceased Account Holder - Invalid Account Number - Invalid Routing Number - No Account on File For further details about the different ACH failure codes, please refer to ACH Direct Debit documentation. - `NOT_ATTEMPTED`: A verification check was not performed, and the Payment Instrument has not been used to create a Transfer or Authorization. - `VALID`: The bank account was successfully verified. The Payment Instrument is eligible for use in creating ACH Direct Debits. - `bank_code` string — The routing number of the bank account. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. See `disabled_message` for possible error codes and their messages. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `USER_INITIATED`: "The payment instrument has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. - `fingerprint` string — Unique ID that represents the tokenized bank account data. - `identity` string — The ID of the `Identity` used to create the resource. - `institution_number` string, nullable — Canadian bank identifier (EFT). Exactly 3 digits that identify the financial institution (e.g., 004 = TD, 002 = Scotiabank). Stored as a string to preserve leading zeros. - `instrument_type` 'BANK_ACCOUNT' — The type of `Payment Instrument`. - `masked_account_number` string, nullable — The last 4 digits of the account number used to create the `Payment Instrument`. - `name` string, nullable — The name of the bank account. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` 'PLAID' | 'PLAID_RESELLER', nullable — This field identifies the external service used to connect the bank account. - `PLAID` indicates that the account details are being sourced via Plaid. - `PLAID_RESELLER` indicates that the account details are being sourced via Plaid using Finix's Reseller flow. - `third_party_token` string, nullable — A Plaid `processor_token` created with `processor: finix`. The token must have access to Plaid's `auth` and `identity` products, which can be configured when creating the `link_token`. For more information, see [Plaid's integration guide](https://plaid.com/docs/auth/partnerships/finix/) and [Finix's Plaid guide](/guides/online-payments/bank-payments/plaid-integration). - `transit_number` string, nullable — Canadian branch/branch-transit identifier (EFT). Exactly 5 digits that identify the branch where the account is held. Stored as a string to preserve leading zeros. - `type` 'BANK_ACCOUNT' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `account_type` 'BUSINESS_CHECKING' | 'BUSINESS_SAVINGS' | 'PERSONAL_CHECKING' | 'PERSONAL_SAVINGS' — The bank account type. - `application` string — ID of the `Application` the resource was created under. - `bank_account_validation_check` 'INCONCLUSIVE' | 'INVALID' | 'NOT_ATTEMPTED' | 'VALID' — Possible values returned when `attempt_bank_account_validation_check` is `true` or the `Payment Instrument` is used for a `Transfer`: - `INCONCLUSIVE`: A verification check was conducted, but the bank account could not be found or verified with the issuing bank. Please contact the buyer to confirm the details collected or request an alternate method of payment. - `INVALID`: The Payment Instrument was involved in transactions that returned one or more of the following ACH errors: - Account Does Not Allow ACH Transactions - Account is Closed - Account Funds are Frozen - Deceased Account Holder - Invalid Account Number - Invalid Routing Number - No Account on File For further details about the different ACH failure codes, please refer to ACH Direct Debit documentation. - `NOT_ATTEMPTED`: A verification check was not performed, and the Payment Instrument has not been used to create a Transfer or Authorization. - `VALID`: The bank account was successfully verified. The Payment Instrument is eligible for use in creating ACH Direct Debits. - `bank_code` string — The routing number of the bank account. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. See `disabled_message` for possible error codes and their messages. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `USER_INITIATED`: "The payment instrument has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. - `fingerprint` string — Unique ID that represents the tokenized bank account data. - `identity` string — The ID of the `Identity` used to create the resource. - `institution_number` string, nullable — Canadian bank identifier (EFT). Exactly 3 digits that identify the financial institution (e.g., 004 = TD, 002 = Scotiabank). Stored as a string to preserve leading zeros. - `instrument_type` 'BANK_ACCOUNT' — The type of `Payment Instrument`. - `masked_account_number` string, nullable — The last 4 digits of the account number used to create the `Payment Instrument`. - `name` string, nullable — The name of the bank account. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` 'PLAID' | 'PLAID_RESELLER', nullable — This field identifies the external service used to connect the bank account. - `PLAID` indicates that the account details are being sourced via Plaid. - `PLAID_RESELLER` indicates that the account details are being sourced via Plaid using Finix's Reseller flow. - `third_party_token` string, nullable — A Plaid `processor_token` created with `processor: finix`. The token must have access to Plaid's `auth` and `identity` products, which can be configured when creating the `link_token`. For more information, see [Plaid's integration guide](https://plaid.com/docs/auth/partnerships/finix/) and [Finix's Plaid guide](/guides/online-payments/bank-payments/plaid-integration). - `transit_number` string, nullable — Canadian branch/branch-transit identifier (EFT). Exactly 5 digits that identify the branch where the account is held. Stored as a string to preserve leading zeros. - `type` 'BANK_ACCOUNT' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `account_type` 'BUSINESS_CHECKING' | 'BUSINESS_SAVINGS' | 'PERSONAL_CHECKING' | 'PERSONAL_SAVINGS' — The bank account type. - `application` string — ID of the `Application` the resource was created under. - `bank_account_validation_check` 'INCONCLUSIVE' | 'INVALID' | 'NOT_ATTEMPTED' | 'VALID' — Possible values returned when `attempt_bank_account_validation_check` is `true` or the `Payment Instrument` is used for a `Transfer`: - `INCONCLUSIVE`: A verification check was conducted, but the bank account could not be found or verified with the issuing bank. Please contact the buyer to confirm the details collected or request an alternate method of payment. - `INVALID`: The Payment Instrument was involved in transactions that returned one or more of the following ACH errors: - Account Does Not Allow ACH Transactions - Account is Closed - Account Funds are Frozen - Deceased Account Holder - Invalid Account Number - Invalid Routing Number - No Account on File For further details about the different ACH failure codes, please refer to ACH Direct Debit documentation. - `NOT_ATTEMPTED`: A verification check was not performed, and the Payment Instrument has not been used to create a Transfer or Authorization. - `VALID`: The bank account was successfully verified. The Payment Instrument is eligible for use in creating ACH Direct Debits. - `bank_code` string — The routing number of the bank account. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. See `disabled_message` for possible error codes and their messages. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `USER_INITIATED`: "The payment instrument has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. - `fingerprint` string — Unique ID that represents the tokenized bank account data. - `identity` string — The ID of the `Identity` used to create the resource. - `institution_number` string, nullable — Canadian bank identifier (EFT). Exactly 3 digits that identify the financial institution (e.g., 004 = TD, 002 = Scotiabank). Stored as a string to preserve leading zeros. - `instrument_type` 'BANK_ACCOUNT' — The type of `Payment Instrument`. - `masked_account_number` string, nullable — The last 4 digits of the account number used to create the `Payment Instrument`. - `name` string, nullable — The name of the bank account. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` 'PLAID' | 'PLAID_RESELLER', nullable — This field identifies the external service used to connect the bank account. - `PLAID` indicates that the account details are being sourced via Plaid. - `PLAID_RESELLER` indicates that the account details are being sourced via Plaid using Finix's Reseller flow. - `third_party_token` string, nullable — A Plaid `processor_token` created with `processor: finix`. The token must have access to Plaid's `auth` and `identity` products, which can be configured when creating the `link_token`. For more information, see [Plaid's integration guide](https://plaid.com/docs/auth/partnerships/finix/) and [Finix's Plaid guide](/guides/online-payments/bank-payments/plaid-integration). - `transit_number` string, nullable — Canadian branch/branch-transit identifier (EFT). Exactly 5 digits that identify the branch where the account is held. Stored as a string to preserve leading zeros. - `type` 'BANK_ACCOUNT' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `account_type` 'BUSINESS_CHECKING' | 'BUSINESS_SAVINGS' | 'PERSONAL_CHECKING' | 'PERSONAL_SAVINGS' — The bank account type. - `application` string — ID of the `Application` the resource was created under. - `bank_account_validation_check` 'INCONCLUSIVE' | 'INVALID' | 'NOT_ATTEMPTED' | 'VALID' — Possible values returned when `attempt_bank_account_validation_check` is `true` or the `Payment Instrument` is used for a `Transfer`: - `INCONCLUSIVE`: A verification check was conducted, but the bank account could not be found or verified with the issuing bank. Please contact the buyer to confirm the details collected or request an alternate method of payment. - `INVALID`: The Payment Instrument was involved in transactions that returned one or more of the following ACH errors: - Account Does Not Allow ACH Transactions - Account is Closed - Account Funds are Frozen - Deceased Account Holder - Invalid Account Number - Invalid Routing Number - No Account on File For further details about the different ACH failure codes, please refer to ACH Direct Debit documentation. - `NOT_ATTEMPTED`: A verification check was not performed, and the Payment Instrument has not been used to create a Transfer or Authorization. - `VALID`: The bank account was successfully verified. The Payment Instrument is eligible for use in creating ACH Direct Debits. - `bank_code` string — The routing number of the bank account. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. See `disabled_message` for possible error codes and their messages. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `USER_INITIATED`: "The payment instrument has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. - `fingerprint` string — Unique ID that represents the tokenized bank account data. - `identity` string — The ID of the `Identity` used to create the resource. - `institution_number` string, nullable — Canadian bank identifier (EFT). Exactly 3 digits that identify the financial institution (e.g., 004 = TD, 002 = Scotiabank). Stored as a string to preserve leading zeros. - `instrument_type` 'BANK_ACCOUNT' — The type of `Payment Instrument`. - `masked_account_number` string, nullable — The last 4 digits of the account number used to create the `Payment Instrument`. - `name` string, nullable — The name of the bank account. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` 'PLAID' | 'PLAID_RESELLER', nullable — This field identifies the external service used to connect the bank account. - `PLAID` indicates that the account details are being sourced via Plaid. - `PLAID_RESELLER` indicates that the account details are being sourced via Plaid using Finix's Reseller flow. - `third_party_token` string, nullable — A Plaid `processor_token` created with `processor: finix`. The token must have access to Plaid's `auth` and `identity` products, which can be configured when creating the `link_token`. For more information, see [Plaid's integration guide](https://plaid.com/docs/auth/partnerships/finix/) and [Finix's Plaid guide](/guides/online-payments/bank-payments/plaid-integration). - `transit_number` string, nullable — Canadian branch/branch-transit identifier (EFT). Exactly 5 digits that identify the branch where the account is held. Stored as a string to preserve leading zeros. - `type` 'BANK_ACCOUNT' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string - object - `id` string — The ID of the resource. - `created_at` string, date-time — Timestamp of when the object was created. - `updated_at` string, date-time — Timestamp of when the object was last updated. - `created_via` 'API' — The method by which the resource was created. - `account_updater_enabled` boolean — When enabled, Finix automatically checks for updates with card networks. This Account Updater functionality: - Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates. - Saves the cardholder the hassle of updating card details across `Merchants` for each of their `Subscriptions`. **Note**: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks. - `address` Address - `line1` string, nullable, required — First line of the address (max 35 characters). - `line2` string, nullable — Second line of the address (max 35 characters). - `city` string, nullable, required — City (max 20 characters). - `region` string, nullable, required — 2-letter State code. - `postal_code` string, nullable, required — Zip or Postal code (max 7 characters). - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable, required - `address_verification` 'POSTAL_CODE_AND_STREET_MATCH' | 'STREET_MATCH' | 'POSTAL_CODE_MATCH' | 'NO_ADDRESS' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'UNKNOWN' — - Details the results of verifying `address` with the issuing bank. - Set to **UNKNOWN** when `address` gets updated. - `application` string — ID of the `Application` the resource was created under. - `bin` string — Bank Identification number for the `Payment Instrument`. - `brand` 'UNKNOWN' | 'DINERS_CLUB_INTERNATIONAL' | 'DANKORT' | 'MIR' | 'TROY' | 'UATP' | 'CHINA_T_UNION' | 'CHINA_UNION_PAY' | 'AMERICAN_EXPRESS' | 'VERVE' | 'RUPAY' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'INTERPAYMENT' | 'INSTAPAYMENT' | 'MAESTRO' | 'VISA' | 'LANKAPAY' | 'DINERS_CLUB' | 'INTERAC' — The `brand` of the card saved in the `Payment Instrument`. - `card_type` 'CREDIT' | 'DEBIT' | 'HSA_FSA' | 'NON_RELOADABLE_PREPAID' | 'RELOADABLE_PREPAID' | 'UNKNOWN' — The type of payment card saved in the `Payment Instrument`. - `country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', nullable - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code. - `disabled_code` 'CARD_ACCOUNT_CLOSED' | 'INVALID_ACCOUNT_NUMBER' | 'LOST_OR_STOLEN_CARD' | 'NON_RELOADABLE_INSUFFICIENT_FUNDS' | 'PICK_UP_CARD' | 'RESTRICTED_CARD' | 'USER_INITIATED', nullable — A code indicating why the `Payment Instrument` was disabled. This field is set when: - The system automatically disables the `Payment Instrument`. - A user manually disables it (returns `USER_INITIATED`). See `disabled_message` for all possible codes and their descriptions. - `disabled_message` string, nullable — A human-readable message explaining why the `Payment Instrument` was disabled. This field provides additional context for the `disabled_code`. The possible error codes/messages are: - `CARD_ACCOUNT_CLOSED`: "The card account has been closed. The card has been disabled to prevent further use." - `INVALID_ACCOUNT_NUMBER`: "The card number is not valid. The card has been disabled to prevent further use." - `LOST_OR_STOLEN_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `NON_RELOADABLE_INSUFFICIENT_FUNDS`: "The card has insufficient funds for the transaction and is non-reloadable. The card has been disabled to prevent further use." - `PICK_UP_CARD`: "The card is reported lost or stolen. The card has been disabled to prevent further use." - `RESTRICTED_CARD`: "The card has a restriction preventing approval for this transaction. The card has been disabled to prevent further use." - `USER_INITIATED`: "The card has been disabled by a user." - `enabled` boolean — Indicates whether the `Payment Instrument` resource is enabled. The default value is `true`; set it to `false` to disable the `Payment Instrument`. The user or the system can update this field to enable or disable the payment instrument. - `expiration_month` integer — Expiration month (e.g. 12 for December). - `expiration_year` integer — 4-digit expiration year. - `fast_funds_indicator` string — Details if Fast Funds is enabled for the card. - `fingerprint` string — Unique ID that represents the tokenized card data. - `identity` string — The ID of the `Identity` used to create the resource. - `instrument_type` 'PAYMENT_CARD' | 'PAYMENT_CARD_PRESENT' | 'TOKEN' — The type of `Payment Instrument`. - `issuer_country` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NON_USA' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'UNKNOWN' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' — The Alpha-3 Code of the country the card was issued in. In addition, the following values are possible: - `NON_USA` - The card was issued outside of the United States. - `UNKNOWN` - The processor did not return an issuer country for this particular BIN. - `last_four` string — Last four digits of the card. - `name` string, nullable — The name of the card owner. - `network_token_enabled` boolean — When enabled, a "network token" replaces raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits: - The token offers increased authorization rates, even for lost or stolen cards, as it remains valid while the physical card is replaced. - Visa reduces interchange fees when using network tokens. - Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system. **Note**: Cards created before the feature is enabled are unaffected. To include them, update the individual `Payment Instrument` to set `network_token_enabled` to `true`. - `network_token_state` 'ACTIVE' | 'CLOSED' | 'FAILED' | 'NOT_ENABLED' | 'SUSPENDED' | 'PENDING' — The state of the network token. The possible enum values are as follows: - `NOT_ENABLED`: The `network_token_state` is `NOT_ENABLED` when the value of `network_token_enabled` on the `Payment Instrument` is `false`. - `PENDING`: Immediately after Finix enables network tokens for a specific card, `network_token_state` is initially set to `PENDING`. - `ACTIVE`: After Finix receives the network token successfully from the card network, `network_token_state` updates to `ACTIVE`. - `FAILED`: In the event that there is an issue with the card network such as service becomes unavailable, `FAILED` is returned. - `SUSPENDED`: When the issuing bank does not allow the network token to be used in transactions, `SUSPENDED` is returned. - `CLOSED`: In the event that the issuing bank has closed the card permanently, `CLOSED` is returned. - `payload_type` 'SOURCE' | 'DESTINATION' - `push_funds_block_indicator` string — Details if the card is enabled to receive push-to-card disbursements. - `name_verification_results` NameVerificationResults, nullable - `first_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's first name. - `last_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's last name. - `middle_name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's middle name. - `name_verification` 'MATCH' | 'NO_MATCH' | 'NOT_SUPPORTED' | 'PARTIAL_MATCH' | 'UNKNOWN' — The result of verifying the cardholder's full name. - `security_code_verification` 'MATCHED' | 'UNKNOWN' | 'UNMATCHED' — Details the results of the Card Verification Code check. - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`) - `third_party` string, nullable — This field is not applicable to payment cards. - `third_party_token` string, nullable — This field is not applicable to payment cards. - `type` 'PAYMENT_CARD' | 'TOKEN' | 'GOOGLE_PAY' | 'APPLE_PAY' — Type of `Payment Instrument`. - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs. - `application` object — Link to the `Application` the request was made under. - `href` string - `authorizations` object — Link to the `Authorizations` created under the resource. - `href` string - `identity` object — Link to the `Identity` the request was made under. - `href` string - `self` object — Link to the resource that was used in the request. - `href` string - `transfers` object — Link to the `Transfers` created under the resource. - `href` string - `updates` object — Link to the `Updates` created under the resource. - `href` string - `verifications` object — Link to the `Verification` that was used to verify the `Merchant` that the request was made under. - `href` string ## Other responses - `400` — Bad Request. The server cannot process the request due to malformed syntax or invalid data. - `401` — Unauthorized. Authentication is required and has failed or has not been provided. - `403` — Forbidden. The client is authenticated but does not have permission to access the resource. - `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted. - `422` — Unprocessable Entity. The syntax of the request content was correct, but the server was unable to process the contained instructions. --- [API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)