Tokeniza cartão
Gera um token, representando o cartão de crédito, para ser utilizado para pagamento do ticket.
POST api/cartao_credito/tokeniza
HEADERS
CHAVE |
VALOR |
DESCRIÇÃO |
OBRIGATÓRIO |
Accept |
application/vnd.linkc.com.br; version=1 | Versão da API. | SIM |
Authorization |
Bearer <TOKEN> |
Token obtido na autenticação |
SIM |
Content-Type |
application/json |
Tipo de conteúdo do request |
SIM |
PARÂMETROS QUERY STRING
CHAVE |
DESCRIÇÃO |
OBRIGATÓRIO |
cartao_credito.numero | Número do cartão de crédito. | SIM |
cartao_credito.portador | Nome do portador do cartão de crédito. | SIM |
cartao_credito.validade | Data de validade do cartão de crédito no formato MM/YYYY. | SIM |
cartao_credito.consumidor | JSON contendo dados do portador do cartão de crédito. | SIM para Maxipago, NÃO para as demais |
cartao_credito.consumidor.id | Número de identificação do portador na aplicação cliente. | SIM |
cartao_credito.consumidor.nome | Nome e sobrenome do portador, separado por espaço simples. | SIM |
BODY DO REQUEST PARA CIELO E GETNET
{
"cartao_credito": {
"numero": "1234432112344321",
"portador": "PORTADOR",
"validade": "08/2021"
}
}
BODY DO REQUEST PARA MAXIPAGO
{
"cartao_credito": {
"numero": "4111111111111111",
"portador": "PORTADOR",
"validade": "08/2021",
"consumidor": {
"id": "123",
"nome": "NOME SOBRENOME"
}
}
}
RETORNO EM CASO DE SUCESSO (200 – OK)
CHAVE |
DESCRIÇÃO |
token |
Token gerado pelo adquirente e armazenado pelo integrador, representando o cartão de crédito. |
RETORNO EM CASO DE SUCESSO DE CONSULTA POR TICKET
{
"cartao_credito": {
"token": "db62dc71-d07b-4745-9969-42697b988ccb"
}
}
OUTROS RETORNOS
CÓDIGO HTTP |
DESCRIÇÃO |
400 |
Caso os parâmetros passados estejam incorretos. |
401 |
Caso as credenciais sejam inválidas. |
422 |
Caso haja problema na transação com a adquirente, dois parâmetros adicionais serão retornados: retorno_codigo e retorno_mensagem, contendo o código de retorno da adquirente e uma mensagem produzida pela API referente ao código retornado pela adquirente. |