Template de Webhooks

O produto cel_card faz o gerenciamento das seguintes entidades e webhooks:

EntidadeMensagem
account-createdCadastro da Conta para emissão de cartões
card-createdCartão emitido para uma conta
transaction-approvedStatus de uma transação com sucesso
transaction-refusalStatus de uma transação recusada

Templates

Quando as informações de um cliente são inseridas no nosso ambiente no processo de onboarding, realizamos todos os processos internos para a emissão de cartões.

Quando uma conta é criada com sucesso disparamos o seguinte webhook na entidade account-created:

{
    	"accountId":78, 
    	"baasAccountNumber":"300001223332",
      "programId":16,
    	"accountType":"PHYSICAL",
    	"currencyCode":"986",
      "accountStatusId":9,
      "createdAt":"2024-08-07 00:00:00"
}

Significado dos objetos enviados no webhook

ObjetoTipoSignificado do Objeto
accountIdintId único gerado para a conta
baasAccountNumberstringNúmero da conta no Baas
programIdintId do programa utilizado para criação desta conta
accountTypestring(10)Tipo da conta: PHYSICAL ou VIRTUAL. Por padrão toda as contas são criadas como PHYSICAL.
currencyCodestring(3)Indica qual moeda vai ser utilizada para transações nesta conta
accountStatusIdintindica em que status a conta se encontra
createdAtdatetimeData e hora da criação da conta

Quando um cartão é emitido corretamente disparamos o seguinte webhook na entidade card-created:

{
    	"clientRequestId":20,
    	"clientDocument":"33999999999",
    	"cardId":65,
			"cardHash":"CdOhJpw0OFWEpgj1+IZ5FkPCAnvKlPu9nIKmuaJ1ug8bkjb1cAD0s9xe7Ib1w/wgB9cE5ygmOzmiFWEgja47lw==",
    	"operationType":"issue_card"
}

Significado dos objetos enviados no webhook

ObjetoTipoSignificado do Objeto
clientDocumentstringDocumento do cliente (CPF ou CNPJ)
cardIdintId gerado automaticamente para identificação do cartão
cardHashstring (100)Hash de criptografia do cartão
operationTypestring (20)issue_card indica emissão do cartão, reissue_card indica que é a remissão do cartão

Quando uma transação ocorrer com o cartão, disparamos o seguinte webhook para transações com sucesso:

{
      "accountId":1397799993,
      "authorizationCategory": "AUTHORIZATION",
      "customerId": 12,
      "authorizationDateHour": "2024-08-07T12:53:08",
      "eventDateHour": ”2024-08-07T12:53:08”,
      "reason": Verificar Lista,
   }

Significado dos objetos enviados no webhook

ObjetoTipoSignificado do Objeto
account_idintIndica o id da conta que transacionou
authorization_categorystringAUTHORIZATION indica sucesso e DECLINED indica uma transação recusada
customer_idintId do cliente
authorization_date_hourdatetimeData em que ocorreu a transação
event_date_hourdatetimeData e hora que ocorreu a transação
reasonintMotivos que uma transação pode ser recusada