post https://api.cert.zerohash.com/participants/documents
Submits a document on behalf of you or a customer if you operate a platform on Zero Hash.
Authentication
In order to Authenticate to the document submission endpoint you will need to do the following:
- Set your X-SCX-FILE-HASH header to the sha256 hash (in a byte array) of your file contents (base64 encoded).
- Make sure to use
{}
as your body when signing your request. If you use your actual request body to sign you will receive and Invalid Client Signature. - Ensure that your file is not larger than 10mb.
- Remember to base64 encode your file before sending it to us.
Document Requirements
The supported MIME types for document submission are application/pdf
, image/png
,image/jpg
and image/jpeg
. A valid ID type must be submitted with documents options are:
us_drivers_license
us_passport
us_passport_card
us_permanent_resident_card
us_border_crossing_card
us_alien_card
us_id_card
non_us_passport
non_us_other
Citizenship and Tax ID required validations
citizenship
is always a required field, and there are additional validations done on this field.
Citizenship | Validations |
---|---|
"United States" | tax_id (also known as SSN in the United States) required
|
Anything other than "United States" | id_number and id_number_type are required; tax_id is not required |