GMO |クレジット|取引登録


概要

GMO に請求情報を登録する API です。

必ず請求情報の登録 → 決済実行の手順をとります。

自社請求レコードと必ず同一情報になるようにします。

これ以降の決済取引で必要となる取引 ID と取引パスワードの発行を行い、取引を開始します。


資料

クレジット決済公式資料 44P


エンドポイント

メソッド URI Headers
POST {GmoApiUrl}/EntryTran Default

リクエストパラメーター

パラメーター名 必須 項目名 特記
version CHAR 3 バージョン パラメータバージョン
(予約項目のため、省略してください。)
shopID CHAR 13 サイト ID GMO が発行する値を設定します。
shopPass CHAR 10 サイトパスワード GMO が発行する値を設定します。
orderID CHAR 27 オーダー ID 加盟店様が取引を識別するための値を設定します。
jobCd CHAR - 処理区分 CAPTURE:即時売上
amount NUMBER 7 利用金額 利用金額(日本円)を設定します。
{
    "shopID"  :"tshop11223344",
    "shopPass":"9xxyifua",
    "orderID" :"ORDER0000001",
    "jobCd"   :"CAPTURE",
    "amount"  :"1000"
}

レスポンス

正常時

ステータスコード:200

パラメーター名 項目名 特記
orderID CHAR 27 オーダー ID 書いてないけど設定したやつ返ってくるっぽい
accessID CHAR 32 取引 ID 発行した ID を返却します。
accessPass CHAR 32 取引パスワード 発行したパスワードを返却します。
{
    "orderID"   :"ORDER0000001",
    "accessID"  :"a6a6b0061347e90cdef806b39bd28705",
    "accessPass":"5e0e54b892e14ed03e8cf807a6053813"
}

{warning} このレスポンスは決済実行時に必ず必要となるため保存必須

失敗時

ステータスコード:不明

パラメーター名 項目名 特記
ErrCode CHAR 3 エラーコード エラー発生時のみ
複数ある場合は"|"で接続された文字列
ErrInfo CHAR 9 エラー詳細コード エラー発生時のみ
複数ある場合は"|"で接続された文字列

・エラー時(複数エラーがある場合は下記のような形式にて出力されます。ErrCode の n 番目と ErrInfo の n 番目は対となります)

[
  {
    "errCode":"E01",
    "errInfo":"E01010001"
  },
  {
    "errCode":"E01",
    "errInfo":"E01020001"
  },
]