Alipay とは

アーキテクチャ

1. サードパーティ製モバイルアプリケーションから決済のオーダーが作成されます。
2. アプリケーションサーバーがオーダーを処理し、Alipay での決済に必要な情報を返します。
3. モバイルアプリケーションから Alipay アプリケーションを呼び出すことによって、決済プロセスを開始します。
4. Alipay アプリケーションが Alipay サーバーを使用して決済処理をします。
5. Alipay サーバーから Alipay アプリケーションに決済結果が返されます。
6. Alipay アプリケーションからモバイルアプリケーションに決済結果が返されます。
7. Alipay サーバーからアプリケーションサーバーに非同期決済通知が送信されます。

GeneXus との連携

手順

1 - Alipay 開発者サイトへのアプリケーションの登録

2 - PFX ファイルの作成

3 - 情報の設定

<Configuration>     
    <AppId />
    <Environment />
    <CertificateFilename />
    <CertificatePassword />
    <CallbackURL />     
    <Timeout /> 
    <AdditionalConfig />
</Configuration>

• AppId: Alipay へのアプリケーションの登録時に取得した識別子です。
• Environment: 指定可能な値は Production または Sandbox です。決済トランザクションを実行する環境です。Sandbox (サンドボックス) 環境は Android のみで使用でき、Production (本番) 環境は iOS のみで使用できます。
• CertificateFilename: 前の手順で作成した PFX ファイルの名前です。
• CertificatePassword: 前の手順で作成した PFX ファイルのパスワードです。
• CallbackURL: Alipay で決済トランザクションを完了するために呼び出される決済通知サービスの URL です (前述のアーキテクチャリストの 7)。既定では、Alipay API に含まれている CallbackService プロシージャーの URL が使用されます。
• Timeout: 決済トランザクションのタイムアウト (分単位) です。
• AdditionalConfig: その他の情報のリストです。 

4 - 決済データの準備

5 - Alipay への決済情報の送信

Event 'Pay with Alipay'
   Composite
      &PaymentApplicationData.ProductCode = 'Product name'
      &PaymentApplicationData.TotalAmount = 1000
      &PaymentApplicationData.Subject = 'Subject'
      &PaymentApplicationData.Body = 'Purchase information'
      GeneXus.Common.UI.Progress.ShowWithTitleAndDescription("Please Wait...","Preparing payment information...")
      Alipay.GetPaymentInformation(&PaymentApplicationData, &PaymentInformation)
      GeneXus.Common.UI.Progress.Hide()
      if &PaymentInformation.ErrorCode > 0
          Msg("Error: " + &PaymentInformation.ErrorDescription)
      else
          AlipayProvider.Pay(&PaymentInformation)
      endif
   EndComposite
Endevent

6 - 決済結果の処理

Event AlipayProvider.OnPaymentFinished(&PaymentResult)
   Composite
      if &PaymentResult.ErrorCode = 0
         GeneXus.Common.UI.Progress.ShowWithTitleAndDescription("Please Wait...","Finishing transaction...")
         SetSaleStatus(&PaymentResult.OrderNumber, PaymentStatus.Paid)
         ClearCart()
         GeneXus.Common.UI.Progress.Hide()
         ConfirmationPanel()
      else
         SetSaleStatus.Call(&PaymentResult.OrderNumber, PaymentStatus.Error)
         Msg(&PaymentResult.ErrorDescription)
      endif
   EndComposite
EndEvent

7 - 非同期決済通知サービス

まとめ

• Alipay_Config.xml ファイルで設定します。
• OnAboutToPay プロシージャーで Alipay に決済データを送信する直前に決済データ処理のコードを記述します。
• 決済データを設定して、GetPaymentInformation プロシージャーとスマート デバイス オブジェクトにある AlipayProvider 外部オブジェクトの Pay メソッドを呼び出します。
• スマート デバイス オブジェクトにある AlipayProvider 外部オブジェクトの OnPaymentFinished イベントのコードを記述します。
• CallbackHandler プロシージャーで処理される通知サービスのコードを記述します。

例