O que é ?

 

A URA (Unidade de Resposta Audível) PCI (Payment Card Industry, Padrão de Segurança de Dados da Industria de Cartões de Pagamento) oferece 2 (dois) métodos para coleta de dados dos cartões de pagamento. Cada método é responsável por coletar um conjunto de dados pré-determinados, tais como: número do cartão de crédito e código de segurança.

 

Como funciona ?

URA PCI
URA PCI
  1. O servidor de aplicação ou o front-end do usuário de CRM/ERP envia a solicitação via Web Service para URA PCI e deve indicar o método de coleta dos dados desejado, também, deve aguardar a resposta da interface.
  1. A URA PCI, após receber a solicitação, estabelece uma sessão segura via CTI (Computer Telephony Integration) com o PBX AiOCore. O CTI envia uma sequência de comandos/instruções para o AiOAgent (Painel do Agente).
  1. O AiOAgent, após receber as instruções, transfere a chamada de voz do cliente para a URA e altera seu estado para “Pausado”.
  1. O cliente ouvirá as instruções de acordo com o método solicitado e após o beep deve inciar a digitação dos dados do cartão de pagamento. Após a captura de todos os dígitos o CTI transfere novamente a chamada de voz do cliente para o agente e altera seu estado para “Em Atendimento”, em seguida encerra a sessão CTI com o PBX e envia os dados coletados para a interface no formato JSON.

 

Especificação dos Web Services

 

PCI-01S CREDITCARD

Método: Responsável por transferir a chamada de voz di cliente para a URA, coletar o número do cartão de crédito e devolver os dados para a interface.

Observação: O tempo limite para a devolução dos dados é de até 60 segundos. Esse método pode ser solicitado quantas vezes for necessária até que a coleta seja concluída com sucesso.

Parâmetros de Chamada:

Request
Elemento Atributo Tipo Tamanho Descrição Req.
token CHAR 100 Token/Id de Identificação da solicitação sim
exten INT 5 Extensão, número do ramal, código do agente que executará o processo. sim
card_lenght INT 2 Número de dígitos a ser coletado, se não informado a quantidade máxima de dígitos esperado será 21. não
Url
Exemplos:

http://serveraddress/pci/creditcard/?token=123456abc&exten=20001

http://serveraddress/pci/creditcard/?token=123456abc&exten=20001&card_lenght=16

Resposta:

Response
Código                                                                      Descrição
200 RETURN_MSG_OK Processo executado com sucesso
400 RETURN_MSG_BAD_REQUEST Token não enviado, vazio ou nulo.
403 RETURN_MSG_FORBIDDEN Solicitação bloqueada, solicitante bloqueado.
404 RETURN_MSG_NOT_FOUND Número do Cartão de Pagamento não digitado.
405 RETURN_MSG_METHOD_NOT_ALLOWED Método não permitido.
406 RETURN_MSG_NOT_ACCEPTABLE Número do Cartão de Pagamento é inválido.
409 RETURN_MSG_CONFLICT Conflito de Token
420 RETURN_MSG_BAD_EXTENSION Extensão não cadastrada, inexistente.
421 RETURN_MSG_EXTENSION_REQUIRED Extensão não enviada ou vazia/nula.
Exemplo
Exemplo:

{“RequestId”:1, “status”:200, “method”:”creditcard”, “values”: {“token”:”123456abc”, exten”:20001, “dtmf”: 0123456789123456, “flag”: MasterCard}}

 

PCI-02S SECURITYCODE

Método: Responsável por transferir a chamada de voz para a URA, coletar o código de segurança do cartão de crédito e devolver os dados para a interface.

Observação: O tempo limite para a devolução dos dados é de até 30 segundos. Esse método pode ser solicitado quantas vezes for necessária até que a coleta seja concluída com sucesso.

Parâmetros de Chamada:

Request
Elemento Atributo Tipo Tamanho Descrição Req.
token CHAR 100 Token/Id de Identificação da solicitação sim
exten INT 5 Extensão, número do ramal, código do agente que executará o processo. sim
cvv_lenght INT 1 Número de dígitos a ser coletado, se não informado a quantidade máxima de dígitos esperado será 5. não
Url
Exemplos:

http://serveraddress/pci/securitycode/?token=123456abc&exten=20001

http://serveraddress/pci/securitycode/?token=123456abc&exten=20001&cvv_lenght=3

Resposta:

Response
Código                                                                      Descrição
200 RETURN_MSG_OK Processo executado com sucesso
400 RETURN_MSG_BAD_REQUEST Token não enviado, vazio ou nulo.
403 RETURN_MSG_FORBIDDEN Solicitação bloqueada, solicitante bloqueado.
404 RETURN_MSG_NOT_FOUND Número do Cartão de Pagamento não digitado.
405 RETURN_MSG_METHOD_NOT_ALLOWED Método não permitido.
406 RETURN_MSG_NOT_ACCEPTABLE Número do Cartão de Pagamento é inválido.
409 RETURN_MSG_CONFLICT Conflito de Token
420 RETURN_MSG_BAD_EXTENSION Extensão não cadastrada, inexistente.
421 RETURN_MSG_EXTENSION_REQUIRED Extensão não enviada ou vazia/nula.
Exemplo
Exemplo:

{“RequestId”:1, “status”:200, “method”:”securitycode”, “values”: {“token”:”123456abc”, “exten”:20001, “dtmf”: 123}}

 

 

CompartilheShare on FacebookTweet about this on TwitterShare on LinkedIn

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *