Identity Documents
Special Requirements for Texas Payers
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.
Identity Document Collection Upfront
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.
Using Post Payers To Collect Identity Documents
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.
Down The Road
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' status
.
Additionally, the list ofstatusReasons
codes will be surfaced: 'TEXAS_COMPLIANCE_BLOCK' and 'PAYMENT_METHOD_INACTIVE' will be nested in the status
object.
Using Patch Payers To Collect Identity Documents
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.
Acceptable Identity Documents
In order to fulfill the identity verification obligation for Texas Payers, you only need to provide an identity type
and identity value
.
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 2 years ago