Documentação da API

Integre a Selectwin do seu jeito.

Guias por recurso, a referência completa da API, SDKs e webhooks. Uma API REST em JSON, com sandbox e produção na mesma URL.

Quickstart Referência da API Webhooks

IntroduçãoA Selectwin API foi desenvolvida seguindo os melhores padrões REST, proporcionando uma integração simples e eficiente para qualquer aplicação.AutenticaçãoA API Selectwin autentica cada requisição por uma chave de API (API Key) enviada no cabeçalho.QuickstartSua primeira cobrança em poucos minutos. Você vai: autenticar, criar uma transação PIX, e receber a confirmação por webhook.ConvençõesEsta página reúne as convenções transversais que valem para todos os recursos da API Selectwin. Conhecê-las evita os erros de integração mais comuns.

Primeira chamada

Uma requisição, uma resposta em JSON.

Toda chamada leva a sua chave no header SelectKey. Com a chave de sandbox, nada é cobrado de verdade.

POST/v1/customers

Ver parâmetros e respostas na referência

Requisição

curl -X POST "https://api.selectwin.io/v1/customers" \
  -H "SelectKey: $SELECTWIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "buyer@example.com",
  "gender": "male",
  "document": {
    "type": "cpf",
    "number": "12345678909"
  },
  "lastName": "Silva",
  "metadata": {},
  "birthdate": "1990-05-20",
  "firstName": "João",
  "telephone": {
    "line": "5511987654321",
    "number": "987654321",
    "areaCode": "11",
    "countryCode": "55"
  },
  "additionalEmails": [
    "buyer@example.com"
  ],
  "externalReference": "string"
}'