support
Voltar para documentação
Procurando
Categoria
Tags
parâmetros principaisexpandir todos
amount
requerido
currency
requerido
uuid
requerido
orderId
recomendado
opções transações gerais
comment
metadata
[1]
:
opções relativas ao cartão
cardDuplicate
manualValidation
captureDelay
mais propriedades
acquirerTransientData
[1]
:
Testar
Documentação

Web service Transaction/Duplicate

L'appel aux Web Services requiert une authentification HTTP Basic Authentication. Plus d'infos : "Phase d'authentification".

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

O Web Service REST Transaction/Duplicate permite criar uma nova transação a partir de uma transação existente mantendo as mesmas características (exemplo: meio de pagamento, dados do comprador).

As transações que podem estar sujeitas à duplicação devem possuir um dos detailedStatus seguintes:

  • CAPTURED (Capturado)
  • EXPIRED (Vencido)
  • CANCELLED (Cancelado)
  • REFUSED (Recusado)

A duplicação de transações recusadas, realizadas com cartões ((Mastercard, Maestro, Mastercard Débito), é proibida quando a razão da recusa consta na lista abaixo:

  • 04 - Capture card
  • 41 - Lost card
  • 14 - Invalid card number
  • 43 - Stolen card
  • 15 - Invalid issuer
  • 54 - Expired card

Plus d'infos sur les statuts, consultez : Cycle de vie d'une transaction.

Consultez les paramètres de la réponse Transaction.

Configurações de entrada

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

uuid

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

Formato

orderId

Referência do pedido definida pelo Estabelecimento Comercial. Não suporta os caracteres UTF-8.

Formato

comment

Comentário livre.

Formato

metadata

Valores personalizados vinculados à transação, no formato json.

Exemplo de chamada:

Por exemplo, para passar um valor personalizado, adicione a sua solicitação:

{
    "metadata": {
        "MyValueKey": "1234"
    }
}

Esse valor é retornado no objeto da transação recém-criada.

Pode também usar os metadatas " orderInfo1 ", " orderInfo2 " e " orderInfo3 ”para enviar informações adicionais sobre o pedido.

Estes dados serão depois exibidos na aba Extra do detalhe da transação no seu Back Office EC.

Formato

captureDelay

Caminho: cardDuplicate.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

manualValidation

Caminho: cardDuplicate.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).

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.