定期課金: 課金List

このリクエストでは、アプリトークン・シークレット・店舗ID・定期課金IDを指定することで、特定の定期課金で行われた課金の一覧情報を取得することができます。parameterで絞り込みも可能です。
課金のデータモデルの詳細は課金オブジェクトを参照してください。

Request

GET https://api.gyro-n.money/stores/{storeId}/subscriptions/{subscriptionId}/charges

Parameters:

Parameters
last_fournumber
使用したクレジットカードの下4桁でフィルタリングする。 指定する場合は、name, exp_month, exp_year パラメータも含める必要があります
namestring
カード所有者の名前でフィルタリングする。 指定する場合は、last_four, exp_month, exp_year パラメータも含める必要があります
exp_monthnumber
使用したカードの有効期限(月)でフィルタリングする。指定する場合は、 last_four, name, exp_year パラメータも含める必要があります
exp_yearnumber
使用したカードの有効期限(年)でフィルタリングする。指定する場合は、last_four, name, exp_month パラメータも含める必要があります
card_numbernumber
クレジットカード番号でフィルタリングする
fromstring (ISO-8601)
この日付以降に作成された課金を表示する
tostring (ISO-8601)
この日付より前に作成された課金を表示する
emailstring
メールアドレスでフィルタリングする
phonestring
電話番号でフィルタリングする
amount_fromnumber
この金額より大きい課金を表示する
amount_tonumber
この金額未満の課金を表示する
currencystring (ISO-4217)
この通貨でリクエストまたはチャージされた課金をフィルタリングする
modestring
モードでフィルタリングする。 live または test
metadatastring
メタデータでフィルタリングする
transaction_token_idstring (UUID)
トランザクショントークンIDでフィルタリングする

Headers:

Authorization: Bearer {secret}.{jwt}

Body:

curl --request GET \
--url https://api.gyro-n.money/stores/23f45c5e-18ef-11e7-96ee-d756c0178178/subscriptions/25d0fb2c-18ef-11e7-9dd3-db8fb7b820e7/charges \
--header 'Authorization: Bearer {secret}.{jwt}'

Response

Code: 200

Headers:

Content-Type: application/json

Body:

{
  "items": [
    {
      "id": "26f9059e-18ef-11e7-a74f-173cf0f9475a",
      "store_id": "23f45c5e-18ef-11e7-96ee-d756c0178178",
      "transaction_token_id": "259e9240-18ef-11e7-94da-97e85c2e269c",
      "requested_amount": 483200,
      "requested_currency": "EUR",
      "requested_amount_formatted": 4832,
      "charged_amount": 483200,
      "charged_currency": "EUR",
      "charged_amount_formatted": 4832,
      "status": "successful",
      "error": null,
      "metadata": {},
      "mode": "test",
      "created_on": "2018-07-13T02:55:00.07367Z"
    },
    {
      "id": "270858e6-18ef-11e7-adfa-6ff75ea1c202",
      "store_id": "23f45c5e-18ef-11e7-96ee-d756c0178178",
      "transaction_token_id": "259f4a8c-18ef-11e7-b8fe-17e053dc5c54",
      "requested_amount": 2491,
      "requested_currency": "JPY",
      "requested_amount_formatted": 2491,
      "charged_amount": 2491,
      "charged_currency": "JPY",
      "charged_amount_formatted": 2491,
      "status": "successful",
      "error": null,
      "metadata": {},
      "mode": "test",
      "created_on": "2018-07-13T02:55:00.07367Z"
    }
  ],
  "has_more": false
}