Serviço de edição de pré-autorização
O roteamento GetnetLac permite alterar o valor de uma pré-autorização não capturada. Consulte nosso Suporte para verificar se existem outros roteamentos com esta funcionalidade. Para utilizar essa funcionalidade, basta chamar novamente a operação doPreAuthorization com os dados de uma transação de pré-autorização com status CON (confirmada) com adição do campo amount. Abaixo estão os detalhes dessa chamada.
Parâmetros de Requisição:#
| Nome do Parâmetro | Descrição | Tamanho | Obrigatório |
|---|---|---|---|
nit | Identificador da transação no Carat. Obtido no retorno da chamada ao beginTransaction. | = 64 A | Sim |
authorizer_id | Código da autorizadora no Carat. Ver lista de autorizadoras. | ≤ 3 N | Sim |
amount | Valor total da compra (em centavos). | ≤ 12 N | Sim |
number | Número do cartão do comprador (PAN). | ≤ 19 N | Sim |
token | Utilizado para casos de pagamento recorrente, onde o cartão já deverá estar armazenado na base de dados do Carat. Obrigatório utilizar um entre os campos (number, token ou initial_wallet_transaction_id) | = 88 A | Condicional |
expiry_date | Data de vencimento no formato MMAA. | = 4 N | Sim |
security_code | Código de segurança. | ≤ 5 N | Sim |
ecomm_pos_ref | Este campo enviará uma identificação que constará no campo PDV do relatório do SiTef Web para transações e-commerce. | ≤ 8 AF | Não |
Parâmetros de Resposta:#
| Nome do Parâmetro | Descrição | Tamanho |
|---|---|---|
code | Código de resposta do Carat. Qualquer código diferente de "0" significa falha. Para maiores informações, consulte o documento Anexo A-2 - Codigos de Resposta. | < 4 N |
message | Mensagem de resposta do Carat. | < 500 AN |
acquirer_id | Código do adquirente/roteamento utilizado na transação. | < 4 N |
acquirer_name | Nome do adquirente/roteamento utilizado na transação. | < 100 AN |
amount | Valor da compra especificado pela loja (em centavos). | < 12 AN |
authorization_number | Número de autorização. | < 6 AN |
authorizer_code | Código de resposta do autorizador. | < 10 AN |
authorizer_date | Data de efetivação da pré-autorização retornada pelo autorizador no formato DD/MM/AAAA’T’HH:mm. Exemplo: 13/07/2017T16:03 | = 16 D |
authorizer_id | Código da autorizadora utilizada na transação. | < 4 N |
authorizer_merchant_id | Código de afiliação do lojista na autorizadora. | < 100 AN |
authorizer_message | Mensagem de resposta do autorizador. | < 500 AN |
customer_receipt | Cupom (via cliente). | < 4000 AN |
eci | Eletronic Commerce Indicator (indicador do nível de segurança da transação da pré-autorização via Cielo e-Commerce). | < 3 AN |
esitef_usn | Número sequencial único da transação de pré-autorização no Carat. | = 15 N |
host_usn | NSU da autorizadora. | < 15 AN |
issuer | Código da bandeira retornado pelo autorizador. | < 5 AN |
merchant_receipt | Cupom (via estabelecimento). | < 4000 AN |
merchant_usn | Número sequencial único enviado pela loja na criação da transação. | < 12 AN |
nit | Identificador da transação de pré-autorização no Carat. | = 64 AN |
order_id | Código de pedido enviado pela loja na criação da transação. | < 40 AN |
payment_type | Tipo do pagamento da autorizadora escolhida: B = boleto, C = crédito, D = débito, P = cartão crédito Private Label puro, T = tranferência bancária, G = cartão gift, O = outros meios e pagamentos, W = Boleto NR via Web Service | = 1 A |
sitef_usn | Número sequencial único da transação de pré-autorização no SiTef. | = 6 N |
status | Status da transação de pré-autorização no Carat. | = 3 AN |
tid | ID da transação no adquirente/roteamento. Este campo só é retornado em transações com adquirentes externos ao SiTef. | < 40 AN |
xid | Campo XID retornado em autenticações 3DS ou certos adquirentes/roteamentos. | < 40 AN |
Em caso de sucesso, será retornado o responseCode ‘0’. O status da transação não será alterado em hipótese
alguma (sucesso ou falha). Porém, os campos sitef_usn, host_usn, authorization_number, sitef_date, customer_receipt e merchant_receipt sofrerão mudanças caso a alteração seja confirmada.