Tratar os dados da resposta

Segue abaixo um exemplo de análise para seguir passo a passo o tratamento dos dados da resposta.

  1. Saiba em qual modo (TESTE ou PRODUÇÃO) foi criada a transação analisando o valor do campo vads_ctx_mode.
  2. Identifique o pedido recuperando o valor do campo vads_order_id se você o enviou no formulário de pagamento.
    Verifique que o status do pedido não foi atualizado previamente.
  3. Recupere o resultado do pagamento enviado no campo vads_trans_status.
    O valor dele permite definir o status do pedido.
    Tabela 1. Valores associados ao campo vads_trans_status
    Valor Descrição
    ABANDONED Abandonado

    O comprador abandonou o pagamento

    A transação não foi criada e portanto não está exibida no Back Office Estabelecimento Comercial.

    ACCEPTED Aceito.

    Status de uma transação de tipo VERIFICATION cuja autorização foi aceita.

    Este status não pode evoluir.

    As transações cujo status é "ACCEPTED" nunca são capturadas no banco.

    AUTHORISED

    Aguardando captura

    A transação foi aceita e será capturada automaticamente no banco na data prevista.

    AUTHORISED_TO_VALIDATE

    Para validar

    A transação, criada em validação manual, está autorizada. O Estabelecimento Comercial deve validar manualmente a transação para lançar a solicitação de autorização e a captura no banco.

    A transação pode ser aprovada enquanto a data de vencimento da solicitação de autorização não estiver vencida. Se esta data estiver vencida, então o pagamento terá o status EXPIRED. O status Vencido é definitivo.

    CANCELLED

    Cancelado

    A transação foi cancelada pelo Estabelecimento Comercial.

    CAPTURED

    Capturado

    A transação foi capturada no banco.

    CAPTURE_FAILED

    A captura da transação falhou.

    Entrar em contato com o Suporte.

    EXPIRED

    Vencido

    A data de vencimento da solicitação de autorização foi atingida e o Estabelecimento Comercial não validou a transação. Portanto, o portador não será debitado.

    INITIAL Em espera

    Este status é específico para todos os meios de pagamento que requerem uma integração por formulário de pagamento em redirecionamento.

    Este status é retornado quando:
    • nenhuma resposta é retornada pelo adquirente

      ou

    • o prazo de resposta do adquirente ultrapassa o tempo da sessão do pagamento na plataforma de pagamento.

      Este status é temporário. O status definitivo será exibido no Back Office Estabelecimento Comercial assim que a sincronização finalizar.

    NOT_CREATED

    Transação não criada

    A transação não foi criada e não está exibida no Back Office Estabelecimento Comercial.

    REFUSED

    Recusado

    A transação foi recusada.

    SUSPENDED Suspensa

    A captura da transação está temporariamente bloqueada pelo adquirente (AMEX GLOBAL ou SECURE TRADING). Uma vez que a captura for processada corretamente, o status da transação será CAPTURED.

    UNDER_VERIFICATION

    Para as transações PayPal, este valor significa que PayPal segura a transação por causa de uma suspeita de fraude.

    O pagamento ficará na aba Transações em andamento até que as verificações acabarem. A transação terá então um dos status seguintes: AUTHORISED ou CANCELED.

    Uma notificação será enviada ao Estabelecimento Comercial para avisá-lo da mudança de status (Notificação em modificação por batch).

    WAITING_AUTHORISATION Aguardando autorização

    O prazo de captura no banco é maior que o tempo de validade da autorização.

    WAITING_AUTHORISATION_TO_VALIDATE

    Para validar e autorizar

    O prazo de captura no banco é maior que o tempo de validade da autorização.

    Uma autorização 1 BRL foi aceita.

    O Estabelecimento Comercial deve validar manualmente a transação para lançar a solicitação de autorização e a captura no banco.

  4. Recupere a referência do pagamento enviado no campo vads_trans_id.
  5. Analise o campo vads_payment_config para determinar se trata-se de um pagamento à vista (unitário) ou de um pagamento parcelado.
    Tabela 2. Análise do campo vads_payment_config
    Nome do campo Valor para um pagamento à vista Valor para um pagamento parcelado
    vads_payment_config SINGLE MULTI

    (cuja sintaxe exata é MULTI:first=X;count=Y;period=Z)

    Se tratar-se de um pagamento parcelado, informe o número da parcela recuperando o valor do campo vads_sequence_number.
    Tabela 3. Análise do campo vads_sequence_number
    Valor Descrição
    1 Primeira parcela
    2 Segunda parcela
    3 Terceira parcela
    n N parcela
  6. Analise o campo vads_sequence_number para saber quantas tentativas foram realizadas para executar o pagamento.
    vads_payment_config = SINGLE :
    vads_url_check_src vads_sequence_number Descrição
    PAY 1 Pagamento realizado em 1 tentativa
    2 Pagamento realizado em 2 tentativas
    3 Pagamento realizado em 3 tentativas
    BATCH_AUTO 1 Pagamento adiado realizado em 1 tentativa
    2 Pagamento adiado realizado em 2 tentativas
    3 Pagamento adiado realizado em 3 tentativas

    Observação

    O pagamento em mais de uma vez não é compatível com a funcionalidade de tentativas adicionais em caso de pagamento recusado.

  7. Recupere o valor do campo vads_trans_date para identificar a data do pagamento.
  8. Analise o campo vads_payment_option_code para determinar se trata-se de um pagamento parcelado:
    Tabela 4. Análise do campo vads_payment_option_code
    Valor Descrição
    1 Pagamento em 1 parcela
    2 Pagamento em 2 parcelas
    3 Pagamento em 3 parcelas
    n Pagamento em x parcelas
  9. Recupere o valor do campo vads_capture_delay para identificar o número de dias antes da captura no banco.
    Isto lhe permitirá saber se trata-se de um pagamento à vista ou pré-datado.
  10. Recupere o valor e a moeda usada. Para isso, recupere os valores dos seguintes campos:
    Tabela 5. Recupere o valor e a moeda usada.
    Nome do campo Descrição
    vads_amount Valor do pagamento na sua menor unidade monetária.
    vads_currency Código da moeda usada para o pagamento.
  11. Recupere o valor do campo vads_auth_result para conhecer o resultado da solicitação de autorização.
    A lista completa dos códigos de retorno está disponível no dicionário de dados.
  12. Recupere o resultado da autenticação 3D Secure. Para isso:
    1. Recupere o valor do campo vads_threeds_enrolled para determinar o status de afiliação do cartão.
      Tabela 6. Valores do campovads_threeds_enrolled
      Valor Descrição
      Vazio Processo 3DS não realizado (3DS desativado na solicitação, estabelecimento não afiliado ou meio de pagamento não elegível no 3DS).
      Y Autenticação disponível, portador afiliado.
      N Portador não afiliado.
      U Identificação do portado impossível ou cartão não elegível com as tentativas de autenticação (ex. Cartões comerciais ou pré-pagos).
    2. Recupere o resultado da autenticação 3D Secure recuperando o valor do campo vads_threeds_status.
      Tabela 7. Valores do campo vads_threeds_status
      Valor Descrição
      Vazio Autenticação 3DS não realizada (3DS desativado na solicitação, portador não afiliado ou meio de pagamento não elegível no 3DS)
      Y Portador identificado com sucesso.
      N Erro de autenticação do portador.
      U Autenticação impossível.
      A Tentativa de autenticação mas autenticação não efetuada.
  13. Recupere o resultado dos controles associados à fraude identificando o valor do campo vads_risk_control. Este campo é enviado somente se o estabelecimento:
    • contratou o serviço « Ajuda à decisão »
    • ativou pelo menos um controle no seu Back Office Estabelecimento Comercial (menu Configuração > Controle dos riscos).
    Ele toma como valor uma lista de valores separados por um « ; » cuja sintaxe é: vads_risk_control = control1=result1;control2=result2
    Os valores possíveis para control são:
    Tabela 8. Lista dos controles associados à fraude
    Valor Descrição
    CARD_FRAUD Controla a presença do número de cartão do comprador na lista cinza de cartões.
    SUSPECT_COUNTRY Controla a presença do país emissor do cartão do comprador na lista dos países proibidos.
    IP_FRAUD Controla a presença do endereço IP do comprador na lista cinza de IP.
    CREDIT_LIMIT Controla a freqüência e os valores de compra de um mesmo número de cartão, ou o valor máximo de um pedido.
    BIN_FRAUD Controla a presença do código BIN do cartão na lista cinza dos códigos BIN.
    ECB Controla se o cartão do comprador for do tipo e-carte bleue.
    COMMERCIAL_CARD Controla se o cartão do comprador for um cartão comercial.
    SYSTEMATIC_AUTO Controla se o cartão do comprador for um cartão com autorização sistemática.
    INCONSISTENT_COUNTRIES Controla se o país do endereço IP, o país emissor do cartão de pagamento, e o país do endereço do comprador estão coerentes entre eles.
    NON_WARRANTY_PAYMENT transferência de responsabilidade.
    SUSPECT_IP_COUNTRY Controle a presença do país do comprador, identificado pelo endereço IP dele, na lista dos países proibidos.
    Os valores possíveis para result são:
    Tabela 9. Lista dos controles associados à fraude
    Valor Descrição
    OK OK.
    WARNING Controle informativo não sucedido.
    ERROR Controle bloqueante não sucedido.
  14. Recupere o tipo de cartão usado para o pagamento.
    Tabela 10. Análise do cartão usado para o pagamento
    Nome do campo Descrição
    vads_card_brand Tipo de cartão usado para o pagamento. ex: VISA, VISA_ELECTRON, MASTERCARD, MAESTRO, VPAY
    vads_card_number Número de cartão usado para efetuar o pagamento.

    vads_expiry_month Mês de vencimento entre 1 e 12 (ex: 3 para março, 10 para outubro).
    vads_expiry_year Ano de vencimento com 4 dígitos (ex: 2023).
    vads_bank_code Código do banco emissor
    vads_bank_product Código produto do cartão
    vads_card_country Código País de emissão do cartão (Código alfa ISO 3166-2 ex :"BR" para o Brasil, "AR" para a Argentina, "PE" para o Peru, "US" para os Estados-Unidos.).
  15. Salve o valor do campo vads_trans_uuid. Poderá identificar de maneira única a transação se você usar as API Web Services.
  16. Recupere todas as informações sobre o detalhe do pedido, o detalhe do comprador e o detalhe da entrega.
    Estes dados estão presentes na resposta somente se eles foram enviadas no formulário de pagamento.
    O valor deles é idêntico ao valor mencionado no formulário.
  17. Faça a atualização do pedido.