الطلبات / API v1
شراء بطاقة
/api/partner/v1/ordersCreates exactly one card order. partnerReference is the case-sensitive idempotency identity; replay the same body after an ambiguous transport outcome. This operation does not accept or require an Idempotency-Key header. Price is resolved again in the server transaction before charge.
Authorization: Bearer <PARTNER_API_KEY>
احفظ partnerReference وsku قبل الإرسال. إعادة الإرسال بمرجع جديد قد تنشئ عملية شراء أخرى.
اقرأ دليل إعادة المحاولةمحتوى الطلب application/json
partnerReferencestringمطلوبCase-sensitive purchase idempotency identity.
min length: 1 · max length: 100
^[A-Za-z0-9._:-]+$skustringمطلوبmin length: 1 · max length: 100
الاستجابة
New order or exact replay of the original order.
Cache-Control no-store
dataobjectمطلوبعرض الحقول
orderobjectمطلوبعرض الحقول
orderobjectمطلوبعرض الحقول
orderIdstringمطلوبuuid
partnerReferencestringمطلوبstatusstringمطلوب"PROCESSING" · "COMPLETED" · "FAILED"
totalMinorintegerمطلوبint64 · min: 1 · max: 9007199254740991
currencystringمطلوب"SAR"
skustringمطلوبproductNameArstringمطلوبproductNameEnstringمطلوبchargedPriceMinorintegerمطلوبint64 · min: 1 · max: 9007199254740991
chargedCurrencystringمطلوب"SAR"
faceValuestring | nullمطلوبFrozen original provider denomination when supplied, not the charged SAR price. SKU-only OneCard orders may return null.
faceValueCurrencystring | nullمطلوبPaired with faceValue; both fields are null when denomination metadata is unavailable.
min length: 3 · max length: 3
supportReferencestring | nullمطلوبpollAfterSecondsinteger | nullمطلوبAlways non-null while status is PROCESSING, including manual review.
min: 1
createdAtstringمطلوبdate-time
updatedAtstringمطلوبdate-time
completedAtstring | nullمطلوبdate-time
howToUseArstringمطلوبhowToUseEnstringمطلوبcredentialsobject | nullمطلوبNull until fulfillment completes; populated credentials match OrderCredentials.
عرض الحقول
serialstring | nullمطلوبpinstring | nullمطلوبusernamestring | nullمطلوب
replayedbooleanمطلوب
requestIdstringمطلوبerrorobject | nullمطلوبnull