Criar um pagamento pré-datado

Este modo de pagamento permite ao estabelecimento oferecer uma facilidade de pagamento para o comprador.

O formulário de pagamento estabelece o número de parcelas e o intervalo que os separa.

A primeira parcela funciona da mesma forma que um pagamento à vista.

As seguintes parcelas funcionam da mesma forma que um pagamento pré-datado.

Atenção:

As regras de notificações devem ser ativadas. Ver capítulo Configurar as notificações para maiores detalhes.

Esclarecimento:

No dia do pagamento, o estabelecimento não é creditado da totalidade do valor e a garantia de pagamento não pode ser aplicada nas parcelas futuras.

A data da última parcela não pode ser superior a 1 ano em relação à data de apresentação do formulário. Caso contrário, uma mensagem de erro é exibida e o formulário será recusado.

  1. Informar a totalidade dos campos presentes abaixo para montar seu formulário de pagamento.
    Nome do campo Descrição Formato Valor
    vads_site_id Código da loja n8 Ex: 12345678
    vads_ctx_mode Modo de comunicação com a plataforma de pagamento enum TEST ou PRODUCTION
    vads_trans_id Número da transação n6 Ex: 123456
    vads_trans_date Data e hora do formulário de pagamento no fuso horário UTC n14

    Respeite o formato AAAAMMDDhhmmss

    Ex: 20170701130025
    vads_amount Valor do pagamento na sua menor unidade monetária (o centavo para o Real brasileiro) n..12 Ex: 3000 para 30,00 BRL
    vads_currency Código numérico da moeda a ser usada para o pagamento, segundo a norma ISO 4217 (código numérico) n3 Ex: 986 para o Real do Brasil (BRL)
    vads_action_mode Modo de aquisição dos dados do cartão enum INTERACTIVE
    vads_page_action Ação a ser realizada enum PAYMENT
    vads_version Versão do protocolo de troca com a plataforma de pagamento enum V2
    vads_payment_config Tipo de pagamento enum

    ver etapa 2.

    vads_capture_delay Prazo antes da captura no banco n..3 0
    vads_validation_mode Apresenta o modo de validação da transação (manualmente pelo estabelecimento ou automaticamente pela plataforma) n1 0 ou 1 ou ausente ou vazio
  2. Preencher o campo vads_payment_config respeitando a seguinte sintaxe:
    • Valores e datas de parcelas fixas :

      MULTI:first=1000;count=3; period=30:

      "first" corresponde o valor do pagamento (na sua menor unidade monetária) do primeiro pagamento feito no dia do pagamento,
      "count" representa o número total de parcelas,
      "period" determina o intervalo entre cada parcela.
    • Valores e datas de parcelas personalizadas:

      MULTI_EXT:data1=valor 1;data2=valor 2;data3=valor3 ou:

      data1=valor1 estabelece a data e o valor da primeira transferência.
      Os valores são apresentados na menor unidade da moeda. A soma de todos os valores deve ser igual ao valor do campo vads_amount.
      As datas são apresentadas no formato YYYYMMDD.
  3. Preencher o campo vads_capture_delay a 0. O primeiro pagamento será entregue no banco o mesmo dia.
  4. Preencher o campo vads_validation_mode a 0 para uma validação automática (o pagamento será entregue automaticamente no banco) ou a 1 para uma validação manual (operação manual efetuada pelo Back Office Estabelecimento Comercial).
    O modo de validação se aplica para todas as parcelas.
  5. Preencher o campo vads_currency com o código da moeda desejada usando o quadro das moedas (Ex: 986 para o Real do Brasil (BRL)).
  6. Acrescente os campos em opção em função das suas necessidades (ver capítulo Usar funções complementares).
  7. Calcular o valor do campo signature usando a totalidade dos campos do seu formulário, com o nome começando por vads_ (ver capítulo Calcular a assinatura)
Exemplo de formulário de pagamento pré-datado (Valores e datas de parcelas fixas):
<form method="POST" action="https://secure.payzen.com.br/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="3000" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="986" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="MULTI:first=1000;count=3;period=30"/>
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20190629180150" />
<input type="hidden" name="vads_trans_id" value="180150" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value= "zrhUNkAciZSEl6mS4BbhV3qkYUBB9RYJQCdg1kU0ELU="/>
<input type="submit" name="pagar" value="Pagar" />
</form>

Exemplo de formulário de pagamento pré-datado (Valores e datas de parcelas fixas):
<form method="POST" action="https://secure.payzen.com.br/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="3000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="986" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value=" 
MULTI_EXT:20140201=1000;20140301=1000;20140401=1000" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20190629130025" />
<input type="hidden" name="vads_trans_id" value="130025" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="7Sds6Z+R1Q1axRsblpChyQh5OU3oCle5FOirD4V/Bzk="/>
<input type="submit" name="pagar" value="Pagar"/>
</form>