Enviar documentos do vendedor

posthttps://sandbox-api.rebornpay.io/v1/sellers/{sellerId}/documentsAuth obrigatória

Envia um ou mais documentos de KYC em multipart/form-data. Repita os campos files e documentTypes para cada arquivo, na mesma ordem. Aceita a key do seller (próprio cadastro) ou a key da company (cadastro de um sub-seller ativo). Quando parte dos arquivos falha, os demais são gravados e a resposta é 207: reenvie só os itens com status ERROR.

Headers

X-Api-Keystringrequired

API Key do seller (header)

Path Parameters

sellerIdstringrequired

Body

multipart/form-data

filesarrayrequired

Arquivos (PDF, JPG ou PNG). Até 15 MB por arquivo e 50 MB por requisição.

Nenhum item adicionado.

documentTypesarrayrequired

Tipo de cada arquivo, na mesma ordem de files. Um único valor vale para todos os arquivos.

Nenhum item adicionado.

Responses

201Todos os documentos foram gravados

array

207Parte dos documentos falhou. Os itens com status SUCCESS foram gravados.

array

400Nenhum arquivo, arquivo vazio ou quantidade de documentTypes diferente da de files

errorsarrayrequired

Lista de erros da requisição

statusstringrequired

Código HTTP do erro

Example: 401

codestringrequired

Código interno do erro

Example: AUT-005

titlestringrequired

Título curto do erro

Example: API Key inválida

descriptionstringrequired

Descrição detalhada

Example: A API Key fornecida é inválida

actionstringoptional

Ação sugerida para o integrador

Example: Verifique sua API Key e tente novamente

additionalInfoobjectrequired

Informações adicionais sobre o erro

metadataobjectrequired

Metadados da resposta de erro

totalRecordsinteger · int32required

Total de erros na resposta

Example: 1

totalPagesinteger · int32required

Total de páginas

Example: 1

requestDatetimestring · date-timerequired

Data/hora da requisição (UTC)

Example: 2025-01-15T10:30:00Z

403A key não tem acesso a este seller

errorsarrayrequired

Lista de erros da requisição

statusstringrequired

Código HTTP do erro

Example: 401

codestringrequired

Código interno do erro

Example: AUT-005

titlestringrequired

Título curto do erro

Example: API Key inválida

descriptionstringrequired

Descrição detalhada

Example: A API Key fornecida é inválida

actionstringoptional

Ação sugerida para o integrador

Example: Verifique sua API Key e tente novamente

additionalInfoobjectrequired

Informações adicionais sobre o erro

metadataobjectrequired

Metadados da resposta de erro

totalRecordsinteger · int32required

Total de erros na resposta

Example: 1

totalPagesinteger · int32required

Total de páginas

Example: 1

requestDatetimestring · date-timerequired

Data/hora da requisição (UTC)

Example: 2025-01-15T10:30:00Z

curl -X POST 'https://sandbox-api.rebornpay.io/v1/sellers/{sellerId}/documents' \  -H 'X-Api-Key: $API_KEY' \  -H 'Content-Type: application/json'

201Response example

[
  {
    "documentType": "string",
    "status": "string",
    "data": {
      "documentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sellerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "documentType": "string",
      "fileName": "string",
      "mimeType": "string",
      "fileSizeBytes": 1,
      "uploadedAt": "2025-01-15T10:30:00Z"
    },
    "error": {
      "code": "string",
      "message": "string"
    }
  }
]