foxworth
المزاياالبطاقاتالخطواتالإنفاقAPIالمدونةالأسئلةتسجيل الدخولاحصل على بطاقة

المطورون · REST API v1

أصدر البطاقات من كودك

أنشئ بطاقات Visa وMastercard الافتراضية وموّلها وجمّدها وأغلقها عبر HTTPS. الطلبات JSON، تُوثَّق بمفتاح سري، وتُخصم من نفس رصيد USDT الذي تعبّئه بالكريبتو.

عنوان الأساس: https://foxworthcommercialcapital.com/api/v1المصادقة: Bearer sk_live_…الصيغة: JSONWebhooks: HMAC-SHA256

مقدمة

الـAPI يفعل ما تفعله اللوحة، من خادمك. كل بطاقة تصدرها وكل تعبئة تجريها تُدفع من رصيد حسابك، الذي تعبّئه بإيداعات الكريبتو ويُحتفظ به دائمًا بـUSDT.

المبالغ بالدولار الأمريكي بمنزلتين عشريتين. الأوقات ISO 8601 بتوقيت UTC. نقاط القوائم مقسّمة بصفحات عبر page وper_page.

تُفعَّل نقاط نهاية البطاقات مع إصدار البطاقات بمجرد إضافة رصيد لبطاقتك. نقاط نهاية رصيد المحفظة وقائمة BIN تعمل الآن.

المصادقة

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.

الأخطاء

200نجح الطلب
201تم إنشاء المورد
400معلمات طلب غير صالحة
401مفتاح API مفقود أو غير صالح
403المفتاح صالح، لكن وصول API غير مفعّل لهذا الحساب بعد
404المورد غير موجود
429تم تجاوز حد المعدل

حدود المعدل

الطلبات / الدقيقة1000
إنشاء البطاقات / الدقيقة50
الطلبات / الساعة10000

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

البطاقات

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

POST/cardsIssue a new virtual cardقريبًا
GET/cardsList cardsقريبًا
GET/cards/{card_id}Retrieve a cardقريبًا
GET/cards/{card_id}/detailsReveal number, expiry and CVVقريبًا
POST/cards/{card_id}/freezeFreeze a cardقريبًا
POST/cards/{card_id}/unfreezeUnfreeze a cardقريبًا
DEL/cards/{card_id}Close a cardقريبًا

التمويل

POST/cards/{card_id}/fundLoad a card from your balanceقريبًا
POST/cards/{card_id}/withdrawUnload a card back to your balanceقريبًا

العمليات

GET/transactionsList card transactionsقريبًا

المحفظة

أول استدعاء

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 endpointقريبًا
أصدر البطاقات من كودك | Foxworth Commercial Capital