Reenvio do Credenciamento da Subconta
AtençãoEste endpoint deve ser utilizado exclusivamente em subcontas com status
inactivee credenciamento retornado como rejeitado. Contas com statusactivejá estão aprovadas para transacionar e não permitem reenvio do credenciamento.O accreditationID segue sendo o mesmo. Não é gerado um novo
accreditationIdno 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
inactivee 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.
| Etapa | Ação | Resultado esperado |
|---|---|---|
| 1 | Credenciamento da subconta (POST Credenciar Sub) | Status PROCESSING |
| 2 | Análise do time interno da Celcoin (até 48h) | Status APPROVED ou REJECTED |
| 3 | Consulta do status do credenciamento | Retorno do status da conta e do campo documentation com o motivo da negativa |
| 4 | Correção do dado apontado e reenvio do credenciamento (PATCH Resend) | Status PROCESSING |
| 5 | Nova análise do time interno da Celcoin | Conta segue para active quando aprovada |
DicaO reenvio pode ser realizado quantas vezes for necessário, desde que a conta permaneça com status
inactivee credenciamento rejeitado. A cada reenvio, o credenciamento retorna para a fila de análise.
Endpoint
| Método | Endpoint |
|---|---|
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
| Campo | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| account | Id da conta BaaS. | String | Sim. |
| mainAccount | Id da conta principal BaaS do tenant | String | Sim. |
Parâmetros do Body
| Campo | Descrição | Tipo | Obrigatório |
|---|---|---|---|
softDescriptor | Texto que identifica a compra na fatura do cartão de crédito do cliente. | string | Não, se outro campo for enviado. |
cnae | Atividade econômica de uma empresa ou profissional (caso a empresa possua mais de um CNAE, apenas o principal deve ser informado). | string | Não, se outro campo for enviado. |
businessDescriptor | Descrição do negócio. | string | Não, se outro campo for enviado. |
websites | Lista de páginas web da sua empresa. | array of strings | Não, se outro campo for enviado. |
monthlyIncome | Faturamento mensal da empresa que está sendo cadastrada. | float | Não, se outro campo for enviado. |
ImportanteDiferente 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
documentationdo 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
| Campo | Descrição | Tipo |
|---|---|---|
accreditationId | Identificador único do credenciamento gerado pela Celcoin. | string |
softDescriptor | Texto que identifica a compra na fatura do cartão de crédito do cliente. | string |
cnae | Atividade econômica principal informada. | string |
account | Id da conta BaaS. | string |
document | Documento (CPF/CNPJ) da subconta. | string |
status | Status do credenciamento após o reenvio. | string |
Status do credenciamento
| Status | Descrição |
|---|---|
PROCESSING | Credenciamento recebido e em análise pelo time interno da Celcoin. |
ERROR | Ocorreu um erro na operação. |
REJECTED | Credenciamento negado. Consulte o motivo no campo documentation do endpoint de consulta. |
APPROVED | Credenciamento aprovado. A conta passa para o status active. |
Pontos de atenção
- Verifique o status antes de reenviar. Contas
activenão aceitam reenvio; contas emPROCESSINGjá 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í:
- Aguarde o retorno da análise em até 48 horas.
- Acompanhe o resultado pelo webhook de credenciamento ou pelo endpoint de consulta de status do credenciamento.
- Se aprovada, a subconta passa para o status
activee está apta a transacionar com cartão de crédito — encerrando o fluxo de credenciamento. - 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.
Updated 41 minutes ago