Criar uma Conta Cartão (Onboarding)

Para criar uma nova conta, utilize o endpoint de Criação de Conta.

Essas contas são denominadas Conta Cartão e são o primeiro passo necessário para que seja possível emitir um cartão para seus clientes. Antes de emitir um cartão, a conta do portador deve estar criada.

Tipos de Conta Cartão

Existem 3 tipos de conta que podem ser criados:

1. Pré-pago Cartões que debitam da conta BaaS no momento da autorização. A trilha do cartão pode ser Débito ou Crédito ao realizar compras, mas ambas debitam do saldo da conta BaaS.

2. Pós-pago Cartões de crédito puro que consomem do limite de crédito da conta cartão do cliente. A cada ciclo de faturamento, é emitida uma fatura para pagamento.

3. Multiapp Conta que possui cartão com função tanto pré-pago quanto pós-pago dentro do mesmo plástico. Ao inserir e aproximar o cartão na máquina de cartões, o cliente pode escolher qual função utilizar: pré-pago (debita da conta BaaS) ou pós-pago (debita do limite de crédito da conta cartão).

Para criar uma conta cartão para os produtos Pré-pago ou Multiapp, o cliente deve obrigatoriamente ter uma conta BaaS Celcoin criada e ativa, consulte mais informações aqui.

Para que a criação da conta cartão seja realizada, é necessário que o portador tenha passado previamente pelo fluxo de Onboarding da Celcoin.

Tipo de Pessoa (Física ou Jurídica)

Cada conta pode ter apenas 1 tipo de pessoa:

Pessoa Física (PF) - para pessoas físicas - CPF
Pessoa Jurídica (PJ) - para empresas - CNPJ

O tipo de pessoa é definido na configuração do programa. Embora o endpoint permita preenchimento dos campos tanto para PF quanto para PJ, é essencial respeitar o tipo configurado no programa.

warning

Important:

O tipo da conta cartão é associado diretamente ao tipo do programa configurado. Somente programas e contas com configurações compatíveis poderão ser criados.

Passos para Integrar:

1. Realizar autenticação na API

Autentique-se na API utilizando suas credenciais de acesso.

2. Chamar o endpoint de Criação de Conta

Utilize o endpoint de Criação de Conta e preencha as informações conforme o tipo de produto que deseja criar.

Baseado no tipo de cartão, siga as instruções abaixo:

Cartão Pré-pago

Para Pessoa Física:

Report the programId do programa Pré-pago configurado para Pessoa Física
Preencha os dados do objeto person
Necessário informar o id da conta BaaS.
Preencha os demais dados obrigatórios e opcionais do endpoint

Para Pessoa Jurídica:

Report the programId do programa Pré-pago configurado para Pessoa Jurídica
Preencha os dados do objeto company
Necessário informar o id da conta BaaS.
Preencha os demais dados obrigatórios e opcionais do endpoint

Cartão Pós-pago

Para Pessoa Física:

Report the programId do programa Pós-pago configurado para Pessoa Física
Preencha os dados do objeto person
Preencha os demais dados obrigatórios e opcionais do endpoint

Para Pessoa Jurídica:

Report the programId do programa Pós-pago configurado para Pessoa Jurídica
Preencha os dados do objeto company
Preencha os demais dados obrigatórios e opcionais do endpoint

Cartão Multiapp

Para uma conta multiapp, é necessário informar dois programas: um para a função pré-pago (debitProgramId) e outro para pós-pago (creditProgramId). Além disso, preencha o campo isMultiapp as true.

Para Pessoa Física:

Report the programId pré-pago configurado para Pessoa Física
Report the programId pós-pago configurado para Pessoa Física
Preencha os dados do objeto person
Necessário informar o id da conta BaaS.
Define isMultiapp = true
Preencha os demais dados obrigatórios e opcionais do endpoint

Para Pessoa Jurídica:

Report the programId pré-pago configurado para Pessoa Jurídica
Report the programId pós-pago configurado para Pessoa Jurídica
Preencha os dados do objeto company
Necessário informar o id da conta BaaS.
Define isMultiapp = true
Preencha os demais dados obrigatórios e opcionais do endpoint

3. Aguardar resposta via Webhook

O processo de criação de conta é assíncrono. Após o envio da requisição e recebido o retorno 204, a resposta será enviada por meio de um webhook account-created. Aguarde o recebimento desta notificação com as informações da conta cadastrada e realize as validações necessárias.

Em caso de demora na resposta ou ausência do webhook, utilize o endpoint Busca de conta informando o documento do portador.

Exemplo de Request

JSON

{ "application": { "creditProgramId": 1, "debitProgramId": 2, "isMultiapp": true, "submit": true, "applicant": { "personal": { "name": "John Doe", "printedName": "John Doe", "email": "john.doe@email.com", "gender": "M", "maritalStatus": "MARRIED" }, "account": { "grantedLimit": 1000, "limit": 1000, "accountType": "PHYSICAL|VIRTUAL", "accountName": "John Doe's Account" }, "documentNumber": "343354332", "birthDate": "1984-11-07", "phones": [ { "phoneType": "RESIDENTIAL|COMMERCIAL|MOBILE", "countryCode": "55", "phone": "22222222", "areaCode": 11 } ], "addresses": [ { "addressType": "RESIDENTIAL|COMMERCIAL|OTHER", "address": "Alameda Xingu", "number": 350, "neighborhood": " Alphaville Industrial", "city": "BARUERI", "state": "SP", "country": "BRAZIL", "zipCode": "06455-030", "mailingAddress": true, "complementaryAddress": "complemento" } ] } } }

Return example

tip

Success 200

JSON

{ "version": 1, "status": 204 }

Significado dos objetos do endpoint de criação de conta:

Object	Field	Type	Description	Mandatory
submit		boolean	Sempre preencher como true.
personal
	name	string (100)	Nome do portador do cartão. Permitido acento e espaços.	Yes
	e-mail	string (100)	E-mail do portador do cartão.	Yes
	gender	string (1)	Indicates the gender of the account holder. M for masculine and F for feminine	Yes
	printedName	string (25)
Nome impresso no cartão. Sempre em maiúsculo, sem acentos, números ou caracteres especiais.

Exemplo: Marco Antônio Fagundes - Nome impresso: MARCO FAGUNDES

warning

Important:

Atributos company e person

Será negada qualquer requisição que possua os atributos company and person preenchidos simultaneamente. Preencha apenas o que corresponde ao tipo de pessoa da conta.

Tipos de Conta Cartão​

Tipo de Pessoa (Física ou Jurídica)​

Passos para Integrar:​

1. Realizar autenticação na API​

2. Chamar o endpoint de Criação de Conta​

3. Aguardar resposta via Webhook​

Exemplo de Request​

Return example​

Significado dos objetos do endpoint de criação de conta:​

Tipos de Conta Cartão

Tipo de Pessoa (Física ou Jurídica)

Passos para Integrar:

1. Realizar autenticação na API

2. Chamar o endpoint de Criação de Conta

3. Aguardar resposta via Webhook

Exemplo de Request

Return example

Significado dos objetos do endpoint de criação de conta: