capitalfinancial
FuncionalidadesCartõesProcessoGastarAPIBlogFAQEntrarObter cartão

Developers · REST API v1

Emita cartões a partir do seu código

Crie, financie, congele e feche cartões Visa e Mastercard virtuais via HTTPS. Os pedidos são JSON, autenticados com uma chave secreta, e usam o mesmo saldo USDT que carrega com cripto.

URL base: https://capitalfinancialgroupinc.com/api/v1Autenticação: Bearer sk_live_…Formato: JSONWebhooks: HMAC-SHA256

Introdução

A API faz o que o painel faz, a partir do seu servidor. Cada cartão emitido e cada carregamento são pagos do saldo da conta, que financia com depósitos cripto e que é sempre mantido em USDT.

Os valores são em dólares com duas casas decimais. As datas são ISO 8601 em UTC. As listas são paginadas com page e per_page.

Os endpoints de cartões ativam-se com a emissão assim que carregar o seu cartão. Os endpoints de saldo e lista de BINs já estão ativos.

Autenticação

Send your secret key as a Bearer token in the Authorization header of every request. Keys start with sk_live_ and are generated in your dashboard under API access.

Headers
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
X-Idempotency-Key: 7c1e2f0a-retry-safe

A new key answers 403 until the account is ready. Confirm your email, make a first deposit, then ask support to enable API access for the account.

Erros

200Pedido bem-sucedido
201Recurso criado
400Parâmetros inválidos
401Chave API ausente ou inválida
403A chave é válida, mas o acesso à API ainda não está ativo
404Recurso não encontrado
429Limite de pedidos excedido

Limites de pedidos

Pedidos / minuto1.000
Criações de cartão / minuto50
Pedidos / hora10.000

Limits are counted per API key. Over a limit you get a 429— wait and retry with exponential backoff.

Cartões

Each card has its own balance, limits and lifecycle, so one campaign, client or subscription never touches another.

POST/cardsIssue a new virtual cardBrevemente
GET/cardsList cardsBrevemente
GET/cards/{card_id}Retrieve a cardBrevemente
GET/cards/{card_id}/detailsReveal number, expiry and CVVBrevemente
POST/cards/{card_id}/freezeFreeze a cardBrevemente
POST/cards/{card_id}/unfreezeUnfreeze a cardBrevemente
DEL/cards/{card_id}Close a cardBrevemente

Financiamento

POST/cards/{card_id}/fundLoad a card from your balanceBrevemente
POST/cards/{card_id}/withdrawUnload a card back to your balanceBrevemente

Transações

GET/transactionsList card transactionsBrevemente

Carteira

Primeira chamada

GET /wallet/balancecURL
curl https://capitalfinancialgroupinc.com/api/v1/wallet/balance \
  -H "Authorization: Bearer sk_live_..."
{
  "balance": 1312.50,
  "currency": "USDT",
  "pending_deposits": 500.00,
  "cards_active": 0,
  "cards_total_balance": 0.00
}
GET/wallet/balanceRead your USDT balance
GET/wallet/deposit-addressGet a deposit address

BINs

GET/binsList available BINs

Webhooks

Webhooks are signed with HMAC-SHA256. Verify the signature header against the raw request body before trusting an event. Card events activate when card issuing is enabled.

POST/webhooksRegister a webhook endpointBrevemente
Emita cartões a partir do seu código | Capital Financial Group