Home

Visão Geral

  • API REST

  • Web Checkout

    • Link de Pagamento

      • Notificações

        • Retentativas Automáticas

          • Códigos de Retorno

            • Portal Lojista

              • 3D Secure 2.0

                • Conexões Adquirentes

                  • Meios de pagamentos

                    • Integrações Antifraude

                      • Gestão de Lojas

                        • Informações Gerais

                          Serviço de geração de token de autenticidade

                          O consumo do serviço de geração de token é obrigatório em alguns fluxos de operações genéricas. Como resultado dessa operação, o lojista obterá um token pela URL de autenticidade que serão necessários para os próximos passos do fluxo.

                          Detalhes da chamada#

                          • Recurso: /v1/token
                          • Método HTTP: GET
                          • Formato da requisição: JSON
                          • Formato da resposta: JSON
                          • Parâmetros de cabeçalho:
                          ParâmetroDescriçãoTipoTamanhoObrigatório
                          merchant_idCódigo da loja no Carat. Os códigos de produção e certificação serão diferentes.AN< 15Sim
                          merchant_keyChave de autenticação da loja no Carat. As chaves de produção e certificação serão diferentes.AN< 80Sim

                          Em seguida, o Carat irá enviar uma requisição POST HTTPS (x-www-form-urlencoded) para a URL cadastrada, este POST contém as informações necessárias para obter o token para ser utilizado nas operações genéricas.

                          Simulação de POST de autenticidade:

                          Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor
                          esitef-homologacao.softwareexpress.com.br

                          curl -X POST \
                          https://urlDeAutenticidadeDaLoja.com.br \
                          -H 'Content-Type: application/x-www-form-urlencoded' \
                          -H 'cache-control: no-cache' \
                          -d 'token=1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr

                          Códigos de resposta

                          Veja a referencia no Códigos da API - códigos de resposta

                          Atenção: É essencial que o site hospedado na URL de Autenticidade da loja receba o token de autenticidade e responda HTTP 200, pois isto é condição para que o Carat considere o sucesso deste POST.

                          Caso o POST de autenticidade tenha ocorrido com sucesso, o Carat responderá um código "responseCode": "0" para a requisição da loja.