UTF-8で送ろうが、フラグ付きにしようが、だ。

散々悩んだ挙句、原因はSOAP::Liteが勝手にbase64エンコードするからだと判明。

Business::PayPal::APIは内部でSOAP::Liteを使用していて、Asciiだとそのままなのだけれど、それ以外はbase64にエンコードする仕様の様子。

前々から、例えば、OrderDescription に日本語を使うと上手くいかないと思っていたのだけれど、、、。
仕方がないから Business::PayPal::API::ExpressCheckoutをカスタマイズする。

/usr/lib/perl5/site_perl/5.8.8/Business/PayPal/API/ExpressCheckout.pm

    ## add all the other fields
    for my $field ( keys %types ) {
	next unless defined $args{$field};
 
        if( $field eq 'MaxAmount' ) {
            push @secrd, SOAP::Data->name( $field => $args{$field} )->type( $types{$field} )
              ->attr( {currencyID => $currencyID, xmlns => $self->C_xmlns_ebay} );
        }
        ## 追記ココから
        elsif($field eq 'Address'){
            my @addr;
            my $hash = $args{$field};
            for my $f ( keys %$hash) {
               push @addr,  SOAP::Data->name( $f )->type(string => $args{$field}{$f} );
            }
            my $obj = SOAP::Data->name( $field => \SOAP::Data->value( @addr ));
            push @secrd,$obj;
        }
        ## 追記ココまで
        else {
            push @secrd, SOAP::Data->name( $field => $args{$field} )->type( $types{$field} );
        }
    }

SOAPなんて使ってたらダメだね…

ウェブペイメントスタンダードの欠点だったPayPal会員以外がクレジットカード決済するのに分かりにくい・・・っていうのが改善された感じ。

ウェブサイト自体も日本語化がかなり進んでいるみたいだし、日本でも本格的に活動していきそうな感じがする。

実際かなり便利だし、導入の敷居が低いことを考えると良いことだと思います。

ますますEC市場が拡大されるかな？

PayPalウェブペイメントスタンダードの新しい画面

リニューアルされたPayPalウェブペイメントスタンダード最初の画面

PayPalの新しいウェブペイメントスタンダードはクレジットカード決済でも迷わずすすめそう

PayPal アカウントを作成して、あなたのサイトにカード決済を導入！

簡単に気づいた点は

ポイント周りの不具合

ポイントを付加するタイミングが「対応状況」を「発送済み」にした時になった。

クレジットカードでの決済未完了時（失敗など）

「決済処理中」という対応状況が増えて、入金待ちと区別が付きやすくなった。

ウェブペイメントプラスでの確認だったけど、悪くないかも。決済フローも簡潔で、これなら3000円出しても価値があると思う。

決済フローのスクリーンキャプチャ

注文確認画面。「次へ」で決済ページへ移行。

PayPal ウェブペイメントプラスの決済ページ。iframeで表示されるので違和感もない。入力画面も簡潔でいい感じ。

クレジットカード情報を送信した時もAjaxで処理されて、ページ移行がない。

決済処理完了。ここまでスムーズに出来る。

PayPalユーザーなら「PayPalで支払い」を選べばPayPalサイトへ移行して決済手続きをしてくれる。このフローが利用出来るだけでも価値がありそう。

EC-CUBEでPayPalのsandbox（テスト環境）してみる

PayPalウェブペイメントプラスの概要

テストだけなら https://developer.paypal.com/ でアカウントを作成すれば出来るはず。

「ウェブ ペイメント プラス インテグレーションガイド」 に詳しく書かれているけど、テストアカウントは売り手と買い手、それぞれ作成する事。

また、受取人の「Payment Review」という項目は「Disabled」にしておく事。Enabled（レビューが必要）になっている場合は注意。

EC-CUBE側はPayPal決済モジュールの設定画面で「決済サイトURL」を
https://securepayments.sandbox.paypal.com/acquiringweb
にする必要がある。
メールアドレスは、テストアカウントの売り手のものを使う。

PayPal アカウントを作成して、あなたのサイトにカード決済を導入！

PayPal決済モジュールのチェック機構を強化

