Cancelar transação SOAP

De wikiSuperPay
Ir para: navegação, pesquisa

Outra funcionalidade disponível no SuperPay é o cancelamento de transações (de acordo com a disponibilidade do serviço nas operadoras).

Para tanto, basta realizar uma chamada ao web-método operacaoTransacao (o mesmo utilizado para a captura manual), enviando como parâmetro o código 2.

Usuário WebService

Em todas as requisições, para a autenticação deve ser enviado no header da requisição os campos abaixo:

Obs:Solicitar ao SuperPay Suporte (servicedesk@superpay.com.br) o usuário e senha para utilização em ambos ambientes.

Campo Descrição
login Login do estabelecimento
senha Senha do estabelecimento

Informações da Estrutura

Nome do Método
operacaoTransacao
Dados de Entrada OperacaoVO, Usuario, Senha
Dados de Saída
ResultadoPagamentoWS

Além de um nome de usuário e senha que identificam o login do estabelecimento dentro do gateway, também é enviado um objeto do tipo OperacaoVO como dado de entrada.
Campo Descrição Tipo Tamanho
numeroTransacao Código que identifica a transação dentro do SuperPay Numérico Até 8 dígitos
codigoEstabelecimento Código que identifica o estabelecimento dentro do SuperPay (fornecido pelo gateway) Numérico 13 dígitos
operacao Código que identifica o processo que deseja realizar. Para captura, deve-se enviar o valor 2 Fixo para captura. Valor = 2

Retorno Requisição de Cancelamento

Após o envio da requisição, o SuperPay retornará um objeto de resposta, chamado ResultadoPagamentosWS, como dado de saída. 

Campo

Descrição

Tipo

Tamanho

numeroTransacao Código que identifica a transação dentro do SuperPay Numérico Até 8 dígitos
codigoEstabelecimento Código que identifica o estabelecimento dentro do SuperPay (fornecido pelo gateway) Numérico 13 dígitos
codigoFormaPagamento Código da forma de pagamento. Numérico  - 
valor Valor da transação Numérico Até 10 dígitos
valorDesconto Valor do desconto da transação Numérico Até 10 dígitos
taxaEmbarque Valor da taxa de embarque Numérico Até 10 dígitos
parcelas Quantidade de parcelas da transação. Numérico Até 2 dígitos
urlPagamento Para o modelo redirect. Essa será a URL de redirecionamento da operação. Alfa Numérico Até 500 caracteres
statusTransacao Código que mostra o status atual da transação. Verificar tabela Status Numérico Até 2 dígitos
autorizacao Código de autorização da operadora/banco/intermediário financeiro Numérico Até 20 dígitos
codigoTransacaoOperadora Código da transação na operadora/banco/intermediário financeiro Numérico Até 20 dígitos
dataAprovacaoOperadora Data de aprovação na operadora Alfa Numérico Até 10 caracteres
numeroComprovanteVenda Número do comprovante de venda Alfa Numérico Até 20 caracteres
mensagemVenda Mensagem de retorno da operadora Alfa Numérico Até 50 caracteres


Exemplo de XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pag="http://pagamentos.webservices.superpay.ernet.com.br/">
   <soapenv:Header/>
   <soapenv:Body>
      <pag:operacaoTransacao>
            <operacao>
               <codigoEstabelecimento>1010101010101010</codigoEstabelecimento>
               <numeroTransacao>123456</numeroTransacao>
               <operacao>2</operacao>
            </operacao>
         <usuario>superpay</usuario>
         <senha>superpay</senha>
      </pag:operacaoTransacao>
   </soapenv:Body>
</soapenv:Envelope>

Exemplo de Retorno

<return>
            <autorizacao>123456</autorizacao>
            <codigoEstabelecimento>1010101010101010</codigoEstabelecimento>
            <codigoFormaPagamento>120</codigoFormaPagamento>
            <codigoTransacaoOperadora>0</codigoTransacaoOperadora>
            <dataAprovacaoOperadora>13/10/2014</dataAprovacaoOperadora>
            <mensagemVenda>Transacao cancelada com sucesso</mensagemVenda>
            <numeroComprovanteVenda>1006993069181F841001</numeroComprovanteVenda>
            <numeroTransacao>123456</numeroTransacao>
            <parcelas>1</parcelas>
            <statusTransacao>13</statusTransacao>
            <taxaEmbarque>0</taxaEmbarque>
            <urlPagamento>14132971582229c00506d-e84d-4526-b902-92190d5aa808<urlPagamento/>
            <valor>100</valor>
            <valorDesconto>0</valorDesconto>
</return>

Observações sobre o Cancelamento da Transação

Intermediário Financeiros e todos os tipos de Boleto não suportam a operação de cancelamento.


Cancelamento por operadora:

Operadora Limite Cancelamento
Cielo 300 dias após a geração do pedido
Rede 24 horas após geração do pedido
Elavon 24 horas após geração do pedido
GETNET 24 horas após geração do pedido
Stone 180 dias após a geração do pedido
Bin 90 dias após captura do pedido