Skip to main content

Update a document

patch/documents/{id}

Updates a document.

Endpoint destination URL
https://balanceplatform-api-test.adyen.com/bcl/v1/documents/{id}
Click to copy
idstringRequired

The unique identifier of the document to be updated.

attachmentobjectDeprecated in version 1

Use the attachments array instead.

Object that contains the document.

attachmentsarray[object]Required

Array that contains the document. The array supports multiple attachments for uploading different sides or pages of a document.

descriptionstringRequired

Your description for the document.

expiryDatestringDeprecated in version 1

The expiry date of the document, in YYYY-MM-DD format.

fileNamestring

The filename of the document.

issuerCountrystringDeprecated in version 1

The two-character ISO 3166-1 alpha-2 country code where the document was issued. For example, US.

issuerStatestringDeprecated in version 1

The state or province where the document was issued (AU only).

numberstring

The number in the document.

ownerobjectRequired

Contains information about the resource that owns the document.

typestringRequired

Type of document, used when providing an ID number or uploading a document. The possible values depend on the legal entity type.

When providing ID numbers:

  • For individual, the type values can be driversLicense, identityCard, nationalIdNumber, or passport.

When uploading documents:

  • For organization, the type values can be proofOfAddress, registrationDocument, taxDocument, proofOfOwnership, or proofOfIndustry.

  • For individual, the type values can be identityCard, driversLicense, proofOfNationalIdNumber, proofOfResidency, or proofOfIndustry.

  • Use bankStatement to upload documents for a transfer instrument.

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

  • 200 - OK

    The request has succeeded.

  • 400 - Bad Request

    A problem reading or understanding the request.

  • 401 - Unauthorized

    Authentication required.

  • 403 - Forbidden

    Insufficient permissions to process the request.

  • 422 - Unprocessable Entity

    A request validation error.

  • 500 - Internal Server Error

    The server could not process the request.