本ガイドの内容

本ガイドは、(株)DGフィナンシャルテクノロジーが提供するVeriTrans4Gを利用するための専用ソフトウェアMDK（Merchant Development Kit）をインターネット店舗などに導入する開発者向けのガイドです。VeriTrans4G Alipay決済にて使用する電文のインターフェース詳細について記載しています。
VeriTrans4Gの詳細については、『開発ガイド』を参照して下さい。
尚、インターフェース詳細は、決済サービス毎に提供していますので、当該決済サービスの『インターフェース詳細』を参照して下さい。

共通

• 「設定」欄の内容は以下の通りです。

  要求電文 ...

  必須項目：○　　任意項目：△　　設定不可：×　　その他条件付：※、※n（条件は説明欄、または欄外に記入）

  応答電文 ...

  必ず返戻：○　　処理成功時のみ返戻：△　　返戻なし：×　　その他条件付：※

• orderId（取引ID）について

  店舗で任意に採番してください。申込処理毎に付ける必要があります。他の取引IDと重複しないよう採番してください。他決済サービスとも重複できません。
  また、テスト取引で使用した取引IDを、本番取引で再度使用することはできません。
  取引IDには、半角英数字以外に"-"（ハイフン）、"_"（アンダースコア）も使用可能です。

• 決済種別（payType）について

  Alipayの決済種別は、３つのパターンがあります。各決済種別について簡単に説明します。
  ※決済の流れについては、『概略システムフロー図』のAlipay決済をご参照ください。

  • オンライン決済　：　ECサイトで決済をするケースです。店舗様のECサイトからWebブラウザを介して、Alipay決済画面に遷移して決済する方式です。
  • バーコード決済（店舗スキャン型）　：　主に実店舗のレジで決済するケースです。消費者のアプリ上に表示されたバーコードを店舗様で読み取って決済する方式です。
  • バーコード決済（消費者スキャン型）　：　主に実店舗のレジで決済するケースです。このケースは、QRコードの発行の方法により2つ（動的型／静的型）に分けられます。

    動的型・・・

    取引ごとにQRコードを生成し、そのQRコードを店舗様が表示し、消費者アプリで読み取り決済する方式

    静的型・・・

    主に店舗ごとに固定のQRコードを生成し、そのQRコードを店舗様が表示し、取引ごとに消費者アプリで読み取り、金額入力を行い決済する方式

  決済種別ごとに利用可能な電文は以下のとおりです。

  電文名	オンライン決済	バーコード決済（店舗スキャン型）	バーコード決済（消費者スキャン型）
  			動的型	静的型
  与信同時売上(Authorize)	○	○	○	×
  返金(Refund)	○	○	○	○
  確認(Confirm)	×	△ ※Authorizeリクエスト時にresponseType=1を指定した場合にこのコマンドで結果を確認する。	×	×
  QRコード生成(CreateIdentityCode)	×	×	×	○

与信同時売上

結果

返金申込

返金が可能な期間は、支払い日から365日間となります。また、決済金額の残高が0円になるまで繰り返し実行できます。 なお、決済種別（オンライン／バーコード決済（店舗スキャン型）／バーコード決済（消費者スキャン型））によって、返金の扱いが異なりますのでご注意ください。

• オンライン決済では、返金申込みという扱いになります。翌日以降、返金自体が成功か失敗かの結果が得られます。通貨は、Authorize（与信同時売上方式）時に指定した通貨と同じものになります。
• バーコード決済（店舗スキャン型／消費者スキャン型）では、即時に返金が成功か失敗かの結果を得られます。

確認

バーコード決済（店舗スキャン型）の取引について確認コマンドを利用して決済ステータス確認を行うことができます。 オンライン決済およびバーコード決済（消費者スキャン型）の取引では使用できません。

使用例）

• 与信同時売上要求時のレスポンスタイプで「1：即時に現在のステータスのレスポンスを返却する」を指定し、応答電文の詳細結果コードで「YG12（消費者承認待ちです。）」を受信した場合
• 与信同時売上要求でリクエストタイムアウトし取引の決済ステータスを確認できなかった場合

確認要求電文においてもレスポンスタイプを指定することができ、決済ステータスを確定時に返却するか即時に返却するかを選択可能です。
確認要求で決済ステータスが確定した場合、成功時には「Y001」を失敗時には対応するエラーの詳細結果コードを、決済ステータスが未確定の場合には「YG12」を返却します。
コマンドは繰り返し使用することができます。既に決済ステータスが確定している取引に対する確認要求の場合、取引が成功していれば「Y002」を、失敗時は「YC08」を返却します。

※ 尚、決済ステータスが「YG12」のまま残っている取引は弊社の決済ステータス確定リカバリ処理にて、決済申込から一定時間が経過するとステータスの確定を行います。

QRコード生成

バーコード決済（消費者スキャン型）の取引についてQRコード（静的型）を事前に発行し、以下の流れで決済をします。

1. QRコード生成でQRコードを発行
2. 決済時、発行したQRコードを消費者に提示し、消費者がAlipayアプリよりスキャン
3. 消費者がAlipayアプリ上で金額を入力し、店員が金額を確認し、決済確定
4. 加盟店は結果通知、もしくは検索結果の内容より決済結果を取得

発行したQRコードは複数の取引でご利用頂くことが可能です。（上記、2.～4.を繰り返し実行可能です。）

※オンライン決済およびバーコード決済（店舗スキャン型）の取引では使用できません。

結果通知

結果通知は、オンライン決済とバーコード決済（消費者スキャン型）の場合に通知されます。（バーコード決済（店舗スキャン型）では通知されません。）

