Create a file 

To upload a file to Stripe, you need to send a request of type multipart/form-data. Include the file you want to upload in the request, and the parameters for creating a file.

All of Stripe’s officially supported Client libraries support sending multipart/form-data.

Parameters

• fileobjectRequired

  A file to upload. Make sure that the specifications follow RFC 2388, which defines file transfers for the multipart/form-data protocol.

• purposeenumRequired

  The purpose of the uploaded file.

  Possible enum values

  account_requirement Additional documentation requirements that can be requested for an account.

  additional_verification Additional verification for custom accounts.

  business_icon A business icon.

  business_logo A business logo.

  customer_signature Customer signature image.

  dispute_evidence Evidence to submit with a dispute response.

  identity_document A document to verify the identity of an account owner during account provisioning.

  issuing_regulatory_reporting Additional regulatory reporting requirements for Issuing.

  pci_document A self-assessment PCI questionnaire.

  tax_document_user_upload A user-uploaded tax document.

  Show 2 more

More parameters

Collapse all

• file_link_dataobject

  Optional parameters that automatically create a file link for the newly created file.

  Hide child parameters

  • file_link_data.createbooleanRequired

    Set this to true to create a file link for the newly created file. Creating a link is only possible when the file’s purpose is one of the following: business_icon, business_logo, customer_signature, dispute_evidence, issuing_regulatory_reporting, pci_document, tax_document_user_upload, terminal_android_apk, or terminal_reader_splashscreen.

  • file_link_data.expires_attimestamp

    The link isn’t available after this future timestamp.

  • file_link_data.metadataobject

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.