As requisições de cadastro executam ações não-transacionais no sistema. Estas funções permitem salvar o cartão de crédito do cliente em nossa base e gerenciar futuras transções a partir de um token único.

A estrutura do XML é um pouco diferente nas requisições de Transação. A validação das credenciais permanece a mesma, mas surgem dois novos elementos, além de tre outro nó-raiz:<api-request/>.

 

O Elemento <command/>

 

O elemento <command/> determina a função a ser executada, enquanto que o nó <request/> contém os detalhes da requisição. Os comandos disponíveis são:

  • add-consumer: cria um cadastro para o cliente com as suas informações.
  • update-consumer: atualiza o cadastro do cliente.
  • delete-consumer: remove o cadastro do cliente.
  • add-card-onfile: adiciona um cartão de crédito ao cadastro do cliente.
  • delete-card-onfile: remove um cartão de crédito do cadastro do cliente.

 

A Estrutura Básica do XML

 

A estrutura básica do XML fica, então da seguinte forma:

<api-request>
    <verification>
        <merchantId />
        <merchantKey />
    </verification>
    <command />
    <request>
        ...
    </request>
</api-request>