メインコンテンツまでスキップ

トランザクションの詳細（Broker）

この API は、Broker サービスから購入の詳細を提供します。order の UID を使用して、購入に関する詳細情報を取得できます。購入価格やその他の関連情報を取得するのに役立ちます。この API は認証を必要としません。

エンドポイント​

メソッドURL
GEThttps://api.catappult.io/broker/8.20250505/transactions/{uid}

認証​

認証は不要です。

パスパラメーター​

パラメーター型必須説明
uidstring必須order の UID。Aptoide Connect のチャネルでは UID として定義されています。

クエリパラメーター​

パラメーター型必須説明
hashstring任意トランザクションのハッシュ。Aptoide Connect および Wallet App では TxID として定義されています。
domainstring任意アプリケーションのパッケージ名。

レスポンス​

ステータス説明
200成功。トランザクションの詳細を返します。

成功（200）レスポンスのフィールド​

名前型説明
uidStringorder の UID。Aptoide Connect のチャネルでは UID として定義されています。
domainStringこの購入の発生元となったアプリケーションのパッケージ名。
productString購入された製品の SKU。
wallet_fromString購入に使用された Wallet アドレス。
typeString購入された製品のタイプ。
methodString購入に使用された方法。例：credit_card
countryStringISO-3166-1-A2 ガイドラインに準拠した国コード。例：US
referenceStringトランザクションの参照。
hashStringトランザクションのハッシュ。Aptoide Connect および Wallet App では TxID として定義されています。
statusStringトランザクションのステータス。
addedString追加日のタイムスタンプ。例：2025-01-14T11:06:31.231117Z
modifiedString変更日のタイムスタンプ。例：2025-01-14T11:06:31.231117Z
gatewayObject使用されたゲートウェイの情報を含むオブジェクト。
gateway.nameStringゲートウェイ名。例：adyen_v2
metadataObject購入のメタデータに関する情報を含むオブジェクト。
metadata.purchase_uidStringPurchase クラスで token として定義される購入 ID。
metadata.developer_payloadStringこの購入を開始する際に開発者が指定した文字列ベースのペイロード。
priceObject購入価格の情報を含むオブジェクト。
price.currencyString支払いに使用された通貨。ISO 4217 のアルファベットコード。例：USD
price.valueString支払いの価格値。例：1.12
price.appcStringAPPC 通貨での価格値。例：1120000
price.usdStringUSD 通貨での価格値。例：1.10
price.vatObjectVAT に関する情報を含むオブジェクト。
price.vat.percentageStringVAT のパーセンテージ。例：20.5
price.vat.valueStringVAT の値。例：4.45
price.vat.usdStringUSD での VAT の値。例：1.12
price.discountObject購入に適用された割引に関する情報を含むオブジェクト。
price.discount.percentageString割引のパーセンテージ。例：20.5
price.discount.valueString割引の値。例：4.45
price.discount.usdStringUSD での割引の値。例：1.12
channelString購入に使用されたチャネル。
platformString購入に使用されたプラットフォーム。
marketString購入が行われたマーケット。

レスポンスの例​

{
  "uid": "SEVD6MDBKR5XBZZU",
  "domain": "com.appcoins.diceroll.sdk",
  "product": "attempts",
  "wallet_from": "0x6e581078d392f98a53a8e9b0a10a35169c431a1e",
  "type": "INAPP",
  "method": "googlepay",
  "country": "PT",
  "reference": "",
  "hash": "0x85ad942ef12e6dea2e9a2eab9cddd0af64eba414309e448806d2f732132bca52",
  "status": "COMPLETED",
  "added": "2025-05-02T22:11:56+00:00",
  "modified": "2025-05-02T22:12:20+00:00",
  "gateway": {
    "name": "adyen_v2"
  },
  "metadata": {
    "purchase_uid": "catappult.inapp.purchase.AXVCN5PZPXNYKQ7J",
    "developer_payload": "dee8217d-8f5b-427c-872c-fa5bb32c2444"
  },
  "price": {
    "currency": "EUR",
    "value": "0.1",
    "appc": "11.3",
    "usd": "0.11",
    "vat": {
      "percentage": "23",
      "value": "0.02",
      "usd": "0.02"
    },
    "discount": {
      "percentage": "23",
      "value": "0.02",
      "usd": "0.02"
    }
  },
  "channel": "WEB",
  "platform": "ANDROID",
  "market": "NATIVE"
}

type​

値説明
INAPPinapp タイプの製品が Android Billing SDK 経由で購入されました。
INAPP_SUBSCRIPTIONsubscription タイプの製品が Android Billing SDK 経由で購入されました。
INAPP_UNMANAGEDinapp タイプの製品が OSP 経由で購入されました。

status​

値説明
PENDING_SERVICE_AUTHORIZATIONサービス承認待ちのトランザクション。
PENDING_USER_PAYMENTユーザーの支払い待ちのトランザクション。
PROCESSING処理中のトランザクション。
SETTLED決済済みのトランザクション。
COMPLETED完了したトランザクション。
CANCELEDキャンセルされたトランザクション。
DUPLICATED重複したトランザクション。
FAILED失敗したトランザクション。
CHARGEBACKチャージバックされたトランザクション。
REFUNDED返金されたトランザクション。

channel​

値説明
ANDROIDAndroid チャネルタイプが使用されました。
IOSiOS チャネルタイプが使用されました。

platform​

値説明
ANDROIDAndroid プラットフォームタイプが使用されました。
IOSiOS プラットフォームタイプが使用されました。

market​

値説明
NATIVEネイティブマーケットが使用されました。Android または iOS。
WEBWeb マーケットが使用されました。