foxworth
FonctionnalitésCartesProcessusDépensesAPIBlogFAQConnexionObtenir une carte

Développeurs · REST API v1

Émettez des cartes depuis votre code

Créez, alimentez, gelez et fermez des cartes Visa et Mastercard virtuelles via HTTPS. Les requêtes sont en JSON, authentifiées par une clé secrète, et utilisent le même solde USDT que vous rechargez en crypto.

URL de base: https://foxworthcommercialcapital.com/api/v1Authentification: Bearer sk_live_…Format: JSONWebhooks: HMAC-SHA256

Introduction

L'API fait ce que fait le tableau de bord, depuis votre serveur. Chaque carte émise et chaque chargement sont payés depuis le solde de votre compte, que vous financez par dépôts crypto et qui est toujours détenu en USDT.

Les montants sont en dollars avec deux décimales. Les horodatages sont ISO 8601 en UTC. Les listes sont paginées avec page et per_page.

Les endpoints cartes s'activent avec l'émission dès que votre carte est alimentée. Les endpoints de solde et de liste BIN sont déjà actifs.

Authentification

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.

Erreurs

200Requête réussie
201Ressource créée
400Paramètres invalides
401Clé API absente ou invalide
403La clé est valide, mais l'accès API n'est pas encore activé
404Ressource introuvable
429Limite de requêtes dépassée

Limites de requêtes

Requêtes / minute1 000
Créations de carte / minute50
Requêtes / heure10 000

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

Cartes

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

POST/cardsIssue a new virtual cardBientôt disponible
GET/cardsList cardsBientôt disponible
GET/cards/{card_id}Retrieve a cardBientôt disponible
GET/cards/{card_id}/detailsReveal number, expiry and CVVBientôt disponible
POST/cards/{card_id}/freezeFreeze a cardBientôt disponible
POST/cards/{card_id}/unfreezeUnfreeze a cardBientôt disponible
DEL/cards/{card_id}Close a cardBientôt disponible

Financement

POST/cards/{card_id}/fundLoad a card from your balanceBientôt disponible
POST/cards/{card_id}/withdrawUnload a card back to your balanceBientôt disponible

Transactions

GET/transactionsList card transactionsBientôt disponible

Portefeuille

Premier appel

GET /wallet/balancecURL
curl https://foxworthcommercialcapital.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 endpointBientôt disponible
Émettez des cartes depuis votre code | Foxworth Commercial Capital