ドキュメント本文へスキップ
API

請求の請求情報を保存する

請求先の名前と住所。以降の請求にも使われる。

PUT/billing/invoices/{orderId}/details

2件の呼び出しをワークスペースに対して実行します。

PUT /billing/invoices/{orderId}/details

請求先の名前と住所。以降の請求にも使われる。

例

billing:write が必要。「請求先住所」ダイアログにあたる。country は GET /billing/countries が一覧にする 2 文字のコードのいずれかで、米国とカナダでは state も 2 文字のコードにする。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 キーが求められることはありません。コードの求め方と確認方法は「認証」ページにあります。

リファレンス