Visão Geral
Este guia irá orientá-lo na criação de sua primeira transação de on-ramp cripto usando a API KillB. Você aprenderá como:
- Configurar autenticação
- Criar um usuário
- Criar uma conta de carteira cripto
- Obter uma cotação
- Executar uma transação ramp
Este início rápido usa o ambiente Sandbox para testes. Nenhum dinheiro real será transferido.
Pré-requisitos
Antes de começar, certifique-se de ter:
Cadastre-se na KillB e obtenha:
- Email e senha para autenticação
Você pode obtê-los no seu Dashboard KillB. Ambiente de Desenvolvimento
- Um terminal ou interface de linha de comando
- cURL, Postman, ou seu cliente API preferido
- Conhecimento básico de APIs REST e JSON
Passo 1: Autenticação
Primeiro, obtenha um token de acesso fazendo login com suas credenciais:
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/auth/login \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"password": "sua-senha"
}'
{
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expiresIn": 3600000,
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
Salve o accessToken - você precisará dele para todas as requisições subsequentes. O token expira após 1 hora (3600000 ms).
Passo 2: Criar um Usuário
Crie um perfil de usuário com informações KYC:
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/users \
--header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"type": "PERSON",
"externalId": "usuario-12345",
"data": {
"firstName": "João",
"lastName": "Silva",
"email": "[email protected]",
"phone": "+5511987654321",
"dateOfBirth": "1990-01-01",
"address": {
"street1": "Rua Principal 123",
"city": "São Paulo",
"state": "SP",
"zipCode": "01310-100",
"countryCode": "BR"
},
"document": {
"type": "CPF",
"number": "12345678901",
"issuedCountryCode": "BR"
}
}
}'
Passo 3: Criar uma Conta de Carteira
Adicione uma carteira de destino onde a cripto será enviada:
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/accounts \
--header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"type": "WALLET",
"userId": "4d23aa52-1b40-4584-a8ea-58aba6099c5c",
"externalId": "carteira-12345",
"data": {
"firstName": "João",
"lastName": "Silva",
"email": "[email protected]",
"phone": "+5511987654321",
"currency": "USDC",
"network": "POLYGON",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"countryCode": "BR",
"document": {
"type": "CPF",
"number": "12345678901",
"issuedCountryCode": "BR"
}
}
}'
Passo 4: Obter uma Cotação
Solicite uma cotação de preço para sua conversão:
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/quotations \
--header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"fromCurrency": "COP",
"toCurrency": "USDC",
"amount": 100000,
"amountIsToCurrency": false,
"cashInMethod": "PSE",
"cashOutMethod": "POLYGON"
}'
As cotações expiram após 30 segundos. Você deve criar o ramp antes da expiração.
Passo 5: Criar um Ramp
Execute a transação usando a cotação:
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/ramps \
--header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"quotationId": "quot-9f8e7d6c-5b4a-3c2d-1e0f",
"userId": "4d23aa52-1b40-4584-a8ea-58aba6099c5c",
"accountId": "7c8b9a3d-2f1e-4b5c-9d8e-1a2b3c4d5e6f"
}'
Sucesso! Seu primeiro ramp está criado. O usuário agora pode pagar via a URL de pagamento PSE.
Próximos Passos
