Document Uploads - Handling Failures/Retries

When a document goes through the various failure statuses, what is the recommended way to handle it?

Should the document be deleted before another upload is attempted? Will subsequent uploads trigger a DuplicateResource error if not?

H @jmtichell – when a document fails approval, we recommendation surfacing the failure reason to the User and prompting them to upload a different document which is valid.

There isn’t a way to remove a Document. A DuplicateResource error is returned when the same doc is uploaded again.

Hope that helps!

How does Dwolla determine if the document is a duplicate?

Ah, sorry for the confusion – when I saiid “the same doc” I meant to say the same file. For example, if a Document is uploaded and fails with a "ScanNotReadable" error, the user can upload a picture of the same document, but not upload the same file that was previously uploaded which failed verification.

Thank you for the help. If a user were to do the following, would step #3 succeed - or would it fail since the filename is the same?

  1. User uploads a .jpeg of a driver’s license named my_license.jpeg
  2. Dwolla can’t read the file and returns a “ScanNotReadable” error.
  3. User uploads a NEW scan of the drvier’s license also named my_license.jpeg.

In this case, #3 would succeed in uploading since the actual file would be different.

Thanks for the clarification!