Roteiro de homologação PIX

Objetivo

O roteiro de homologação tem como objetivo avaliar se o sistema integrado a Celcoin está apto a utilizar as APIs de Pix.

❗️

Atenção!

É de responsabilidade do parceiro seguir rigorosamente toda a regulamentação referente ao PIX, disponibilizada pelo Banco Central do Brasil, atendendo aos requisitos mínimos de segurança e de experiência do usuário, e garantindo a utilização correta da marca PIX. Em caso de não cumprimento das exigências do Banco Central, estará sujeito a multas e penalidades contratuais.

PIX Cash-in

Essa funcionalidade permite que os clientes da Celcoin consigam gerar QR Codes dinâmicos ou estáticos, para qualquer instituição financeira, com o objetivo de cobrar seus clientes e receber de forma instantânea.

PIX Cash-out

Essa funcionalidade permite que os clientes da Celcoin consigam efetuar pagamentos ou transferências, para qualquer instituição financeira, utilizando o PIX.

Como funciona a homologação

Para ser homologado com a Celcoin é necessário realizar os testes diretamente na sua aplicação, onde seu usuário irá interagir. Ou seja, não serão aceitos testes realizados pelo postman, swagger, ou de qualquer outra plataforma que permita simulação de requisições e retornos.

Se for integrar apenas cash-in, é obrigatório implementar uma cobrança com qr code dinâmico e uma cobrança comQrcode estático.
Se for integrar apenas cash-out transferência, é obrigatório implementar um dos fluxos (por dados bancários ou por chave).
Se for integrar apenas cash-out pagamento, é obrigatório implementar um dos fluxos (por qr code estático ou Qrcode dinâmico).

Se for integrar cash-in e cash-out, é obrigatório implementar todos os fluxos mencionados anteriormente. Os fluxos de cada módulo estão descritos no tópico Roteiro homologação Cash-in e Cash-out.

Caso um dos fluxos de integração não seja homologado, o mesmo não pode ser usado em produção. A Celcoin exige a homologação das funcionalidades para liberar em produção.

Como enviar os testes

Para que o time de suporte possa analisar os testes, há duas formas de enviar esses dados: imagens + logs ou vídeo + logs.

Imagens + logs

Nesse caso é necessário informar o cenário (roteiro) de homologação que está sendo testado e a imagem da tela da sua aplicação executando esse cenário. Segue exemplo:

Além dessa imagem é necessário enviar também os logs gerados pela sua aplicação ao executar esse cenário. Na parte de logs precisa conter a pergunta do roteiro (que é o mesmo cenário da imagem) e em seguida o log. Segue exemplo:

No caso de cash-out, além do log de cada etapa, é necessário enviar o log dos webhooks de sucesso e rejeição. Segue exemplo de log de webhooks:

Esse mesmo processo deve ser feito com todos os passos do roteiro das funcionalidades que deseja implementar. Os dados devem ser colocados em um documento e enviados para o suporte no formato .pdf ou .doc.

Vídeo + logs

Nesse caso você pode gravar a tela da sua aplicação mostrando a execução de cada cenário do roteiro. Os logs também são necessários e devem ser enviados com o mesmo padrão do exemplo acima. O documento de homologação deve conter o link de acesso aos vídeos e os logs das requisições.

❗️

Atenção!

Qualidade mínima do vídeo 720p e é necessário permitir acesso ao drive para o domínio Celcoin

Roteiro homologação Cash-in:

É obrigatório a implementação de pelo menos uma cobrança com Qr code dinâmico e outra com Qr code estático:

  • Criar Qr code COB (pix/v1/location)
  • Criar cobrança imediata (pix/v1/collection/immediate)

  • Criar Qr code COBV (pix/v1/location)
  • Criar cobrança com vencimento (pix/v1/collection/duedate)
  • Criar Qr code e criar cobrança com vencimento aplicando desconto (configurar propriedade amountDicount no endpoint pix/v1/collection/duedate)
  • Criar Qr code e criar cobrança com vencimento aplicando abatimento (configurar propriedade amountAbatement no endpoint pix/v1/collection/duedate)
  • Criar Qr code e criar cobrança com vencimento aplicando multa (configurar propriedade amountFine no endpoint pix/v1/collection/duedate)
  • Criar Qr code e criar cobrança com vencimento aplicando juros (configurar propriedade amountInterest no endpoint pix/v1/collection/duedate)

  • Criar Qr code estático (pix/v1/brcode/static)

O webhook de cash-in não está disponível para testar em ambiente de homologação, desta forma, só é possível testar em produção. Portanto, não é obrigatório enviar as evidências do recebimento dos disparos em seu webhook.

Roteiro homologação Cash-out:

