Additional identity information is required for Payers based out of the state of Texas.
If a Payer adds a Payment Method with an address located in the state of Texas, the Payer will need to provide a Taxpayer Identification Number (TIN) before using the Payment Method to make a Payment.
With Plastiq's Connect APIs, you can decide how to best manage and surface this requirement in your customer experience.
If you place a strong emphasis on your product onboarding experience, you may want to optionally collect a Taxpayer Identification Number (TIN) upfront for all your Payers.
However, we highly recommend you make this field mandatory for Payers in Texas, as they will inevitably be prevented from submitting Payments until this information has been collected.
When you call Plastiq Connect's POST Payers endpoint, you can create the Payer object with an attached identity document.
This way you entirely avoid identity document errors associated with Texas Payers when creating Payment Methods and Payment Intents at later stages in the Payment funnel.
Alternatively, you may not want to collect sensitive personal information upfront and would rather request for this information given stronger customer intent to make a Payment.
So you let the Payer add a Payment Method
When your customer adds a Payment Method with an address located in Texas, the POST Payment Methods response will return a 200 and set the Payment Method
status to 'INACTIVE' if there are no valid identity documents on file for the Payer.
So you let the Payer draft a Payment
If a Payment Intent is created using a Payment Method with an 'INACTIVE'
status and the Payer doesn't have valid identity documents on file, POST Payment Intents returns a 200 and a 'NOT_CAPTURABLE'
Additionally, the list of
statusReasons codes will be surfaced: 'TEXAS_COMPLIANCE_BLOCK' and 'PAYMENT_METHOD_INACTIVE' will be nested in the
In this scenario, you want to add identity documents to the Payer after you've already created it.
We recommend the use of the PATCH Payers endpoint to add identity documents to an existing Payer.
By adding identity documents, the Payment Intent
status will be automatically updated to 'CAPTURABLE' and the Payment Intent Id can be used to create a Payment.
In order to fulfill the identity verification obligation for Texas Payers, you only need to provide an identity
type and identity
There is no need to collect and transmit a stored form of the physical identity document.
Plastiq currently accepts 5 different identity document types:
US_TIN- Taxpayer Identification Number (US)
US_EIN- Employer Identification Number (US)
US_SSN- Social Security Number (US)
ALIEN_REGISTRATION_NUMBER- U.S. Citizenship and Immigration Services (USCIS) Number (US)
PASSPORT_NUMBER- The number on your government-issued passport
Updated over 1 year ago