Manual de Integração
Cartão Protegido - Apêndice
Versão 2.0
24/08/2012
Telefone: (21)2111-4700 / (11) 3320-9050 Página 2 de 7
SUMÁRIO
HISTÓRICO DE ALTERAÇÕES ... 3 MÉTODOS DO CARTÃO PROTEGIDO COM DADOS EXTRAS... 4 1.
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 3 de 7
HISTÓRICO DE ALTERAÇÕES
Cartão Protegido – Manual de Integração
Versão Data Descrição
Telefone: (21)2111-4700 / (11) 3320-9050 Página 4 de 7
MÉTODOS DO CARTÃO PROTEGIDO COM DADOS EXTRAS 1.
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”. Não 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().
MERCHANT
SaveCreditCardRequest
SaveCreditCardResponse
CARTÃO PROTEGIDO Saving a Credit Card - SaveCreditCard() method
Tabela 1 - SaveCreditCardRequest
Parameters Type Description Required?
MerchantKey Guid Chave da loja JustClick Sim
CustomerIdentification string CPF do comprador Não
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 Não
ExtraDataCollection
Array (Tabela 7 – Pag.7
ArrayOfExtraData)
Coleção de Dados Extras Não
RequestId Guid Identificador da requisição enviada Sim
Version string Versão do método. Padrão: 2.0 Não
Tabela 2 - SaveCreditCardResponse
Parameters Type Description Required?
JustClickKey Guid Token (Chave identificadora) que representa o cartão de crédito Sim
CorrelationId Guid
Identificador da resposta recebida, que será o próprio “RequestId” enviado no objeto de request
Telefone: (21)2111-4700 / (11) 3320-9050 Página 5 de 7
Success bool
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
Não
ErrorReportCollection List<ErrorReport>
Lista de erros/validações gerados no fluxo da operação. Vide seção “Mapa de Erros” (Manual de Integração Cartão Protegido – Págs. 17 e 18)
Não
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.
MERCHANT
SetExtraDataRequest
SetExtraDataResponse
CARTÃO PROTEGIDO Setting Extra Data - SetExtraData() method
Tabela 3 - SetExtraDataRequest
Parameters Type Description Required?
MerchantKey Guid Chave da loja JustClick Sim
JustClickKey Guid Token que representa o cartão de crédito Sim
JustClickAlias string Alias (Apelido) do cartão de crédito Não
ExtraDataCollection
Array (Tabela 7 – Pag.7
ArrayOfExtraData)
Coleção de Dados Extras Não
RequestId Guid Identificador da requisição enviada Não
Version string Versão do método. Padrão: 2.0 Não
Tabela 4 - SetExtraDataResponse
Parameters Type Description Required?
CorrelationId Guid Identificador da resposta recebida, que será o próprio “RequestId” enviado no objeto de request Não
Success bool
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
Não
ErrorReportCollection List<ErrorReport>
Lista de erros/validações gerados no fluxo da operação. Vide seção “Mapa de Erros”
(Manual de Integração Cartão Protegido – Págs. 17 e 18)
Telefone: (21)2111-4700 / (11) 3320-9050 Página 6 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
MERCHANT
GetExtraDataRequest
GetExtraDataResponse
CARTÃO PROTEGIDO Getting Extra Data - GetExtraData() method
Tabela 5 - GetExtraDataRequest
Parameters Type Description Required?
MerchantKey Guid Chave da loja JustClick Sim
JustClickKey Guid Token que representa o cartão de crédito Sim
JustClickAlias string Alias (Apelido) do cartão de crédito Não
FieldCollection (ArrayOfString) Array Coleção de Campos Não
RequestId Guid Identificador da requisição enviada Não
Version string Versão do método. Padrão: 2.0 Não
Tabela 6 - GetExtraDataResponse
Parameters Type Description Required?
ExtraDataCollection
Array (Tabela 7 – Pag.7
ArrayOfExtraData)
Coleção de Dados Extras Não
CorrelationId Guid Identificador da resposta recebida, que será o próprio
“RequestId” enviado no objeto de request Não
Success bool
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
Não
ErrorReportCollection List<ErrorReport>
Lista de erros/validações gerados no fluxo da operação. Vide seção “Mapa de Erros”
(Manual de Integração Cartão Protegido – Págs. 17 e 18)
Telefone: (21)2111-4700 / (11) 3320-9050 Página 7 de 7
Tabela 7 – Propriedades do Objeto ExtraData
Parâmetros Tipo Descrição Obrigatório?
Name String Nome do Campo Sim