Criar um formulário “Criação de um Token Cartão na contratação de uma assinatura”

Caso de uso: contratação de uma assinatura com criação de um Token Cartão.

IMPORTANTE

Nenhum pagamento será realizado durante a contratação. Somente uma solicitação de verificação será realizada para validar os dados do meio de pagamento.

O primeiro pagamento será realizado uma vez que a data de efeito for atingida, entre 00h00 e 05h00.

Se você desejar que o comprador faça um primeiro pagamento na hora da contratação, consulte o capítulo seguinte: Criar um formulário “Criação de um Token Cartão na contratação de uma assinatura seguida de um pagamento”.

  1. Informar a totalidade dos campos presentes no quadro que segue para montar seu formulário de pagamento.
    Nome do campo Descrição Formato Valor
    vads_page_action Ação a ser realizada. enum REGISTER_SUBSCRIBE
    vads_ctx_mode Modo de funcionamento. enum TEST ou PRODUCTION
    vads_cust_email Endereço e-mail do comprador. ans..150 Ex: mail@example.com
    vads_action_ mode Modo de aquisição dos dados do meio de pagamento. enum INTERACTIVE
    vads_site_id Código de identificação da loja. n8 Ex: 12345678
    vads_sub_amount Valor das parcelas da assinatura (na sua menor unidade monetária). n..12 Ex: 3000 para 30,00 BRL
    vads_sub_effect_date Data de início da assinatura. n8

    Cuidado, esta data não pode ser anterior à data vigente.

    Ex: 20210601
    vads_sub_currency Código da moeda usada para a assinatura. n3 Ex: 986 para o Real do Brasil (BRL)
    vads_sub_desc Regra de recorrência a ser aplicada segundo a especificação iCalendar RFC5545. string

    A frequência da assinatura pode ser diária, semanal ou mensal.

    Pode-se especificar o número do dia ou do mês (por exemplo “10 do mês”, “cada 3 meses”).

    Observação: o string não deve conter espaço.

    Exemplos:
    • Para definir uma assinatura todas as semanas:
      RRULE:FREQ=WEEKLY
    • Para definir uma assinatura a cada duas semanas, hoje e a cada 7 dias:
      RRULE:FREQ=WEEKLY;INTERVAL=2
    • Para definir parcelas de pagamento que ocorrem o último dia de cada mês, durante 12 meses:
      RRULE:FREQ=MONTHLY;BYMONTHDAY=28,29,30,31;BYSETPOS=-1;COUNT=12
    • Para definir parcelas de pagamento no dia 10 de todo mês, durante 12 meses:
      RRULE:FREQ=MONTHLY;COUNT=12;BYMONTHDAY=10
    vads_trans_date Data e hora UTC do formulário de pagamento. n14 Ex: 20190501130025
    vads_version Versão do protocolo de troca. string V2
    Observação:
    O valor de vads_sub_effect_date não pode ter uma data vencida.

  2. Use o campo vads_identifier se você desejar gerar o código do Token associado ao meio de pagamento.
    O formato do token não pode ser an..32. Este formato é reservado aos Tokens gerados pela plataforma de pagamento.
  3. Adicione os campos opcionais em função das suas necessidades (ver capítulo Usar funções complementares ).
  4. 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).