paymentRequest

O objeto paymentRequest permite transmitir informações sobre o pagamento.

Possui os atributos seguintes:

Tabela 1. Objeto paymentRequest
paymentRequest
Atributo Requisito Formato
transactionId

Código da transação durante a criação ou a modificação de uma transação de pagamento.

Seu valor é único para o mesmo dia.

  • Ou este código será gerado pela plataforma. Neste caso, este parâmetro não deve ser informado.
  • Ou este código será gerado pelo site de e-commerce. Neste caso, este parâmetro deve ser informado com o valor do código desejado. Cuidado, cabe ao site de e-commerce garantir o caráter único dos códigos de usuários. Toda solicitação de registro contendo um código de usuário já existente, será recusada, e será retornada com o código de erro 12.

    Observação: este atributo não pode ser enviado vazio.

  an..6
retryUuid

Permite especificar o código único da transação para solicitar de novo o pagamento recusado.

Para realizar esta re-chamada, favor retomar o valor da referência única da transação recusada e veiculada pelo atributo transactionUuid do objeto paymentResponse.

  string
amount

Valor da transação na sua menor unidade monetária (o centavo para o real brasileiro).

Observação:

  • Não deve ser enviado vazio ou com o valor 0.
  • Não deve ser superior ao valor inicial (caso de reembolso).
n..12
currency

Código da moeda da transação (norma ISO 4217).

Ex: 986 para o real do Brasil (BRL)

n3
expectedCaptureDate

Data da captura solicitada apresentada no formato ISO 8601 definido pelo W3C.

Exemplo: 2016-07-16T19:20:00Z.

Este parâmetro é utilizado para efetuar um pagamento a prazo.

Se a quantidade de dias entre a data de captura solicitada e a data do dia vigente for superior ao tempo de validade da autorização, uma autorização de 1 BRL será realizada o mesmo dia da transação. Permite verificar a validade do cartão.

A autorização para o valor total será efetuada:

  • processo padrão: o dia da data de captura no banco desejada,
  • processo com autorização antecipada: em função do meio de pagamento selecionado, a D- quantidade de dias correspondente ao tempo de validade de uma autorização antes da data de captura no banco desejada.

Se você quiser receber a notificação de resultado desta solicitação de autorização, você deve configurar a regra de notificação URL de notificação em autorização por Batch no Back Office Estabelecimento comercial (Configuração > Regras de notificações).

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

  dateTime ans..40
manualValidation

Permite validar manualmente uma transação enquanto a data de captura no banco não for ultrapassada.

Para isso, este atributo deve ser valorizado a 1 (validação manual).

Valorizado a 0, a validação será automática.

  n1
paymentOptionCode.

Permite definir o código da opção de pagamento a ser usada.

Corresponde à quantidade de parcelas para um pagamento parcelado.

   
acquirerTransientData

Permite enviar informações úteis ao adquirente para realizar controles antifraude:

URL da loja, nome da loja, número de pedido, despesas de entrega, meio de entrega, etc..

Exemplo:

acquirerTransientData = {VISANET={ "field91": "10XXXXXXX", "field92": "Lyra Peru", "field93": "specific data" }}

  json