É obrigatório a implementação de pelo menos uma transferência e um pagamento:

  • Criar a transferência (pix/v1/payment)
  • Configurar webhook PAYMENT (fale com o suporte)
  • Receber webhook de pagamento de pagamento bem sucedido (status Confirmed)
  • Receber webhook de pagamento rejeitado (status Error)
    Para isso é necessário configurar o creditParty da seguinte forma:
    "creditParty": {
    "bank": "30306294",
    "account": "10545584",
    "branch": 0,
    "taxId": "11122233344",
    "accountType": "CACC",
    "name": "Celcoin"
    }

  • Consultar chave PIX no DICT (pix/v1/dict/v2/key)
  • Criar a transferência (pix/v1/payment)
  • Configurar webhook PAYMENT (fale com o suporte)
  • Receber webhook de pagamento de pagamento bem sucedido (status Confirmed)
  • Receber webhook de pagamento rejeitado (status Error)
    Para isso é necessário configurar o creditParty da seguinte forma:
    "creditParty": {
    "bank": "30306294",
    "account": "10545584",
    "branch": 0,
    "taxId": "11122233344",
    "accountType": "CACC",
    "name": "Celcoin"
    }

  • Criar um Qr code estático (caso não tenha um emv pix/v1/brcode/static)
  • Decodificar o Qr code (pix/v1/emv)
  • Consultar chave PIX no DICT (pix/v1/dict/v2/key)
  • Pagar Qr code (pix/v1/payment)
  • Configurar webhook PAYMENT (fale com o suporte)
  • Receber webhook de pagamento de pagamento bem sucedido (status Confirmed)
  • Receber webhook de pagamento rejeitado (status Error)
    Para isso é necessário configurar o creditParty da seguinte forma:
    "creditParty": {
    "bank": "30306294",
    "account": "10545584",
    "branch": 0,
    "taxId": "11122233344",
    "accountType": "CACC",
    "name": "Celcoin"
    }

Qrcode imediato

  • Criar um Qrcode (caso não tenha um emv; definir type como COB pix/v1/location)
  • Criar uma cobrança imediata (caso não tenha um emv pix/v1/collection/immediate)
  • Decodificar o Qr code (pix/v1/emv)
  • Pegar a chave PIX (pix/v1/collection/immediate/payload/{url})
  • Consultar chave PIX no DICT (pix/v1/dict/v2/key)
  • Pagar Qr code (pix/v1/payment)
  • Configurar webhook PAYMENT (fale com o suporte)
  • Receber webhook de pagamento de pagamento bem sucedido (status Confirmed)
  • Receber webhook de pagamento rejeitado (status Error)
    Para isso é necessário configurar o creditParty da seguinte forma:
    "creditParty": {
    "bank": "30306294",
    "account": "10545584",
    "branch": 0,
    "taxId": "11122233344",
    "accountType": "CACC",
    "name": "Celcoin"
    }

Qr code com vencimento

  • Criar um Qr code (caso não tenha um emv; definir type como COBV pix/v1/location)
  • Criar uma cobrança com vencimento (caso não tenha um emv pix/v1/collection/duedate)
  • Decodificar o Qr code (pix/v1/emv)
  • Pegar a chave PIX (pix/v1/collection/duedate/payload/{url})
  • Consultar chave PIX no DICT (pix/v1/dict/v2/key)
  • Pagar Qr code (pix/v1/payment)
  • Configurar webhook PAYMENT (fale com o suporte)
  • Receber webhook de pagamento de pagamento bem sucedido (status Confirmed)
  • Receber webhook de pagamento rejeitado (status Error)
    Para isso é necessário configurar o creditParty da seguinte forma:
    "creditParty": {
    "bank": "30306294",
    "account": "10545584",
    "branch": 0,
    "taxId": "11122233344",
    "accountType": "CACC",
    "name": "Celcoin"
    }

Para validar o webhook de cash-out é necessário entrar em contato com a equipe de suporte, enviando o usuário, senha e a URL do seu webhook, onde será realizado sua configuração.

  • Validar status de um dos fluxos de cash-out com status de sucesso [confirmed] (pix/v1/payment/pi/status)
    Nesse caso pode ser consultado qualquer um dos fluxos: transferência por dados bancários ou por chave, ou pagamento de um qrcode dinâmico ou estático
  • Validar status de um dos fluxos cash-out com status rejeitado [error] (pix/v1/payment/pi/status)
    Nesse caso pode ser consultado qualquer um dos fluxos: transferência por dados bancários ou por chave, ou pagamento de um qrcode dinâmico ou estático

Após realizar todos os testes e disponibilizar o roteiro para o suporte analisar, as chaves de produção serão liberadas com a aprovação da homologação.


Did this page help you?