Skip to main content

Tokeniza cartão

Gera um token, representando o cartão de crédito, para ser utilizado para pagamento do ticket. Esta funcionalidade não está disponível para o adquirente GenPag, uma vez que a tokenização, no caso da GenPag, é feita pelo próprio aplicativo.

POST api/integradores/adquirentes/cartoes

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.

Back to top