3D Secure Sessions2

Authorizations5

Balance Adjustments2

Balances4

Compliance Forms3

Devices6

Disbursement Rules2

Disputes12

Fee Profiles3

Fees4

Files8

Gateway Integrations3

Identities7

Merchants5

Microdeposits2

Onboarding Forms3

Payment Instrument Associations4

Payment Instruments8

Receipts4

Settlement Queue Entries3

Settlements11

Split Transfers2

Subscription Plans4

Subscriptions8

Transfer Attempts2

Transfers6

Users3

Verifications3

Webhooks4

post/identities/{identity_id}/verificationsVerify an Identity

Payment Instruments

Create a Payment Instrument

Changed on Oct 28, 2026

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 or the javascript client to remain out of PCI scope. {% /admonition %}

post/payment_instruments

Request

Base URL
https://finix.sandbox-payments-api.com
Auth
HTTP basic
TypeScript
https://skmtc.dev/finix/apis/finix-api-reference/docs/payment_instruments/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Finix-Versionstring

Example:2022-02-01

Specify the API version of your request. For more details, see Versioning.

Content-Typestring

Example:application/json

The data type being sent in the request body must be application/json.

Request body

Example request

{
  "bank_code": "123456789"
}

Response

A single Payment Instrument

Example response

{
  "fingerprint": "FPRxxxxxxxxxxxxxxxxx"
}

Changes

Oct 28, 2026c62db965e7dc Revision changes
- warning
  added the new CHECKING enum value to the // response property for the response status
- warning
  added the new CHECKING enum value to the // response property for the response status
- warning
  added the new CHECKING enum value to the // response property for the response status
- warning
  added the new CHECKING enum value to the // response property for the response status
- warning
  added the new SAVING enum value to the // response property for the response status
- warning
  added the new SAVING enum value to the // response property for the response status
- warning
  added the new SAVING enum value to the // response property for the response status
- warning
  added the new SAVING enum value to the // response property for the response status
Oct 10, 20264eb2502fcc00 Revision changes
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new ACCOUNT_UPDATER enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SETTLEMENT_REPORT enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new SYSTEM enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status
- warning
  added the new TOKEN_IMPORT enum value to the // response property for the response status

Operation history (6 revisions)