イシュアトークン

イシュアトークンオブジェクト

イシュアトークンとは、オンライン決済事業者から提供された、ユーザーが決済を行うための情報です。各決済事業者での支払いURLなどが発行されます。
このルートは、支払い手段がonlineのトランザクショントークンを使用して課金を作成した後に、イシュアートークンを取得するために使用します。

支払手段が銀行振込(bank_transfer)の場合は、対象の振込先口座情報を取得することができます。

issuer_tokenが入力される前に、課金ステータスがawaitingになっている必要があります。
awaiting以外のステータスではこのリクエストはエラーになるため、課金:GETのリクエストで、事前に課金ステータスの確認を行う必要があります。

Fields
payment_typestring
指定した課金の支払い手段の種類。
 onlinebank_transferのいずれか
issuer_tokenstring
payment_typeonlineのとき
クライアントが実行するために支払いプロバイダーから提供されたトークン。
本番モードの場合各決済事業者での支払いURLが発行されます
payloadobject
payment_typeonlineのとき
POSTリクエストを送信するために必要なデータを含むオブジェクトを返却します。
call_methodstring
payment_typeonlineのとき
クライアントによる実行方法です。
http_get, http_post, sdk, web, appのいずれかです。
各ブランドで対応している方法で実行してください。(詳細はこちら

sdkは、ペイメントプロバイダーが提供するSDKで直接使用することを意味します。
webとは、特定のAPIを拡張した特殊なブラウザ環境で直接使用することを指します。
appとは、ペイメントプロバイダーが提供するSDKのネイティブアプリ環境での利用を指します。
http_getまたはhttp_postを使用すると、issuer_tokenを新しいブラウザウィンドウまたは適切な対応するHTTPメソッドのiframe内で直接実行することができます。
account_idstring
payment_typebank_transferのとき
接続先システムで発行している口座の独自ID
branch_codestring
payment_typebank_transferのとき
支店コード
branch_namestring
payment_typebank_transferのとき
支店名
account_holder_namestring
payment_typebank_transferのとき
口座名義
account_numberstring
payment_typebank_transferのとき
口座番号

Request

GET https://api.univapay.com/stores/{storeId}/charges/{chargeId}/issuer_token

Headers:

Content-Type: application/json
Authorization: Bearer {secret}.{jwt}

Response

Code: 200

Headers:

Content-Type: application/json

Body (online):

{
  "issuer_token": "http://test.com/action",
  "call_method": "http_post",
  "payload": { 
     "test_parameter": "test_value"
  }
  "payment_type": "online"
}

Body (bank transfer):

{
  "account_id": "test account id",
  "branch_code": "123",
  "branch_name": "test branch name",
  "account_holder_name": "test holder name",
  "account_number": "1234567",
  "payment_type": "bank_transfer"
}

d払いOnlineについて(リリース前のサービス)

d払いOnlineを利用する場合、取得したイシュアトークンのURLに対して、レスポンスのpayloadにあるbodyの要素を含み、POST方式で実行する必要があります。
Headerの Content-Typeapplication/x-www-form-urlencoded のみ受け付ける仕様です。

イシュアトークン取得のレスポンス例

{
    "issuer_token": "https://payment1.smt.docomo.ne.jp/smph/trade/s/gabepa11.srv",
    "call_method": "http_post",
    "payload": {
        "sSpcd": "00000000000",
        "sCptok": "11eefaef-e2d6-5e3c-3cj3-7f0a72dd9ba7%2Clive%2C9f132db784f807abe60a566634a9791fc979d9b0ed330d6314a6cfb29af39cae",
        "sTerkn": "01"
    },
    "payment_type": "online"
}

call_methodがhttp_postの場合の実行方法

レスポンスのデータを基にPOSTリクエストを送信する場合は、下記のようなHTMLフォームを設置することで実行できます。

<FORM METHOD="POST" ACTION="http://test.com/action">
  <INPUT TYPE="HIDDEN" NAME="test_parameter" VALUE="test_value">
</FORM>