What is a Payment Method?

A Payment Method is a financial instrument used to fund a Payment. Plastiq Connect currently supports bank account and card Payment Methods.

In Plastiq Connect, Payment Methods are defined by a set of core attributes described below:

Payment Method Attributes

Cards

Attribute

Description

API Field Name

Cardholder Name

The name on the card

cardholderName

Account Number

The account number on the dard

accountNumber

CVV

The 3-4 digit card security code (CSC) in the front or back of the card depending on your card brand

cvv

Expiration Date

The expiration date assigned to the card

expirationMonth, expirationYear

Billing Address

The billing address associated with the cardholder

billingAddress

Status

The associated status of the Payment Method in Plastiq Connect's system

status

Bank Accounts

Attribute

Description

API Field Name

Account Owner

The name on the bank account

accountHolderName

Routing Number

The routing number for the bank account

routingNumber

Account Number

The account number for the bank account

accountNumber

Account Type

The account types currently supported for bank accounts are 'CHECKING' and 'SAVINGS'

accountType

Status

The associated status of the Payment Method in Plastiq Connect's system

status

πŸ“˜

Additional Account Types

Plastiq Connect has support for additional account types in the roadmap. The Implementation Guide will be updated as those new options are made available to integrating platforms.

Tokenization and Vaulting Options

Plastiq offers a one-step and a two-step process for creating a Payment Method, supporting different operating environments and integrating platform needs.

One-Step Process

The one-step process is intended for integrating platforms that can securely transmit sensitive data from their application infrastructure directly to the Payment Method endpoint using their API Key, and where the additional audit requirements of handling such secure transmission of sensitive data is not a concern.

Two-Step Process

The two-step process, using a Client-Secret (a single-use token), enables the integrating platform to transmit sensitive data, such as PII or PCI, directly to our Payment Method endpoint from an end-user's device or browser.

The first step in this process is to generate a Client-Secret using the secure API-Key, and supplying that to the end-user device. The end-user device, such as a browser, is then enabled to make an API request to the Payment Method endpoint.

Payment Method Type

API Key Supported

Client Secret Supported

Bank Account

:heavy-check-mark:

:heavy-check-mark:

Card

:heavy-check-mark:

:heavy-check-mark:

Payment Method Tokenization

Sensitive Payment Method details, such as card PAN (Primary Account Number) and bank account number, are tokenized in a distinct environment from other resources in the Plastiq Connect API. The Payment Method details are encrypted at rest using AES 256-bit encryption.

Errors

Please refer to our Payment Method Errors documentation for errors you may encounter adding Payment Methods.


What’s Next
Did this page help you?