- Apêndice Versão 2.0 24/08/2012
SUMÁRIO HISTÓRICO DE ALTERAÇÕES... 3 1. MÉTODOS DO CARTÃO PROTEGIDO COM DADOS EXTRAS... 4 1.1. SAVING A CREDIT CARD WITH EXTRA DATA... 4 1.2. INSERINDO DADOS EXTRAS... 5 1.3. RECUPERANDO INFORMAÇÕES SOBRE DADOS EXTRAS... 6 Telefone: (21)2111-4700 / (11) 3320-9050 Página 2 de 7
HISTÓRICO DE ALTERAÇÕES Manual de Integração Versão Data Descrição 2.0 24/08/2012 Inserção dos métodos ExtraData Telefone: (21)2111-4700 / (11) 3320-9050 Página 3 de 7
1. MÉTODOS DO CARTÃO PROTEGIDO COM DADOS EXTRAS Abaixo estão representados os fluxos dos webmethods da plataforma do CARTÃO PROTEGIDO, que apresentam a possibilidade de utilização de Dados Extras. 1.1. SAVING a credit card with Extra Data O método SaveCreditCard recebe o objeto SaveCreditCardRequest e deve ser chamado para salvar os dados de uma cartão de crédito e receber a chave identificadora (token) da dupla cartão de crédito-cliente para futuras autorizações via compra com 1 clique. se deve informar RequestId repetidos para essa operação, pois essa informação será necessária para recuperar o JustClickKey na utilização do método GetJustClickKey(). Saving a Credit Card - SaveCreditCard() method SaveCreditCardRequest MERCHANT CARTÃO PROTEGIDO SaveCreditCardResponse Tabela 1 - SaveCreditCardRequest MerchantKey Chave da loja JustClick Sim CustomerIdentification string CPF do comprador CustomerName string Nome do comprador Sim CardHolder string Nome do Portador do cartão de crédito Sim CardNumber string Número do cartão de crédito Sim CardExpiration string Validade do cartão de crédito. Formato: mm/yyyy Sim JustClickAlias string Alias (Apelido) do cartão de crédito ExtraDataCollection (Tabela 7 Pag.7 OfExtraData) Coleção de Dados Extras RequestId Identificador da requisição enviada Sim Version string Versão do método. Padrão: 2.0 Tabela 2 - SaveCreditCardResponse JustClickKey Token (Chave identificadora) que representa o cartão de crédito Sim CorrelationId Identificador da resposta recebida, que será o próprio RequestId enviado no objeto de request Sm Telefone: (21)2111-4700 / (11) 3320-9050 Página 4 de 7
Success ErrorReportCollection bool List<ErrorReport> Indicador de sucesso no fluxo da operação (true ou false). No caso de FALSE, significa que a requisição não foi concluída com êxito e portanto todos os demais parâmetros de retorno podem ser ignorados Lista de erros/validações gerados no fluxo da operação. Vide seção Mapa de Erros (Manual de Integração Págs. 17 e 18) 1.2. INSERINDO Dados Extras O método SetExtraData recebe o objeto SetExtraDataRequest, e deve ser chamado inserir Dados Extras em uma determinada transação. Setting Extra Data - SetExtraData() method SetExtraDataRequest MERCHANT CARTÃO PROTEGIDO SetExtraDataResponse Tabela 3 - SetExtraDataRequest MerchantKey Chave da loja JustClick Sim JustClickKey Token que representa o cartão de crédito Sim JustClickAlias string Alias (Apelido) do cartão de crédito ExtraDataCollection (Tabela 7 Pag.7 OfExtraData) Coleção de Dados Extras RequestId Identificador da requisição enviada Version string Versão do método. Padrão: 2.0 Tabela 4 - SetExtraDataResponse CorrelationId Identificador da resposta recebida, que será o próprio RequestId enviado no objeto de request Success ErrorReportCollection bool List<ErrorReport> Indicador de sucesso no fluxo da operação (true ou false). No caso de FALSE, significa que a requisição não foi concluída com êxito e portanto todos os demais parâmetros de retorno podem ser ignorados Lista de erros/validações gerados no fluxo da operação. Vide seção Mapa de Erros (Manual de Integração Págs. 17 e 18) Telefone: (21)2111-4700 / (11) 3320-9050 Página 5 de 7
1.3. RECUPERANDO informações sobre Dados Extras O método GetExtraData recebe o objeto GetExtraDataRequest, e deve ser chamado para coletar os dados extras inseridos no método SetExtraData Getting Extra Data - GetExtraData() method GetExtraDataRequest MERCHANT CARTÃO PROTEGIDO GetExtraDataResponse Tabela 5 - GetExtraDataRequest MerchantKey Chave da loja JustClick Sim JustClickKey Token que representa o cartão de crédito Sim JustClickAlias string Alias (Apelido) do cartão de crédito FieldCollection (OfString) Coleção de Campos RequestId Identificador da requisição enviada Version string Versão do método. Padrão: 2.0 Tabela 6 - GetExtraDataResponse ExtraDataCollection (Tabela 7 Pag.7 OfExtraData) Coleção de Dados Extras CorrelationId Identificador da resposta recebida, que será o próprio RequestId enviado no objeto de request Success ErrorReportCollection bool List<ErrorReport> Indicador de sucesso no fluxo da operação (true ou false). No caso de FALSE, significa que a requisição não foi concluída com êxito e portanto todos os demais parâmetros de retorno podem ser ignorados Lista de erros/validações gerados no fluxo da operação. Vide seção Mapa de Erros (Manual de Integração Págs. 17 e 18) Telefone: (21)2111-4700 / (11) 3320-9050 Página 6 de 7
Tabela 7 Propriedades do Objeto ExtraData Parâmetros Tipo Descrição Obrigatório? Name String Nome do Campo Sim Value String Valor do Campo Sim Telefone: (21)2111-4700 / (11) 3320-9050 Página 7 de 7