とりあえずのコードを書いてみた。
なれないPHPだし、PostgreSQLだしで、いいのか悪いのか判断できません。
基本的にEC-CUBE本体から拾ったコードを再利用しただけです。

コードはEC-CUBE 開発コミュニティサイト – フォーラムに投稿してみました。

ソースはこちらから
PayPal決済モジュールのチェック機構を強化する

動作するのか

一応PayPalのテスト環境でテスト済みですが、ご利用は自己責任で。
ツッコミ大歓迎。

PayPal アカウントを作成して、あなたのサイトにカード決済を導入！

PayPal決済モジュールは支払先のメールアドレス（receiver_email）の正当性しかチェックしていない。

支払われた金額のチェックを行っていないため、（ポストされる内容を変更など）不正な金額を支払ったとしても入金済みにしてしまう。
PayPalから届く入金確認メールの金額と違っていないか確認する必要がある。

また、支払い済みのトランザクションIDの記録やチェックも行っていないため、不正利用される可能性もあると思われる。

（たしか）PayPalからダウンロードしたPerlのサンプルスクリプトにもレスポンスが VERIFIED の場合以下のチェックを行えとある。

# check the $payment_status=Completed
# check that $txn_id has not been previously processed
# check that $receiver_email is your Primary PayPal email
# check that $payment_amount/$payment_currency are correct

ちょっとチェック不足な気がするが・・・。

つづきをどぞ
EC-CUBE PayPal決済モジュールのチェック機構を強化する

PayPalのAPIを使う時は Business::PayPal::API というモジュールが便利。

先日のエントリー PayPal利用時の決済フローを考える でLandingPageオプションの事を書いたのですが、Business::PayPal::API で実装するとそのままでは利用出来ないので、Business::PayPal::API::ExpressCheckout のソースを変更する必要があります。

PayPalの英語版APIの解説書(PDF)にはLandingPageの記載が無いようでしたので日本独自の仕様なのでしょうか？？変更方法は簡単です。
パスは自分の環境ですと
/usr/lib/perl5/site_perl/5.8.5/Business/PayPal/API/ExpressCheckout.pm でした。

変更方法

Business::PayPal::API::ExpressCheckoutの21行目付近に、

my %types = ( Token                     => 'ebl:ExpressCheckoutTokenType',
		  OrderTotal                => 'cc:BasicAmountType',
		  currencyID                => '',
		  MaxAmount                 => 'cc:BasicAmountType',
		  OrderDescription          => 'xs:string',
		  Custom                    => 'xs:string',
		  InvoiceID                 => 'xs:string',
		  ReturnURL                 => 'xs:string',
		  CancelURL                 => 'xs:string',
		  Address                   => 'ebl:AddressType',
		  ReqConfirmShipping        => 'xs:string',
		  NoShipping                => 'xs:string',
		  AddressOverride           => 'xs:string',
		  LocaleCode                => 'xs:string',
		  PageStyle                 => 'xs:string',
		  'cpp-header-image'        => 'xs:string',
		  'cpp-header-border-color' => 'xs:string',
		  'cpp-header-back-color'   => 'xs:string',
		  'cpp-payflow-color'       => 'xs:string',
		  PaymentAction             => '',
		  BuyerEmail                => 'ebl:EmailAddressType' );

というハッシュの定義があるのでそこに1項目追加するだけです。
以下の様に追記します。

my %types = ( Token                     => 'ebl:ExpressCheckoutTokenType',
		  OrderTotal                => 'cc:BasicAmountType',
		  currencyID                => '',
		  MaxAmount                 => 'cc:BasicAmountType',
		  OrderDescription          => 'xs:string',
		  Custom                    => 'xs:string',
		  InvoiceID                 => 'xs:string',
		  ReturnURL                 => 'xs:string',
		  CancelURL                 => 'xs:string',
		  Address                   => 'ebl:AddressType',
		  ReqConfirmShipping        => 'xs:string',
		  NoShipping                => 'xs:string',
		  AddressOverride           => 'xs:string',
		  LocaleCode                => 'xs:string',
		  PageStyle                 => 'xs:string',
		  'cpp-header-image'        => 'xs:string',
		  'cpp-header-border-color' => 'xs:string',
		  'cpp-header-back-color'   => 'xs:string',
		  'cpp-payflow-color'       => 'xs:string',
		  PaymentAction             => '',
		  BuyerEmail                => 'ebl:EmailAddressType',
		  LandingPage               => '' );