• オンライン決済の場合
  • 与信、返金が結果通知対象となります。
  • 与信時の結果通知は、決済サーバーがAlipay決済センターから決済請求に対する完了通知を受け取り、該当の取引が完了したと判断した後通常5分以内に店舗様へ通知されます。
  • 決済申込み要求後、Alipay決済画面で決済の確定が可能な時間は最大30分となります。そのため、申込から最大30分遅れて結果通知が送信される可能性があります。
    • Alipay決済画面に遷移すると、画面上でタイマーが動作しているのが確認できます。30分以内であれば、一度ブラウザを閉じたとしても、再度Alipayにアクセスして決済を確定できます。
  • 取引の翌日にAlipayから届く清算データと決済サーバーの取引データを比較し、差異が発生した場合は、訂正後の内容で再度通知が送られます。
    決済センターと弊社の取引ステータス整合性チェックを翌日に行っています。その際、何らかの原因により、稀に弊社側で成功として扱っていた取引が失敗しているといった不整合が発生する可能性があります。この場合には再度新しいステータスでの結果通知を店舗様へ送信します。
    この事象の発生は全加盟店様で年1件程度の頻度となっており、発生時には弊社のオペレーターより別途ご連絡をさせていただきます。
    もしもこの事象が発生した場合には、たとえば加盟店様では既に消費者様に商品の発送をしているなど、運用に支障が出る事も想定されますので、念のため考慮された運用をご検討ください。
  • 返金申込時の結果通知は、返金申込が失敗した場合のみ通知されます。 決済サーバーは、返金申込に対するAlipay決済センターからの失敗通知を受け取り、該当の取引が失敗したと判断した後通常5分以内に店舗様へ通知します。 Alipay決済センターでの返金処理は、返金申込を行った翌日以降となります。
• バーコード決済（消費者スキャン型）の場合
  • 結果通知は、決済サーバーがAlipay決済センターから完了通知を受け取り、該当の取引が完了したと判断した後に加盟店様へ通知されます。
  • 与信が結果通知対象となります。

下表に、電文項目の詳細を示します。
結果通知に関するサービス共通の仕様については、『開発ガイド』を併せてご参照ください。

注意事項

1. 一回の支払限度額は、中国元(CNY)換算で300,000元までとなります。
2. オンライン決済の場合、返金自体が成功か失敗かの結果が得られるのは、翌日以降となります。（バーコード決済の場合は、即時に成功か失敗の結果が得られます。）
   • Alipayの仕様上、返金結果の確定が遅れる場合があります。また、最長何日程度の遅れが発生するかの仕様は非公開となっております。
     これまでの発生件数は年に1～2回、3～4日程度の遅延を確認しております。 ※2018年5月現在
3. 与信同時売上金額を超えないかぎり、金額の一部のみ返金することも可能です。
4. Alipayオンライン決済のみマルチ通貨に対応しています。Authorize（与信同時売上方式）時に、決済金額を日本円、または中国元で設定できます。また、Refund（返金）における通貨は、Authorize（与信同時売上方式）時に指定した通貨と同じものになります。返金時の為替レートは、購入時のレートが適用されます。
   ただし、「清算金額」と「清算通貨」については、JPY（日本円）で返却いたします。CNY（中国元）では返却しないため、消費者への中国元での請求については、消費者自身でAlipay側のサイトで確認する必要があります。
   また、為替レートを事前に取得する仕組みが提供されていないため、決済金額を日本円で指定した場合、中国元の金額はAlipayのサイトにリダイレクトした後に分かります。

Alipayバーコード決済（店舗スキャン型）決済要求の応答時間について

Alipayバーコード決済（店舗スキャン型）では、Alipay社側で消費者の利用状況をチェックしており、Alipay社で再認証が必要であると判断した場合に消費者のアプリで認証を促す仕様になります。
消費者認証処理が発生すると決済処理が完了するまでに時間がかかることがございます。
弊社では、加盟店様（店舗様）に決済待ち時間（秒）を設定していただくことで決済処理期限をコントロールする機能を設けております。決済待ち時間の初期設定値は45秒となっており、15 - 200秒で設定可能です。（「決済待ち時間」は、MAP（Merchant Administration Portal）から変更可能です。）

例えば、決済処理にて長時間待つことが難しい加盟店様ではこの値を短めに設定するなどして運用を行ってください。
この期限を超えた場合には、弊社からAlipay社へ取引を無効にする要求を行うため、取引自体が無効になり結果応答は「失敗」となります。
例えば、期限を90秒に設定された場合には、この期限まで認証の状況を確認します。もし、この時間まで認証されなかった場合には取引が無効になります。

※弊社では、「決済待ち時間」後に取引無効の要求を行うため、「決済待ち時間」＋数秒～十数秒程度をMDKのタイムアウト値として設定してください。

下記では、与信同時売上要求時のレスポンスタイプの指定別で決済の流れを図示します。

レスポンスタイプ　「0：取引確定時にレスポンスを返却する」

レスポンスタイプ　「1：即時に現在のステータスのレスポンスを返却する」

Alipayバーコード決済（消費者スキャン型支払期限について）

Alipayバーコード決済（消費者スキャン型）では、Authorizeコマンドを利用してQRコードを発行した場合、Alipay社側でQRコード発行後の支払期限を指定できる仕様になります。（デフォルト30分となっております。）

※CreateIdentityCodeコマンドを利用してQRコードを発行した場合には、支払期限を指定できません。

この期限内に消費者側でQRコードをスキャンし決済を成立させなければなりません。
そのため、加盟店様がご提供のサービスに合わせてこの期限を変更してください。なお、支払期限については、MAPから変更可能です。（1分～15日の間で指定することができます。）

※QRコードはワンタイムコードの為、発行後読取されずに一定時間経過するとコードが無効になります。