/api/v1/ordersPublished contract, not openإنشاء أمر
يقفل السعر ويُرجع عنوان إيداع مخصص. يحمل الأمر التفصيل كما هو مقفل: إنه قابل لإعادة التشغيل، مما يتيح لك إعادة بناء السعر الدقيق المطبق حتى بعد أشهر. رأس Idempotency-Key مطلوب.
المصادقة: Authorization: Bearer … انظر المصادقة
المعلمات
| الحقل | النوع | الوصف |
|---|---|---|
quoteIdمطلوب | string | معرّف الاقتباس المقبول. |
beneficiaryمطلوب | object | الحقول التي يفرضها مخطط القناة. يجب أن يتطابق الاسم مع الهوية الموثقة: لا دفعات لأطراف ثالثة. |
networkIdمطلوب | string | الشبكة التي سيتم إرسال الإيداع عليها. تحدد العنوان الذي تم إرجاعه، وعلى بعض الشبكات، المذكرة الإلزامية. |
curl -sS -X POST https://fiatside.com/api/v1/orders \
-H 'Authorization: Bearer sk_live_...' \
-H 'Idempotency-Key: 7f3a1c92-5d0e-4a1b-9c2f-6b8e0d4a1f33' \
-H 'Content-Type: application/json' \
-d '{
"quoteId": "qt_01J9Z...",
"networkId": "tron",
"beneficiary": {
"railId": "sepa_instant",
"beneficiaryName": "Camille Dupont",
"iban": "FR7630001007941234567890185"
}
}'{
"reference": "K7Q4-M2XB",
"state": "AWAITING_DEPOSIT",
"deposit": {
"asset": "USDT",
"network": "tron",
"address": "T...",
"memo": null,
"amountBase": "1000000000",
"expiresAt": "2026-09-02T12:41:00Z"
},
"payout": { "railId": "sepa_instant", "netMinor": 91228, "currency": "EUR" },
"rateLock": { "midRate": "0.92168430", "lockedUntil": "2026-09-02T12:41:00Z" }
}- المذكرة تكون فارغة على معظم الشبكات وإلزامية على XRP و Stellar و TON. حذفها هناك يفقد الأموال: تعامل مع الحقل كإلزامي بمجرد أن يكون غير فارغ.
الأخطاء المحتملة: unauthorized, invalid_request, quote_expired, idempotency_conflict, beneficiary_rejected, country_not_served. الفهرس الكامل