Authorize

Quando é utilizado?

Quando o usuário deseja que o pedido seja processado em Two-steps, onde a transação deverá ser primeiro Autorizada e, após o Antifraude aprovar, a transação seja Capturada junto a aplicação do terceiro.
Essa requisição será enviada pela plataforma usando a estrutura abaixo.

📘

Processamento Two-Steps

No processamento "two-steps", a Autorização é feita separada da Captura do pagamento no cartão.

Portanto, a requisição deve ser respondida com o status 4 e, posteriormente quando o pedido for "Aprovado", será feita uma nova requisição solicitando a Captura.

Estrutura da chamada

{urlbase}/authorize
utiliza método POST enviando os dados do carrinho + headers + pagamento para realizar a cobrança do pedido.

Modelo de Requisição da Authorize

Estrutura do objeto enviado e seus dados:

JSON

{
   "id":0,
   "loja":"pagamentos",
   "chave":"fe31c0e6-b625-4772-8890-dd7a89053d05",
   "pedido":108648,
   "carrinhoId":"d1e3bf62-795b-4b77-82ac-c81867ad9c1a",
   "frete":0.00,
   "desconto":0,
   "total":300.00,
   "primeiroPedidoAssinatura":false,
   "assinatura":null,
   "usuario":{
      "nome":"Daniel Teste",
      "cpf":"79299082081",
      "cnpj":"",
      "email":"[email protected]",
      "endereco":{
         "logradouro":"Rua Encantado 860",
         "numero":"123",
         "complemento":"",
         "bairro":"Centro",
         "cep":85920970,
         "cidade":"Dez de Maio",
         "estado":"PR"
      },
      "telefone":"1194444-4444"
   },
   "produtos":[
      {
         "codigo":336661,
         "nome":"Camiseta Branca Unissex",
         "sku":"",
         "cd":1032,
         "valor":300.00,
         "quantidade":1,
         "personalizacao":[
            
         ]
      }
   ],
   "pagamento":{
      "parcelas":1,
      "valor":300.00,
      "valorCC":0.00,
      "ajuste":0.00,
      "total":300.00,
      "ip":"",
      "endereco":{
         "logradouro":"Rua Encantado 860",
         "numero":"123",
         "complemento":"",
         "bairro":"Centro",
         "cep":85920970,
         "cidade":"Dez de Maio",
         "estado":"PR"
      },
      "form":{
         "paymentMethod":"1",
         "number":"5555550000005554",
         "name":"TESTE TESTE TESTE",
         "month":"03",
         "year":"2030",
         "expiry":"03/2030",
         "cvc":"000",
         "saveCard":"false"
      }
   }
}

Campos da requisição de Authorize

