Onde e como o navegador do comprador tokeniza um cartão (endpoint da Selectwin; nenhuma credencial trafega)

GET/v1/tokenization/config

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros de consulta

pkstring
A sua chave publicável (pk_live_… / pk_test_…), emitida junto com cada chave de API. Segura num navegador.

Respostas

200Sucesso

elementsobjectobrigatório
Selectwin Elements: o iframe de cartão hospedado — os campos do cartão vivem na origem da Selectwin, então a sua página nunca segura o número do cartão.
+2 campos de elements
- fieldsUrlstring (uri)obrigatório
  Os campos de cartão hospedados que o elemento embute.
- scriptUrlstring (uri)obrigatório
  O script que a sua página carrega para montar o elemento de cartão.
publicKeystringobrigatóriopode ser nulo
A sua chave publicável, devolvida para uma página que chegou aqui com SelectKey poder continuar usando a pk.
environmentstringobrigatório
O ambiente a que a chave pertence.
Valores:livesandbox
tokenizationobjectobrigatório
Onde e como o navegador tokeniza um cartão.
+6 campos de tokenization
- urlstring (uri)obrigatório
  Para onde o navegador faz o POST do cartão: o endpoint de tokenização da Selectwin, já com ?pk=.
- fieldsobjectobrigatório
  O nome do campo do corpo para cada campo do cartão.
  +5 campos de fields
  - numberstringobrigatório
    Campo do corpo para o número do cartão.
  - holderNamestringobrigatório
    Campo do corpo para o nome no cartão.
  - securityCodestringobrigatório
    Campo do corpo para o código de segurança.
  - expirationYearstringobrigatório
    Campo do corpo para o ano de validade.
  - expirationMonthstringobrigatório
    Campo do corpo para o mês de validade.
- methodstringobrigatório
  Sempre POST.
  Valores:POST
- headersobjectobrigatório
  Cabeçalhos a enviar como estão (só o tipo de conteúdo — nenhuma credencial vai à página).
- tokenFieldstringobrigatório
  O campo da resposta JSON que carrega o token.
- ttlSecondsintegerobrigatório
  Por quanto tempo um token emitido continua utilizável, em segundos (uso único).
acceptedBrandsstring[]obrigatório
Bandeiras que você aceita (visa, mastercard…) — para a página recusar uma bandeira antes de tokenizar.

400Requisição inválida (validação)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

404Não encontrado

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

422Regra de negócio impede o processamento

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

503Serviço indisponível

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorTabela pública de preços: os planos ativos de cada produto da Selectwin (sem autenticação)PróximaTokeniza um cartão digitado no navegador do comprador (devolve um token de uso único)