Criar um formulário de pagamento

Para criar uma solicitação de pagamento, você deve montar um formulário html da seguinte forma:
<form method="POST" ação="https://secure.payzen.com.br/vads-payment/">
	<input type="hidden" name="parametre1" value="valor1" />
	<input type="hidden" name="parametre2" value="valor2" />
	<input type="hidden" name="parametre3" value="valor3" />
	<input type="hidden" name="assinatura" value="signature"/>
	<input type="submit" name="pagar" value="Pagar"/>
</form>

Contém:

Os elementos técnicos seguintes:

  • Os tags <form> e </form> que permitem criar um formulário HTML.
  • O atributo method="POST" que especifica o método usado para enviar os dados.
  • O atributo action="https://secure.payzen.com.br/vads-payment/" que especifica onde enviar os dados do formulário.

Os dados do formulário:

  • O código da loja.
  • As características do pagamento em função do caso de uso.
  • As informações complementares em função das suas necessidades.
  • A assinatura que garante a integridade do formulário.

Estes dados são acrescentados ao formulário usando o tag <input> :

<input type="hidden" name="parametro1" value="valor1" />

Para valorizar os atributos name e value, ver o Dicionário de dados disponível em nosso website.

Todos os dados do formulário devem ser codificados em UTF-8.

Os símbolos especiais (acentos, pontuação etc...) serão assim devidamente interpretados pela plataforma de pagamento. Caso contrário, o cálculo de assinatura estará errado e o formulário será recusado.

O botão Pagar vai permitir o envio dos dados:

<input type="submit" name="pagar" value="Pagar"/>

Casos de uso são apresentados nos capítulos seguintes. Eles permitem montar um formulário de pagamento segundo suas necessidades.

O quadro a seguir apresenta os diferentes formatos que você poderá encontrar quando montar seu formulário.

Notação Descrição
a Símbolos alfabéticos (de "A" a "Z" e de "a" a "z")
n Símbolos numéricos
s Símbolos especiais
an Símbolos alfanuméricos
ans Símbolos alfanuméricos e especiais (com exceção de "<" e ">")
3 Comprimento fixo até 3 símbolos
..12 Comprimento variável até 12 símbolos
json JavaScript Object Notation.

Objeto contendo pares de chave/valor separados por uma virgula.

Começa por uma chaveta esquerda " { e acaba com uma chaveta direita " }".

Cada par de chave/valor possui o nome da chave entre aspas duplas seguido por " : ", seguido por um valor.

O nome da chave deve ser alfanumérico.

O valor pode ser:
  • Um string de caracteres (neste caso ele deve ficar entre aspas duplas)
  • um número
  • um objeto
  • um quadro
  • um booliano
  • Vazio
Exemplo: {"name1":45,"name2":"value2", "name3"=false}
enum

Caracteriza um campo que possui um número infinito de valores.

A lista dos valores possíveis é dada na definição do campo.

Lista de enum Lista de valores separados por um " ; ".

A lista dos valores possíveis é dada na definição do campo.

Exemplo: vads_payment_cards=VISA;MASTERCARD

map Lista de pares chave/valor separados por um " ; ".

Todo par chave/valor contém o nome da chave seguido por " = ", seguido por um valor.

O valor pode ser:
  • um string de caracteres
  • um booliano
  • um objeto json
  • um objeto xml

A lista dos valores possíveis para cada par de chave/valor é dada na definição do campo.

Exemplo: vads_theme_config=SIMPLIFIED_DISPLAY=true;RESPONSIVE_MODEL=Model_1