Campo	Tipo	Descrição
id	inteiro	Código identificador do conector na base de dados da plataforma.
loja	string	Nome da loja cadastrado no admin da Wake Commerce.
chave	guid	Chave de identificação da transação. Essa chave é dinâmica, alterada a cada pedido.
pedido	inteiro	Código identificador do Pedido.
frete	decimal	Valor de frete do pedido. O campo pode ser zerado.
desconto	decimal	Valor de desconto do pedido. O campo pode ser zerado.
total	decimal	Valor total cobrado no pedido considerando todos os ajustes.
primeiroPedidoAssinatura	boolean	Campo destinado para primeiro pedido de uma assinatura. Deve ser "true" ou "false".
assinatura / id	inteiro	Código identificador da Assinatura cadastrada no admin da Wake Commerce.
assinatura / tipo	string	Texto que identifica o tipo de assinatura. Podem ser retornados os valores Admin, Null ou Recorrência, conforme o tipo do pedido: - Admin: para pedidos gerados a partir do admin na tela de assinaturas; - Null: para o primeiro pedido em que a assinatura será originada, o objeto assinatura será Null. Isso ocorre, pois a assinatura só é criada depois do request para API Custom; - Recorrência: pedido de assinatura.
usuario / nome	string	Nome do usuário.
usuario / cpf	string	CPF do usuário. Obrigatório para usuários Pessoa Física. Pode vir vazio caso o usuário seja Pessoa Jurídica.
usuario / cnpj	string	CNPJ do usuário. Obrigatório para usuários Pessoa Jurídica. Pode vir vazio caso o usuário seja Pessoa Física.
usuario /email	string	E-mail do usuário.
usuario / endereco / logradouro	string	Logradouro / Rua / Avenida / Estrada do endereço do usuário.
usuario / endereco / numero	string	Número do endereço do usuário.
usuario / endereco / complemento	string	Complemento do endereço do usuário. Pode vir vazio.
usuario / endereco / bairro	string	Barrio do endereço do usuário.
usuario / endereco / cep	Int	CEP do endereço do usuário.
usuario / endereco / cidade	string	Cidade do endereço do usuário.
usuario / endereco / estado	string	Estado do endereço do usuário.
usuario / telefone	string	Telefone do usuário.
produtos / codigo	inteiro	Código identificador do produto cadastrado na plataforma.
produtos / nome	string	Nome do produto cadastrado na plataforma.
produtos / cd	inteiro	Centro de Distribuição de origem do produto.
produtos / sku	string	SKU do produto cadastrado na plataforma.
produtos / valor	decimal	Valor do produto cadastrado na plataforma.
produtos / quantidade	inteiro	Quantidade do produtos no pedido.
produtos / personalizacao / nome	string	Nome da personalização do produto, quando o produto permitir algum tipo de personalização. Pode vir vazio.
produtos / personalizacao / valor	string	Valor da personalização do produto, quando o produto permitir algum tipo de personalização. Pode vir vazio.
produtos / personalizacao / custo	decimal	Custo da personalização do produto, quando o produto permitir algum tipo de personalização. Pode vir vazio.
pagamento / parcelas	inteiro	Quantidade de parcelas do pedido em cima do valor total do pedido.
pagamento / valor	decimal	Valor total cobrado no pedido sem os descontos/ajustes aplicados.
pagamento / ajuste	decimal	Ajustes do pedido considerando descontos. Pode vir vazio.
pagamento / total	decimal	Valor total cobrado no pedido considerando todos os ajustes.
pagamento / ip	string	IP do dispositivo que o usuário utilizou para finalizar o pedido.
pagamento / endereco / logradouro	string	Logradouro / Rua / Avenida / Estrada do endereço de pagamento do pedido.
pagamento / endereco / numero	string	Número do endereço de pagamento do pedido.
pagamento / endereco / complemento	string	Complemento do endereço de pagamento do pedido. Pode vir vazio.
pagamento / endereco / bairro	string	Bairro do endereço de pagamento do pedido.
pagamento / endereco / cep	Int	CEP do endereço de pagamento do pedido.
pagamento / endereco / cidade	string	Cidade do endereço de pagamento do pedido.
pagamento / endereco / estado	string	Estado do endereço de pagamento do pedido.
pagamento / form / cpf	string	CPF utilizado no pagamento do pedido.
pagamento / form / saveCard	boolean	Campo responsável por informar se o cartão utilizado no pagamento do pedido deve ser salvo para compras futuras. Deve ser "true" ou "false". Obs: Este campo só é utilizado quando utilizada a versão Completa.

Modelo do response

JSON

{
  "statusId":1,
  "message":"Minha mensagem"
}
{
  "statusId":2,
  "message":"Minha mensagem"
}
{
  "statusId":3,
  "message":"Minha mensagem"
}
{
  "statusId":4,
  "message":"Minha mensagem"
}

Campos do response

Campo	Tipo	Descrição
statusId	inteiro	Informa o status da transação em tempo real. (Tabela de status informada abaixo)
message	string	Retorna a mensagem do status da transação.

Tabela de Status

StatusId	Nome status	Ação
1	Aguardando Pagamento	Mantém o pedido como aguardando pagamento na plataforma.
2	Não autorizado	Nega a transação. O Pop-up do checkout online é exibido na tela do usuário e a compra é bloqueada.
3	Pago	Atualiza o status do pedido para Pago na plataforma.
4	Autorizado	Atualiza o status do pedido para Autorizado na plataforma. Usado em processamento Two-steps (Autorização separada da Captura).

📘

Formulário de pagamento

O formulário de pagamento deve ser enviado nos payloads payment e authorize, acesse a documentação do Formulário de Pagamento clicando aqui

📘

Devolução de dados para envio ao antifraude

Precisamos que, após a autorização do pedido no fluxo de "two steps", sejam devolvidos os seguintes dados na requisição: CartaoNome, CartaoBandeira, CartaoValidade, CartaoBin e CartaoQuatroUltimosDigitos. Esses dados são fundamentais para que possamos realizar o envio adequado das informações para a validação do antifraude, garantindo uma análise precisa e segura das transações, além de contribuir para a mitigação de riscos de fraude.

Exemplo de requisição

json

{  
    "informacoesAdicionais":[  
        {  
            "nome": "TID",  
            "valor": "0556481403201"  
        },  
        {  
            "nome": "NSU",  
            "valor": "167450"  
        }  
        {  
            "nome": "Auth",  
            "valor": "250700"  
        }  
          {  
            "nome": "CartaoBin",  
            "valor": "123456"  
        }  
         {  
            "nome": "CartaoBandeira",  
            "valor": "Mastercard"  
        }  
        {  
            "nome": "CartaoNome",  
            "valor": "João Teste"  
        }  
         {  
            "nome": "CartaoQuatroUltimosDigitos",  
            "valor": "1234"  
        }  
         {  
            "nome": "CartaoValidade",  
            "valor": "12/2024"  
        }
]
}

🚧

Identificação do pagamento

Sugerimos concatenar o número do pedido (prop. "pedido") e o Id (prop. "id") para que sejam utilizadas como identificador do pagamento realizado.