تخطَّ إلى المستندات
API

حفظ بيانات الفوترة لدفعة

الاسم والعنوان المفوتران، ويُحتفظ بهما للدفعات اللاحقة أيضًا.

PUT/billing/invoices/{orderId}/details

ينفّذ أيًّا من الاستدعاءات الـ2 على مساحة عملك.

PUT /billing/invoices/{orderId}/details

الاسم والعنوان المفوتران، ويُحتفظ بهما للدفعات اللاحقة أيضًا.

مثال

يتطلب billing:write. هو مربع حوار عنوان الفوترة. country رمز من حرفين، أحد الرموز التي يسردها GET /billing/countries، وفي الولايات المتحدة وكندا يكون state رمزها المكوّن من حرفين. ويكون invoice هو ready إذا كانت للدفعة فاتورة بالفعل، وstarted إذا كانت تُكتب، وrefused مع السبب في message.

curl
curl -X PUT "$OE/billing/invoices/8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38/details" -H "$AUTH" \  -H 'content-type: application/json' \  -d '{ "name": "Acme Ltd", "line1": "1 Market Street", "city": "London", "postalCode": "EC1A 1AA", "country": "GB" }'
الاستجابة
{  "object": "invoice_details",  "orderId": "8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38",  "invoice": "started",  "message": null}

العنوان الذي يرفضه مزوّد الدفع يعيد 422 billing_address_rejected.

يحتاج رمز وصول OAuth إلى رمز تحقق لهذا الاستدعاء. وإلى أن يتحقق التطبيق من رمز خلال آخر 60 دقيقة، يردّ الاستدعاء بـ 403 step_up_required ولا يغيّر شيئًا. ولا يُطلب ذلك من مفتاح API أبدًا. وتبيّن صفحة المصادقة كيف تطلب رمزًا وتتحقق منه.

المرجع