Cria um cartão

POST/v1/cards

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

Corpo da requisição

tokenstring
Token de cartão de uso único emitido no navegador do comprador por POST /v1/tokenization/tokens (válido por uma hora).
primaryboolean
Tornar este o cartão principal do cliente.
numberingstring
Número do cartão (PAN), só dígitos — espaços e traços são removidos. Tokenizado ao chegar, nunca guardado.
customerIdstringobrigatório
O cliente a quem o cartão pertence.
holderNamestring
Nome impresso no cartão (só no cartão inline).
securityCodestring
Código de segurança do cartão (CVV/CVC), 3 ou 4 dígitos.
expirationYearobject
Ano de validade, 4 dígitos — 2 dígitos são aceitos (só no cartão inline).
expirationMonthinteger
Mês de validade, 1 a 12 (só no cartão inline).

Respostas

201Criado

idstringobrigatório
Identificador público (card_…)
brandstringobrigatório
Bandeira do cartão (ex.: visa, mastercard).
validbooleanobrigatório
Se o cartão passou na validação.
_linksobject
Links para operações relacionadas, por ação (self, create, update, delete, list…).
activebooleanobrigatório
Se o cartão pode ser cobrado.
primarybooleanobrigatório
Se é o cartão principal do cliente.
merchantobject
A conta dona do recurso (o vendedor de registro).
+3 campos de merchant
- namestringobrigatóriopode ser nulo
  Nome fantasia da conta dona do recurso.
- merchantIdstringobrigatóriopode ser nulo
  Id público da conta dona do recurso (bus_…).
- isSubAccountbooleanobrigatório
  true quando o recurso pertence a uma sub-conta operada por uma plataforma de marketplace.
verifiedbooleanobrigatório
Se o cartão foi verificado com o emissor.
createdAtstringobrigatório
Quando o recurso foi criado (ISO 8601, UTC).
updatedAtstringobrigatório
Quando o recurso foi atualizado pela última vez (ISO 8601, UTC).
associatedbooleanobrigatóriopode ser nulo
Se o cartão está vinculado ao cliente para cobrança. null = pendente: o cartão entrou por uma tela do comprador e ainda não tem cobrança aprovada.
holderNamestringobrigatóriopode ser nulo
Nome impresso no cartão.
lastDigitsstringobrigatório
Quatro últimos dígitos do cartão.
firstDigitsstringobrigatório
Seis primeiros dígitos do cartão (BIN).
expirationYearstringobrigatório
Ano de validade (YYYY).
expirationMonthstringobrigatório
Mês de validade (MM).

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

409Conflito (idempotência ou estado)

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

AnteriorLista os cartões PróximaConsulta um cartão

curl -X POST "https://api.selectwin.io/v1/cards" \ -H "SelectKey: $SELECTWIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "token": "id_0a1b2c3d4e5f60718293", "primary": true, "numbering": "string", "customerId": "cus_0a1b2c3d4e5f60718293", "holderName": "JOAO SILVA", "securityCode": "id_0a1b2c3d4e5f60718293", "expirationYear": {}, "expirationMonth": 1 }'

{ "id": "card_0a1b2c3d4e5f60718293", "brand": "string", "valid": true, "_links": {}, "active": true, "primary": true, "merchant": { "name": "Acme Ltda", "merchantId": "string", "isSubAccount": true }, "verified": true, "createdAt": "string", "updatedAt": "string", "associated": true, "holderName": "JOAO SILVA", "lastDigits": "string", "firstDigits": "string", "expirationYear": "string", "expirationMonth": "string" }