Reenvio do Credenciamento da Subconta

❗️

Atenção

Este endpoint deve ser utilizado exclusivamente em subcontas com status inactive e credenciamento retornado como rejeitado. Contas com status active já estão aprovadas para transacionar e não permitem reenvio do credenciamento.

O accreditationID segue sendo o mesmo. Não é gerado um novo accreditationId no reenvio.

Após realizar o Credenciamento na Subadquirência, a solicitação da conta é encaminhada ao time de análise interno da Celcoin, que retorna o resultado em até 48 horas.

Quando o credenciamento é aprovado, a conta passa para o status active e está apta a transacionar com cartão de crédito. Quando é negado, a conta permanece com status inactive e o motivo da negativa é devolvido no campo documentation do endpoint de consulta de status do credenciamento.

Um credenciamento pode ser negado por diversos motivos — CNAE incompatível, faturamento declarado inconsistente, descritivo do negócio insuficiente, entre outros. Após revisar o motivo e corrigir o dado apontado, é possível submeter uma nova solicitação por meio do endpoint "Reenvio de Credenciamento da Subconta", sem necessidade de criar uma nova conta BaaS.

Nesta página você vai encontrar:

  • Quando o reenvio do credenciamento pode ser utilizado
  • Como montar a requisição de reenvio
  • Quais campos podem ser corrigidos e reenviados
  • Como acompanhar o resultado da nova análise

Pré-requisitos

  • Autenticação realizada via OAuth 2.0 — para mais informações acessar esse link.
  • Conta BaaS já criada e com credenciamento na subadquirência previamente submetido.
  • Subconta com status inactive e credenciamento rejeitado.
  • Motivo da negativa já consultado no endpoint de consulta de status do credenciamento, por meio do campo documentation.

Entendendo o fluxo

O reenvio é uma etapa de correção dentro do fluxo de credenciamento da subadquirência. Ele não substitui o credenciamento inicial, apenas reapresenta os dados ajustados para uma nova análise.

EtapaAçãoResultado esperado
1Credenciamento da subconta (POST Credenciar Sub)Status PROCESSING
2Análise do time interno da Celcoin (até 48h)Status APPROVED ou REJECTED
3Consulta do status do credenciamentoRetorno do status da conta e do campo documentation com o motivo da negativa
4Correção do dado apontado e reenvio do credenciamento (PATCH Resend)Status PROCESSING
5Nova análise do time interno da CelcoinConta segue para active quando aprovada
📘

Dica

O reenvio pode ser realizado quantas vezes for necessário, desde que a conta permaneça com status inactive e credenciamento rejeitado. A cada reenvio, o credenciamento retorna para a fila de análise.

Endpoint

MétodoEndpoint
PATCH/baas/v1/cash/accreditation/{mainAccount}/{account}/resend

Substitua o host pelo ambiente correspondente (sandbox ou produção).

Modelo de requisição

cURL

curl --location --request PATCH 'https://sandbox.openfinance.celcoin.dev/baas/v1/cash/accreditation/{mainAccount}/{account}/resend' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json-patch+json' \
--header 'Accept: text/plain' \
--data '{
    "softDescriptor": "SubResend",
    "businessDescriptor": "Reenvio do credenciamento de uma Subconta Rejeitada",
    "cnae": "9602501",
    "monthlyIncome": 45435.12,
    "websites": [
        "www.reenviada.com"
    ]
}'

Body

{
    "softDescriptor": "SubResend",
    "businessDescriptor": "Reenvio do credenciamento de uma Subconta Rejeitada",
    "cnae": "9602501",
    "monthlyIncome": 45435.12,
    "websites": [
        "www.reenviada.com"
    ]
}

Parâmetros do Path

CampoDescriçãoTipoObrigatório
accountId da conta BaaS.StringSim.
mainAccountId da conta principal BaaS do tenantStringSim.

Parâmetros do Body

CampoDescriçãoTipoObrigatório
softDescriptorTexto que identifica a compra na fatura do cartão de crédito do cliente.stringNão, se outro campo for enviado.
cnaeAtividade econômica de uma empresa ou profissional (caso a empresa possua mais de um CNAE, apenas o principal deve ser informado).stringNão, se outro campo for enviado.
businessDescriptorDescrição do negócio.stringNão, se outro campo for enviado.
websitesLista de páginas web da sua empresa.array of stringsNão, se outro campo for enviado.
monthlyIncomeFaturamento mensal da empresa que está sendo cadastrada.floatNão, se outro campo for enviado.
⚠️

Importante

Diferente do credenciamento inicial, aqui não é necessário reenviar todos os campos. Envie apenas o campo (ou os campos) que precisam ser corrigidos, conforme o motivo apontado no documentation do endpoint de consulta. É obrigatório, no entanto, o envio de ao menos um dos campos de correção, uma requisição sem nenhum campo será rejeitada.

Modelo de retorno

200 OK

{
  "accreditationId": "6659d00192bdd93b23773662",
  "softDescriptor": "Minha empresa",
  "cnae": "62091",
  "account": "46243",
  "document": "12345678000195",
  "status": "PROCESSING"
}

Campos do retorno

CampoDescriçãoTipo
accreditationIdIdentificador único do credenciamento gerado pela Celcoin.string
softDescriptorTexto que identifica a compra na fatura do cartão de crédito do cliente.string
cnaeAtividade econômica principal informada.string
accountId da conta BaaS.string
documentDocumento (CPF/CNPJ) da subconta.string
statusStatus do credenciamento após o reenvio.string

Status do credenciamento

StatusDescrição
PROCESSINGCredenciamento recebido e em análise pelo time interno da Celcoin.
ERROROcorreu um erro na operação.
REJECTEDCredenciamento negado. Consulte o motivo no campo documentation do endpoint de consulta.
APPROVEDCredenciamento aprovado. A conta passa para o status active.

Pontos de atenção

  • Verifique o status antes de reenviar. Contas active não aceitam reenvio; contas em PROCESSING já estão em fila de análise e um novo envio não acelera o processo.
  • Corrija apenas o que foi apontado. Alterar campos que já foram validados pode gerar uma nova negativa.
  • Aguarde o retorno da análise. O prazo de até 48 horas se aplica também ao reenvio.
  • Acompanhe o resultado pelo webhook. O resultado final da nova análise é entregue de forma assíncrona, no mesmo formato do credenciamento inicial.

Próximos passos

Após o envio, o credenciamento retorna para a análise do time interno da Celcoin e o status volta para PROCESSING. A partir daí:

  1. Aguarde o retorno da análise em até 48 horas.
  2. Acompanhe o resultado pelo webhook de credenciamento ou pelo endpoint de consulta de status do credenciamento.
  3. Se aprovada, a subconta passa para o status active e está apta a transacionar com cartão de crédito — encerrando o fluxo de credenciamento.
  4. Se negada novamente, repita o ciclo: consulte o campo documentation, corrija o dado apontado e realize um novo reenvio.

Com isso, o fluxo de credenciamento da subadquirência se torna cíclico e autossuficiente: credenciar → consultar → corrigir → reenviar, até que a subconta atinja o status active.


Did this page help you?