印刷する

ストア

store > get_cart

この機能は以下の内容を返します。
・進行中の注文がない場合、ショッピングカートにある商品一覧。
・進行中の注文がある場合、その注文の商品一覧。
・合計（未払い額、使用済み/使用可能クレジット、進行中の注文で支払われた金額、など）

リクエストの構築

リクエストURLとGET変数

リクエスト固有のGET変数

リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。

POST変数

このリクエストにはPOST変数は必要ありません。

応答例

リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・data：ショッピングカートまたは進行中の注文データを含む配列。
配列には以下が含まれます。

• order_contains_subscription(int 0|1)：カート/注文にサブスクリプション商品が含まれているかどうか。
• order_contains_subscription_trial(int 0|1)：カート/注文に無料試用版付きのサブスクリプション商品が含まれているかどうか。

試用版：

• order_trial_requires_rp(int 0|1)：試用版に定期支払いが必要かどうか。（"order_contains_subscription_trial=1"の場合のみ適用）
  外部支払処理で定期支払いをサポートしていない場合は、カートから商品を削除する必要があります。
  それ以外の場合は、注文の処理後に定期支払いプロファイルを作成する必要があります。
• order_has_credit_product(int 0|1)：カート/注文にクレジット商品が含まれているかどうか。
  含まれている場合、クレジットは支払に使用されません。

• order_id(int)：注文ID（進行中の注文の場合）
• order_min_purchase_check(int 0|1)：カートが最小購入要件を満たしているかどうか。
• order_num_products(int)：カート内の商品の数量、注文数
• buyer_credit(decimal)：利用可能なユーザークレジット
• buyer_credit_formatted(string)：利用可能なユーザークレジットのフォーマット値
• order_amount_due(decimal)：支払う必要のある額、未払い額（進行中の注文の場合）
• order_amount_paid(decimal)：支払いが終わった額（進行中の注文の場合）
• order_credit_used(decimal)：カート/注文で商品を部分的な（または全額）支払に使用できるクレジットの額
• order_credit_used_formatted(string)："order_credit_used"値のフォーマット値
• order_subtotal(decimal)：クレジットを適用する前のカート/注文の合計
• order_subtotal_formatted(string)："order_subtotal"値のフォーマット値

注：支払いが終わった額(order_amount_paid) + 支払う必要のある額、未払い額(order_amount_due) + クレジット適用額(order_credit_used) = カート/注文の合計(order_subtotal)

• order_total(decimal)：カート/注文の合計
• order_total_formatted(string)："order_total"値のフォーマット値
• product_list(array)：カートまたは進行中の注文からの商品リスト

product_list
商品リストの配列には以下が含まれます。

• id(int)：商品ID。カートから商品を削除する為に使用するIDです。
• id_clip(int)：動画商品の場合は動画ID（番号>0）になります。
• id_channel(int)：チャンネル商品の場合はチャンネルID（番号>0）になります。
• id_type(int)：商品タイプのID
• type_name(string)：商品タイプの名前
  CREDIT(クレジット), 有効期限付アクセスパス(ENDDATE), 期間アクセスパス(PERIOD), サブスクリプション(SUBSCRIPTION), 無料試用版付きサブスクリプション(SUBSCRIPTIONTRIAL), サブスクリプション更新(SUBSCRIPTIONRENEWAL), 寄付(DONATION), サービス(SERVICE), 寄稿者メンバーシップ(MEMBERSHIPPERIODAUTHORING), 投稿者メンバーシップ(MEMBERSHIPPERIODCONTRIBUTING)
• ctype(int)：商品のコンテンツタイプ（-1=その他、0=サイト、1=チャンネル、2=動画、3=メンバーシップ）
• sku(string)：商品のSKU
• price(decimal)：商品単価
• price_formatted(string)：商品単価のフォーマット値
• price_after_trial(decimal)：無料試用期間の終了後の商品単価（"type_name=SUBSCRIPTIONTRIAL"の場合に適用）
• price_after_trial_formatted(string)："price_after_trial"値のフォーマット値
• quantity(int)：数量
• price_by_qty(decimal)："price"値と"Quantity"値の乗算値
• price_by_qty_formatted(string)："price_by_qty"値のフォーマット値
• title(string)：商品の名前
• description(string)：商品の説明文
• img_thumbnail, img_social, img_poster(string)：各コンテンツまたは商品の画像
• period_unit(string)：時間単位(DAY, WEEK, MONTH, YEAR)（"type_name=PERIOD"の場合）
• period_amount(int)：期間アクセスパスの単位数（"type_name=PERIOD"の場合）
• subs_period_unit(string)：請求の時間単位(DAY, WEEK, MONTH, YEAR)（"type_name=SUBSCRIPTION","type_name=SUBSCRIPTIONTRIAL","type_name=SUBSCRIPTIONRENEWAL"の場合）
• subs_period_amount(int)：請求期間の単位数、頻度（"type_name=SUBSCRIPTION","type_name=SUBSCRIPTIONTRIAL","type_name=SUBSCRIPTIONRENEWAL"の場合）

例）
・"period_unit=DAY,period_amount=3"の場合→3日間有効なアクセスパス
・"subs_period_unit=MONTH,subs_period_amount=3"の場合→3週間に一度更新されるサブスクリプション

試用版：

• trial_period_unit(string)：無料試用版の時間単位 (DAY, WEEK, MONTH, YEAR)（"type_name=SUBSCRIPTIONTRIAL"の場合）
• trial_period_amount(int)：無料試用版の単位数（"type_name=SUBSCRIPTIONTRIAL"の場合）
  含まれている場合、クレジットは支払に使用されません。
• trial_requires_rp(int)：無料試用期間を有効にするために定期支払いが必要かどうか。

リクエストにハッシュが指定されていない場合など、リクエストが失敗した場合のレスポンス

このリクエストは以下のエラーを返す可能性があります。

・REQUEST_ERROR | Invalid User ID
ユーザーIDが1未満かもしくは数値ではありません。

その他のエラー内容に関しては一般的なエラーメッセージを確認してください。

PHPサンプルコード

GETおよびPOSTデータを準備します。

salt, timestamp, signatureを生成してリクエストを送信します。