GET
/
api
/
v1
/
server-to-server-interface
/
transaction
/
status
/
{transactionId}
curl --request GET \
  --url https://api-dev.paymentoptions.com/api/v1/api/v1/server-to-server-interface/transaction/status/{transactionId} \
  --header 'Authorization: <api-key>' \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "status_code": 200,
  "is_live": false,
  "transaction_type": "CAPTURE",
  "gateway_response": {
    "version": "1",
    "type": "INFO",
    "message": "Payment Successful.",
    "code": "INFO0000"
  },
  "merchant_details": {
    "legal_name": "Tink15 Factory",
    "mid": "< Merchant ID >",
    "merchant_txn_ref": "qwe"
  },
  "payment_details": {
    "amount": 1000,
    "response_code": 0,
    "responseDescription": "取引は正常に完了しました。",
    "auth_code": "268004",
    "currency": "JPY",
    "payment_method": "ECMC-SSL",
    "scheme": "MASTERCARD",
    "card": {
      "name": "John Doe",
      "number": "5200000000001005",
      "exp_month": "12",
      "exp_year": "24"
    },
    "additional_data": {
      "payment_data_source": {
        "type": "card"
      }
    }
  },
  "transaction_details": {
    "id": "fc565b43-26f5-4906-92ae-d849edc3c3a1",
    "ref": 74811,
    "timestamp": "2024-11-25T08:24:36.000Z",
    "billing_details": {
      "billing_address": {
        "country": "JP",
        "email": "billing@testemail.com",
        "address1": "1-2-3 Shinjuku",
        "phone_number": "N/A",
        "city": "Shinjuku-ku",
        "state": "Tokyo",
        "postal_code": "1600022"
      },
      "shipping_address": {
        "country": "JP",
        "email": "shipping@testemail.com",
        "address1": "1-2-3 Shinjuku",
        "phone_number": "N/A",
        "city": "Shinjuku-ku",
        "state": "Tokyo",
        "postal_code": "1600022"
      }
    }
  },
  "risk_details": {
    "risk_score": null
  }
}

重要なポイント

  • 取引IDは、特定の取引のステータスを問い合わせるために必要です。

  • APIは、取引の現在のステータスと関連するエラーコードやメッセージを含む詳細情報を返します。

  • このAPIは、取引ライフサイクルの追跡と管理に不可欠で、取引が正常に完了したことを確認するか、対応が必要な問題を特定します。

APIパラメータ

Authorizations

Authorization
string
header
required

認証のためのAPIキー。形式:'Basic YOUR_API_KEY_HERE'

x-api-key
string
header
required

x-api-key専用のAPIキー。

Path Parameters

transactionId
string
required

事前承認(Pre-Auth)、キャプチャ(Capture)、払い戻し(Refund)、または無効(Void)取引の元の取引ID。

Maximum length: 36

Response

200 - application/json
取引ステータスが正常に取得されました
success
boolean

取引が成功した場合はtrue、失敗した場合はfalse。

Example:

true

status_code
integer

取引のステータスコード。

Example:

200

is_live
boolean

本番取引の場合はtrue、テスト取引の場合はfalse。

Example:

false

transaction_type
string

取引タイプ(例:PRE_AUTH、CAPTURE)。

Example:

"CAPTURE"

gateway_response
object

ゲートウェイからの応答を含むJSONオブジェクト。

merchant_details
object

加盟店の詳細を含むJSONオブジェクト。

payment_details
object

取引の支払い詳細を含むJSONオブジェクト。

transaction_details
object

取引の詳細を含むJSONオブジェクト。

risk_details
object

リスクの詳細を含むJSONオブジェクト。