これでLandingPageをBillingにした際にクレジットカード情報入力フォームが最初に表示される様になります。

PayPal アカウントを作成して、あなたのサイトにカード決済を導入！

PayPalで決済する際、ウェブ ペイメント スタンダードを使用し、IPN（即時支払い通知）を受け取って処理しています。
この決済フローの場合、PayPalへ移動した際に表示される画面に若干問題があります。

ウェブペイスタンダードの決済ページの見本

というのも、購入する顧客がPayPalアカウントを持っている場合は問題ないのですが、PayPalアカウントを持っていない場合にはクレジットカード情報を入力する画面にたどり着くまでに「迷う」場合があるためです。

PayPalアカウントを持っていなくて、クレジットカードで決済を希望している顧客は画面左下の「続行」というリンクをクリックして、次の画面へ進まなくてはならない為です。

ネットになれている顧客ならいとも簡単に理解して難なく次ぎ画面へ進むと思いますが、不慣れな顧客にとってはストレスとなると思います。

PayPal APIを使ったエクスプレスチェックアウトの場合

エクスプレスチェックアウト LandingPageがBillingの場合

そこで、ファーストページにクレジットカード情報の入力フォームを表示したいと考えますが、ウェブ ペイメント スタンダードの場合、そこに誘導するオプションが用意されていません。

調べた結果、PayPal APIを使いエクスプレスチェックアウト（高速チェックアウトAPI）を実装することでこの問題を回避する事が出来ます。

エクスプレスチェックアウトAPIには LandingPage というオプションがあり、表示するPayPal ページのタイプを指定出来ます。

• Billing: 非PayPal アカウント
• Login: PayPal アカウントログイン

LandingPage オプションを Billing に指定する事で顧客が最初に表示するページにクレジットカード情報を入力するフォームが含まれたページとなります。

日本ではPayPalアカウントを持つユーザーはまだまだ少数だと思われますので、こういった決済フローを構築する事は大切だと思います。

PayPal アカウントを作成して、あなたのサイトにカード決済を導入！

以前作ったsandboxでのテスト環境を使って、別の事業を構築する為のテストを行ったらエラーに悩まされた。

IPNで通知される状態が

payment_status=Pending
pending_reason=paymentreview

となってしまう。悩んだあげく、受取人のアカウント設定がおかしいのに気付く。
前にいろいろいじったアカウントを受取人に設定したせいかも。
とりあえず変更してみる。

主要通貨を変更

1. Profile -> Financial InformationのCurrency Balances から
2. セレクトボックス（Select new currency）から Japanese Yen を選択し、Add Currencyボタンで追加する
3. 追加された一覧の Japanese Yen のラジオボタンと選択し、Make Primaryボタンを押す。

ウェブ ペイメントの設定

Selling Preferences -> Website Payment Preferences から行う。

各項目は以下の通り。

Auto Return for Website Payments

Auto Return: Off
Return URL: 無し
自動復帰はフォームパラメーターで渡せるのでOff。
事業が１つしか無い場合を除き自動復帰URLをケースによって変えたい場合があるので。

Payment Data Transfer (optional)

Payment Data Transfer: Off
これもフォームで渡せるので。

Encrypted Website Payments

Block Non-encrypted Website Payment: Off
フォームパラメータの暗号化（SSLではない）されていない場合も受け取るようにする。

PayPal Account Optional

PayPal Account Optional: On
これが Off だとPayPalアカウントを持っていないと決済出来ない。
持っていない場合、PayPalへの登録が必須となってしまう。

Contact Telephone Number

Contact Telephone: Off

Express Checkout Settings

Support giropay and bank transfer payments: No

とりあえず設定はしてみたものの、IPNで返されるパラメーターは
payment_status=Pending
pending_reason=paymentreview
のままなので、テストではPendingの場合はエラーとしないで（当然 payment_statusもCompletedにならない）処理するしかないか？？

PayPal アカウントを作成して、あなたのサイトにカード決済を導入！