support
Voltar para documentação
Procurando
Categoria
Tags
parâmetros principaisexpandir todos
uuid
requerido
opções transações gerais
amount
currency
comment
opções relativas ao cartão
transactionOptions
cardOptions
manualValidation
captureDelay
mid
Testar
Documentação

Serviço web Transaction/Refund

A chamada de serviços Web requer autenticação básica HTTP . Mais informações: " Fase de Autenticação ".

POSThttps://api.lyra.com/api-payment/V4/Transaction/Refund

O REST Web Service Transação/Reembolso permite reembolsar uma transação (total ou parcial se o adquirente suportar).

  • Status obrigatório:
    • CAPTURED (Présenté)

O reembolso tem 2 etapas sucessivas.

  1. O reembolso éEm andamentotratamento.
    Transações tem um statusPENDING.
  2. O reembolso é validado.
    Transações tem um statusAUTHORISED.
  • Para ser notificado sobre a mudança de status (dePENDINGparaAUTHORISED), crie uma regra personalizada na seção “bom_expert" :Criar uma notificação de tipo Reembolso.

Você pode descobrir o status de uma transação usando o Web Service, Transaction/Get , (parâmetro detailedStatus,).

  • Reembolso parcial :

    • Utilize o serviço Web Transação/Reembolso e transmita um valor inferior ao valor da transação.
    • Você pode reembolsar parcialmente uma transação várias vezes, até que o reembolso seja integral.

  • Reembolso total:

    • Utilize o serviço Web Transação/Reembolso e transmita um valor igual ao valor da transação.

Configurações de entrada

uuid

Referência única da transação gerada pela plataforma de pagamento.

Formato

amount

Montante da transação na menor unidade monetária (centavo para o Real). Ex: 1234 para 12,34 BRL.

Exemplo: 30050 para 300,50 EUR.

Formato

currency

Moeda do pagamento. Código alfabético em maiúsculas de acordo com ISO 4217 alfa-3.

Exemplo: "EUR” para o euro.

Formato

Valores possíveis

Os valores possíveis são os seguintes:

Moeda CODIFICAÇÃO ISO 4217 Unidade fracionária
Dólar australiano (036) AUD 2
Dólar canadense (124) CAD 2
Franco suíço (756) CHF 2
Coroa dinamarquesa (208) DKK 2
Euro (978) EUR 2
Libra Esterlingo (826) GBP 2
Iene japonês (392) JPY 0
Coroa norueguesa (578) NOK 2
Coroa sueca (752) SEK 2
Dólar dos Estados-Unidos (840) USD 2

comment

Comentário livre.

Formato

manualValidation

Caminho: transactionOptions.cardOptions.manualValidation

Modo de validação da transação.

Formato

Valores possíveis

Os valores possíveis são os seguintes:

VALOR Descrição
NO Validação automática pela plataforma de pagamento.
YES Validação manual pelo Estabelecimento Comercial.
null Configuração padrão da loja escolhida (pode ser configurado no Back Office EC).

captureDelay

Caminho: transactionOptions.cardOptions.captureDelay

Prazo para aplicar na data de captura.

Descrição

Indica o prazo em número de dias antes da captura no banco.

Se este parâmetro não é enviado, então o valor padrão definido no Back Office EC será usado.

Este último pode ser configurado no Back Office EC por todas as pessoas devidamente autorizadas.

Se o prazo anterior à captura for superior a 365 dias na solicitação de pagamento, ele será automaticamente redefinido a 365 dias.

Formato

mid

Número de contrato e-commerce EC no qual será realizado o reembolso de uma transação presencial Se este campo é informado, tomar cuidado em utilizar o contrato VADS certo em relação à rede do cartão.

Formato

Referência da resposta

O web service retorna o objeto seguinte:

Resposta Contexto
Transaction Objeto com os dados da transação.

Consultar a referência da resposta para maiores detalhes.