GMO ｜クレジット｜金額変更

概要

GMO の登録した請求情報の金額を変更する API です。

決済が完了した取引に対して決済金額の変更を行います。

内部的に、決済変更の取消／返品と再オーソリを実施した結果を返します。

そのため、金額変更を実施した場合は取引履歴には取消／返品と再オーソリの 2 件が作成されます。

尚、取消／返品または再オーソリ時にエラーが発生した場合は、処理前の取引状態に戻ります。

その際、取引履歴には取消／返品または再オーソリの 1 件が作成されます。

資料

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

エンドポイント

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

リクエストパラメーター

パラメーター名 必須 型 桁 項目名 特記
version CHAR 3 バージョン パラメータバージョン
(予約項目のため、省略してください。)
shopID 〇 CHAR 13 ショップ ID 弊社が発行する値を設定します。
shopPass 〇 CHAR 8 ショップパスワード 弊社が発行する値を設定します。
accessID 〇 CHAR 32 取引 ID 【取引登録】で発行された値を設定します。
accessPass 〇 CHAR 32 取引パスワード 【取引登録】で発行された値を設定します。
jobCd 〇 CHAR - 処理区分 以下を設定します。SAUTH：簡易オーソリ
amount 〇 NUMBER 7 利用金額 再オーソリの場合：処理区分が『有効性チェック』を除き、必須です。

※　再オーソリの場合、指定可能になります。

{
    "shopID"      : "tshop99887902",
    "shopPass"    : "7ry53fqm",
    "accessID"    : "4cfffa3f3ef6e90692dbc204e09b351b",
    "accessPass"  : "c07822acefba90d95417ae37beb198de",
    "jobCd"       : "AUTH",
    "amount"      : "50000",
}

レスポンス

正常時

ステータスコード：200

パラメーター名 型 桁 項目名 特記
accessID CHAR 32 取引 ID 【決済変更】呼出時に指定した値を返却します。
accessPass CHAR 32 取引パスワード 【決済変更】呼出時に指定した値を返却します。
forward CHAR 7 仕向先コード 与信を行ったカード会社の会社コードを返却します。
approve CHAR 7 承認番号 カード会社が発行した与信の承認番号を返却します。
tranID CHAR 28 トランザクション ID 弊社が処理を行う毎に発行している取引の処理番号を返却します。
tranDate CHAR 14 決済日付 決済を実施した日付(日本時間) を返却します。(yyyyMMddHHmmss 形式) 
{
    "accessID"       : "TEST-20190628-115812",
    "accessPass"     : "2b55195",
    "forward"        : "1",
    "approve"        : "3",
    "approve"        : "1234567",
    "tranID"         : "1917900745",
    "tranDate"       : "20190628120831",
}
失敗時

ステータスコード：不明

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

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

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