Tokeniza um cartão digitado no navegador do comprador (devolve um token de uso único)
/v1/tokenization/tokensAutentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.
Parâmetros de consulta
pkstringobrigatórioA sua chave publicável (
pk_live_…/pk_test_…), emitida junto com cada chave de API. Segura num navegador.
Corpo da requisição
numberingstringobrigatórioNúmero do cartão (PAN), só dígitos — espaços e traços são removidos. Tokenizado ao chegar, nunca guardado.
holderNamestringobrigatórioNome impresso no cartão.
securityCodestringobrigatórioCódigo de segurança do cartão (CVV/CVC), 3 ou 4 dígitos.
expirationYearobjectobrigatórioAno de validade, 4 dígitos — 2 dígitos são aceitos.
expirationMonthintegerobrigatórioMês de validade, 1 a 12.
Respostas
201Criado
cardobjectobrigatórioO que se sabe do cartão, para exibição.
+7 campos de
cardbrandstringobrigatórioBandeira do cartão.
brandTypestringobrigatóriocredit,debit…holderNamestringobrigatórioNome impresso no cartão.
lastDigitsstringobrigatórioQuatro últimos dígitos.
firstDigitsstringobrigatórioSeis primeiros dígitos.
expirationYearstringobrigatórioAno de validade (
YYYY).expirationMonthstringobrigatórioMês de validade (
MM).
tokenstringobrigatórioO token de cartão de uso único — o que
POST /v1/cards(token) epayment.card.tokenrecebem.ttlSecondsintegerobrigatórioPor quanto tempo o token continua utilizável, em segundos.
400Requisição inválida (validação)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
401Não autenticado (credencial ausente ou inválida)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
422Regra de negócio impede o processamento
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
429Limite de requisições excedido
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
500Erro interno do servidor
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
503Serviço indisponível
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório