トランザクション一覧取得

GEThttps://api.omise.co/transactions

アカウントに属するトランザクションのページ分割されたリストを返します。トランザクションは、アカウントと決済ソースまたは振込先との間の資金移動を表します。

---

リクエストパラメータ

推奨 - 5項目推奨パラメータ

▼

`from`STRING(optional)

ISO 8601形式で返されるレコードの最も古いUTC日時。この日付以降に作成されたトランザクションをフィルタリングする場合に使用します。

Example:"2025-01-01T00:00:00Z"

Default:"1970-01-01T00:00:00Z"

`to`STRING(optional)

ISO 8601形式で返されるレコードの最新のUTC日時。この日付より前に作成されたトランザクションをフィルタリングする場合に使用します。

Example:"2025-12-31T23:59:59Z"

`limit`INTEGER(optional)

1ページあたりに返すレコード数。レスポンスサイズとパフォーマンスの制御に役立ちます。

Example:20

Constraints:最小値: 1, 最大値: 100

Default:20

`offset`INTEGER(optional)

結果を返す前にスキップするレコード数。ページネーションのためにlimitと組み合わせて使用します。

Example:0

Default:0

`order`STRING(optional)

作成日時に基づく結果のソート順。

Example:"chronological"

Values:chronological, reverse_chronological

Default:"chronological"

---

レスポンス

200

リクエスト成功

data配列にトランザクションデータを含むリストオブジェクトを返します。

レスポンス構造：

• object - 文字列値 "list"
• data - トランザクションオブジェクトの配列
• limit - 1ページあたりのレコード数
• offset - 現在のオフセット
• total - トランザクションの総数
• location - APIエンドポイントのパス

各トランザクションオブジェクトに含まれる項目：

• id - トランザクション識別子（例：trxn_test_5fzo4nqrnop03djdde1）
• amount - 通貨の最小単位でのトランザクション金額
• currency - 3文字のISO 4217通貨コード
• direction - 資金の方向（creditまたはdebit）
• key - トランザクションをトリガーした関連オブジェクト
• origin - トランザクションの元のソース
• transferable_at - 資金が振込可能になる日付
• created_at - トランザクション作成日時

401

認証エラー

認証に失敗しました。APIキーが無効または欠落しています。

一般的な原因：

• Authorizationヘッダーの欠落
• 無効なシークレットキー
• シークレットキーの代わりにパブリックキーを使用
• HTTP Basic Auth形式の誤り

5xx

サーバーエラー

サーバー側でエラーが発生しました。まれにしか発生しませんが、適切に処理する必要があります。

対処方法：

• 指数バックオフでリクエストを再試行
• status.omise.coでサービス障害情報を確認
• 詳細なガイダンスはエラーハンドリングを参照

---

コードサンプル

cURL

curl https://api.omise.co/transactions \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transactions = Omise::Transaction.list

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transactions = omise.Transaction.retrieve()

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const transactions = await omise.transactions.list();

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$transactions = OmiseTransaction::retrieve();

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

ScopedList<Transaction> transactions = client.transactions().list();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transactions = await client.Transactions.List();

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

transactions, _ := client.Transactions().List(&operations.ListTransactions{
    Limit: 20,
})

---

🔑API認証情報

▼

試してみる

推奨 - 5項目

▼

あなたのIP: ...読み込み中...