Skip to main content

GET /1/savings

振込申請情報の一覧を取得

scope​

read_savings

リクエストパラメーター​

NameDescription
start_created振込申請日時はじめ yyyy-mm-dd (任意)
end_created振込申請日時おわり yyyy-mm-dd (任意)
limitリミット (任意 デフォルト: 20, MAX: 100)
offsetオフセット (任意 デフォルト: 0)

レスポンスの例​

{
  "savings":[
    {
      "saving_id":123,
      "bank_name":"りそな銀行",
      "branch_name":"赤坂支店",
      "account_type":"普通",
      "account_name":"ヤマダタロウ",
      "account_number":"1234567",
      "drawings":100000,
      "administrative_fee": 0,
      "bank_transfer_fee": 250,
      "early_transfer_fee": 0,
      "due_date":"2014-09-01",
      "status":"done",
      "created":1397549706
    },
    {
      "saving_id":223,
      "bank_name":"みずほ銀行",
      "branch_name":"渋谷支店",
      "account_type":"普通",
      "account_name":"ヤマダタロウ",
      "account_number":"1234567",
      "drawings":200000,
      "administrative_fee": 0,
      "bank_transfer_fee": 250,
      "early_transfer_fee": 0,
      "due_date":"2014-10-01",
      "status":"requested",
      "created":1398848221
    }
  ]
}

解説​

  • saving_id - 振込申請を識別するユニークなID
  • account_type - 口座種別。普通、当座、貯蓄
  • drawings - 振込申請額。
    • 実際の振込金額は、「振込申請額 - 事務手数料 - 振込手数料 - お急ぎ振込手数料」です。
    • 後述する administrative_fee 、 bank_transfer_fee 、 early_transfer_fee の値を参照してください。
  • administrative_fee - 事務手数料
  • bank_transfer_fee - 振込手数料
  • early_transfer_fee - お急ぎ振込手数料、お急ぎ振込サービスを利用した振込申請のみ所定の手数料が発生します。
  • due_date - 入金期日
  • status - requested:申請中、processing:処理中、done:完了、rejected:拒否、cancelled:キャンセル
  • created - 申請日時

エラーレスポンスの例​

{
  "error":"access_denied",
  "error_description":"httpsでアクセスしてください。"
}
{
  "error":"invalid_request",
  "error_description":"アクセストークンが無効です。"
}
{
  "error":"invalid_scope",
  "error_description":"スコープが無効です。"
}