💰 一千萬個為什麽 | PayPal - 內部エラー：タイムアウト処理要求Express Checkout

買い手が支払いを承認した場合、オプションでGetExpressCheckoutDetailsを呼び出し、ウェブ ページに表示する買い手の詳細情報を取得します。 8. オプションで、GetExpressCheckoutDetails APIオペレーションを呼び出して、ウェブページに買 い手の詳細情報を表示します。 2. Digital Goods用のJavaScriptライブラリをHTMLページgame. DoExpressCheckoutを呼び出します。22ページ「Digital Goods取引の完了」を参照してください。 注: iframeの制御中に上記の2つの手順を実施してください。 3. RefundTransactionオペレーションを実行します。 6. z 現在の未払い残高 z 支払い不履行になった請求サイクルの合計回数 z 前回支払い受領日 z 前回支払い受領金額 定期支払い個人設定の変更 UpdateRecurringPaymentsProfile APIを使用して、定期支払い個人設定を変更します。 注: 定期支払い個人設定の変更はペイパルのウェブサイトからも実行できます。 有効な個人設定または一時停止中の個人設定について、次の情報のみ変更できます。 z 支払者の名前または住所 z 期日を経過した金額または未払い金額 z 未払い金額を次の請求サイクルで請求するかどうか z 支払い不履行許容回数の上限 z 個人設定についての記述および参照情報 z 追加請求サイクル数 z 請求金額、税額、または配送料金 注: 個人設定の請求頻度や請求期間は変更できません。請求サイクル数は変更可能です。 注: エクスプレス チェックアウトAPIを使用した定期支払いの場合、請求予定日の3日前以降は請求金額 など特定の情報を更新できません。 試用期間または通常支払い期間中、以下の個人設定情報を変更できます。 z 請求金額 z 請求サイクル数 個人設定の変更は、個人設定更新の呼び出し後、次の支払い時に反映されます。たとえば、買い手が合 計 3 回 の 試 用 支 払 い の う ち の 1 回 を 実 行 し た と し ま す 。 そ の 後 、 お 客 様 が UpdateRecurringPaymentsProfileを呼び出し、請求サイクル数を5回に増やしたとします。この結果、 買い手の試用支払い回数が4 回増えます。通常の支払い期間にUpdateRecurringPaymentsProfileを呼 び出すと、買い手の次の通常支払い予定日に変更が反映されます。 詳細は、 『Name-Value Pair NVP APIデベロッパーガイドおよびリファレンス』 または『SOAP API リファレンス』を参照してください。 38 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 定期支払いの処理 Error! Luxembourg B 消費者の皆様へのご注意- PayPal のストアドバリュー設備の保有者である PayPal Pte. DoExpressCheckoutを呼び出して支払いを完了します。 Digital Goods取引の完了 買い手が注文を承認後、Digital Goods取引を完了するには、DoExpressCheckoutPayment APIオペ レーションを呼び出します。 DoExpressCheckoutPaymentを呼び出す際は、次の操作を行います。 1. 上記のチェックボックスでログイン情報の保存を制御しています。アカウントが不正に利用される危険 がないと判断された場合、この保存機能によって買い手はログイン手順を省略できます。 重要: ログイン情報の保存機能を設定していても、ログインを要求される場合があります。 ログイン後、ミニブラウザに「You are about to pay」（お客様の購入アイテムは次のとおりです。 ） のページが表示されます。 12 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! 定期支払いに関する用語 用語 定義 定期支払い個人設定 1人の買い手の定期取引に関する記録です。個人設定には、一定の間隔で一定の金額 を買い手に対して自動請求するために必要なすべての情報が含まれています。 請求サイクル 請求サイクルごとに1回の支払いを行います。各請求サイクルは2つの要素で構成さ れます。 z 請求期間は、請求サイクルの計算に使用される単位を指定します（日、月など） 。 z 請求頻度は、請求サイクルを構成する請求期間の回数を指定します。 たとえば、請求期間が月で、請求頻度が2の場合、請求サイクルは2ヶ月になります。 請求期間が週で、請求頻度が6の場合、請求サイクルは6週間になり、6週間ごとの 支払いがスケジュールされます。 通常支払い期間 個人設定の主要な定期支払い期間であり、各請求サイクルについての支払い金額を 定義します。個人設定で試用期間が指定されている場合、試用期間の終了後に通常 支払い期間を開始します。 試用期間 通常支払い期間を開始する前のオプションの定期支払い期間です。 試用期間には、通常支払い期間と同一の請求サイクルおよび支払い金額を設定する ことはできません。 支払い金額 請求サイクルごとに買い手によって支払われる金額です。 未払い残高 何らかの理由で支払いが失敗した場合、その金額が個人設定の未払い残高に追加さ れます。 個人設定ID （ペイパルが生成する 英数字の文字列で、定期支払い個人設定を一意に識別しま す。TransactionSearch APIオペレーションで個人設定IDを指定し、当該個人設定 に関連付けられたすべての支払いを取得できます。 定期支払い個人設定を作成する場合のオプション 定期支払い個人設定を作成し、通常支払い期間、オプションの試用期間、初回の支払い、およびそのほ かのオプションを設定できます。 通常支払い期間の指定 各定期支払い個人設定には、支払いの金額と頻度を定義する通常支払い期間があります。通常支払い期 間の指定に必要なフィールドを以下の表に示します。 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 31 定期支払いの処理 Error! 復帰URLページとキャンセルURLページにJavaScriptコードを追加してiframeを閉じます。 お客様のサイトで買い手の注文処理を行います。 デジタルコンテンツをダウンロードし、購入確認を表示します。 注: サイトの運用開始前に必ずインテグレーションテストを行ってください。 デジタルコンテンツ用決済とエクスプレス チェックアウトの統合 ペイパルデジタルコンテンツ用決済をエクスプレス チェックアウトAPIに統合するには、 SetExpressCheckout APIオペレーションとDoExpressCheckoutPaymentAPIオペレーションの実装 が必要です。オプションで、GetExpressCheckoutDetailsの実装も可能です。 18 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! addEventListener MouseEvent. Digital Goodsフローに買い手をリダイレクトします。SetExpressCheckoutレスポンスで返された トークンをリダイレクト先のURLに付加します。 買い手がデジタルコンテンツを初めて購入する場合は、iframeにミニブラウザが表示されます。買 い手はペイパルにログインし、支払いの承認を開始します。 6. に帰属します。PayPal, Inc. デジタルコンテンツの支払い取引の設定 デジタルコンテンツの支払い取引を設定するには、SetExpressCheckout APIリクエストオペレーショ ンを呼び出します。デジタルコンテンツ用決済フローを開始し、買い手をフローにリダイレクトするた めに必要な情報を入力します。 ここでは、ペイパルサーバーとの通信に使用する仕組みを設定済みで、ペイパルビジネスアカウントお よびAPI信用証明書を保有しているものとします。また、支払いアクションはSaleとします。 注: デジタルコンテンツ用決済で呼び出すAPIはすべてバージョン 構文を使用して、復帰 URLを設定し、追加パラメータを指定できます。指定したパラメータは、復帰URLで指定された ページのリクエストパラメータとして利用できるようになります。 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 19 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! 取引が正常に終了したかどうか返された値で確認してください。 デジタルコンテンツ用決済フローを開始するウェブページの設定 デジタルコンテンツ用決済フローを開始するには、以下の手順に従ってJavaScriptをウェブページに追 加します。 1. call "dg. gif 注: PayPal画像のコピーをお客様のローカルサーバー上にホストしないでください。古いPayPal 画像を 使用するとサイトへの信頼性が低下する可能性があります。 デジタルコンテンツ用決済の詳細 デジタルコンテンツ用決済画面は、買い手にはお客様のサイトの一部のように見えます。ペイパルの JavaScriptがフローを買い手のブラウザのiframeに設定し、お客様のサイトの上にミニブラウザをポッ プアップ表示します。 買い手はお客様のサイトで[Pay with PayPal]ボタンをクリックし支払いを開始します。 ペイパルはフローを開始するJavaScriptに応答します。買い手が初めてペイパルによる支払いを利用す る場合、または買い手がログインする必要があるとペイパルが判断した場合、[Log In]（ログイン）ボ タンがiframeに表示されます。 10 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! BillingFreque ncy 1つの請求サイクルを構成する請求期間の数 注: 請求頻度と請求期間の組み合わせは 1年以内になるようにしてください。 注: 請求期間がSemiMonth（半月）の場合、 請求頻度は1でなければなりません。 AMT ScheduleDetails. comのインターフェイスによって個人設定がキャ ンセルされた あり あり APIを使用して個人設定ステータスが変更された なし あり APIを使用して個人設定が更新された なし あり 初回の支払いに成功または失敗した あり あり 支払いに成功または失敗した（試用期間または通常支払い 期間中） あり あり 未払い金額の支払いに成功または失敗した あり あり 支払い不履行許容回数の上限に達した あり なし 注: ManangeRecurringPaymentsProfileStatusなどのAPI取引では、IPN通知は行われません。APIレ スポンスによって呼び出しの成否が即時に返されます。 40 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 A Chapter A iframe終了オプション 以下のiframe終了オプションを使用して親ページを再読み込みします。 z 41ページ「特定のURLに親ページを再読み込みする」 z 42ページ「フレームを削除して親ページを再読み込みする」 特定のURLに親ページを再読み込みする iframe終了オプションで、特定のURLに親ページを再読み込みすることができます。 特定のURLに親ページを再読み込みするには、以下の手順にしたがってください。 1. 支払い情報フィールド TransactionID TransactionType PaymentDate GrossAmount FeeAmount SettleAmount TaxAmount ExchangeRate PaymentStatus PendingReason ReasonCode Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 51 Author.{/INSERTKEYS}{/PARAGRAPH} PayPal S. ウィンドウが閉じたら、お客様のサイトで注文の確認を行います。 4. js を記述 し ます。 dg. PayPalはPayPal, Inc. DoExpressCheckoutを呼び出して、支払いを完了します。22ページ「Digital Goods取引の完了」 を参照してください。 3. 取引が正常に終了した場合は、デジタルコンテンツ取引を識別するトークンが返されます。この取引 に関連するエクスプレス チェックアウトAPIオペレーションを行う場合は、このトークンを渡し ます。 5. オプションで、GetExpressCheckoutDetails APIオペレーションを呼び出し、お客様のウェブペー ジに表示する買い手の詳細情報を取得します。 2. swfも含まれています。 2. swf中のFlashVarsまたはExternalInterfaceを利用して、APIレスポンスから必要な値を取 得します。 4. {PARAGRAPH}{INSERTKEYS}Link to full screen version Short link Download Digital Goods インテグレーションガイド — エクスプレス チェック アウト編 最終更新日: 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 文書番号： All rights reserved. swf and call paymentComplete sendingLC. は、本書の内容を「現状有姿」で提供しており、その内容については一切保証しないものとします。PayPal, Inc. の商標です。その他の商標およびブランドはそれ ぞれ各社に帰属します。 本書に記載の情報はPayPal, Inc. 支払い詳細タイプフィールド OrderTotal ItemTotal TaxTotal OrderDescription InvoiceID NotifyURL PaymentDetailsItem TransactionId PaymentRequestID 支払い詳細品目タイプフィールド Name Description Amount Number Quantity Tax ItemCategory DoExpressCheckoutPayment SOAPリクエストフィールド DoExpressCheckoutPaymentリクエストフィールド Token PayerID PaymentDetails ReturnFMFDetails 支払い詳細タイプフィールド OrderTotal ItemTotal TaxTotal OrderDescription InvoiceID NotifyURL PaymentAction PaymentDetailsItem PaymentRequestID 支払い詳細品目タイプフィールド Name Description Amount Number Quantity Tax ItemCategory DoExpressCheckoutPayment SOAPレスポンスフィールド DoExpressCheckoutPaymentレスポンスフィールド Token 50 Note RedirectRequired 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 Digital Goodsが対応しているエクスプレス チェックアウトAPIフィールド Error! 買い手が[Cancel]（キャンセル）ボタンを選択した場合は、SetExpressCheckout APIオペレーショ ンのリクエストメッセージで指定したキャンセルURLにリダイレクトします。[Pay]ボタンを選択した 場合、 「Thank you for using PayPal 」 （PayPalをご利用いただきありがとうございます）のペー ジがミニブラウザに表示されます。 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 13 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! 買い手はペイパルアカウントを取得するか、ログインが不要なゲストとして決済するかを選択できます。 注: ゲストとして決済することはデジタルコンテンツ決済において表示画面がわかりやすくなることで す。決済手順が少なくなるわけではありません。 ログインをクリックすると、 「Log in to your PayPal account」 （PayPalアカウントにログインし ます。 ）のページ がミニブラウザに表示されます。買い手はメールアドレスとパスワードを入力します が、チェックボックスにチェックを入れて次回から入力を省略することも可能です。 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 11 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! 図中の数字は以下の手順の番号に対応しています。 注: 呼び出しを行うペイパルAPIのAPIバージョンが JavaScriptをお客様のウェブページに追加し、ウェブページのiframeに表示するペイパルデジタル コンテンツ支払いフローを作成します。 3. z 取引詳細の取得 z 取引の検索 Digital Goodsが対応していない機能 Digital Goodsは、次のガイドに記載のエクスプレス チェックアウト機能のうち、以下に挙げる機能に 対応していません。 エクスプレス チェックアウト応用機能ガイド z 有形商品 デジタルコンテンツは、買い手がオンラインでダウンロードまたはアクセスを行うデジタルメディア です。 z 配送先住所 電子メディアをダウンロードするだけなら配送先住所は不要です。 z 即時更新API ペイパルサーバーがお客様のコールバックサーバーを呼び出し、買い手が変更した配送オプションに 基づきペイパルページの即時更新を行います。 z 並行支払い パラメータフィールドに10件までの支払い処理の詳細を記述できます。Digital Goodsでは1件の支 払い処理の値しか記述できません。 z 即時支払い 即時支払いは、買い手が商品を購入した時点で支払いを受領します（即時支払いメソッドのみ） 。 z 与信APIと回収API z SetCustomerBillingAgreement API z Giropay z インセンティブ Digital Goodsは以下の表に示す定期支払いAPIフィールドに対応していません。ペイパルNVPおよび SOAP APIの各参照文書では以下のフィールドを使用しないでください。 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 15 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! htmlに挿入します。このページには Flash動画ファイルgame. 買い手が[Pay With PayPal]ボタンをクリックすると、SetExpressCheckout APIオペレーショ ンを呼び出します。購入品目の詳細とデジタルコンテンツ取引に必要なパラメータフィールドを渡し ます。詳細は、19ページ「デジタルコンテンツの支払い取引の設定」を参照してください。 4. DGFlowを呼び出してフローの設定を行って ください。 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! client conn. は本書の内容に関していかなる種類の（明示 的、暗示的、法的）保証もいたしません。PayPal, Inc. TotalBillingCycles）の値を設定できます。値を指定し ない場合、または0を指定した場合は、ペイパル（または買い手）が個人設定をキャンセルまた一時停止 した場合を除き、繰り返し支払いが行われます。値が0より大きい場合、指定された請求サイクル数にな るまで通常支払い期間を継続します。 オプションで、通常支払い期間に対して配送金額や税額を指定することもできます。 オプションの試用期間の指定 オプションで個人設定に試用期間を指定するには、CreateRecurringPaymentsProfileリクエストで以 下のフィールドを指定します。オプションの試用期間の作成に必要なフィールドを以下の表に示します。 32 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 定期支払いの処理 Error! replace document. の登録商標です。PayPalロゴはPayPal, Inc. addCallback "paymentCompleteExt", paymentComplete ; Digital GoodsをFlashに統合する - サードパーティマーチャント サードパーティマーチャントがDigital GoodsをFlashに統合する例を以下に示します。 以下の例では、ActionScript 3. TotalBillingCycles 初回支払いの指定 オプションで、定期支払い個人設定の作成時にCreateRecurringPaymentsProfileリクエストに次の フィールドを設定し、最初の非定期支払いを指定できます。 初回支払いの指定に必要なフィールド NVP SOAP INITAMT ScheduleDetails. 買い手が[Pay]ボタンをクリックして支払いを承認するか、支払いをキャンセルすると、ペイパル が買い手をサイトの復帰URLページまたはキャンセルURLページにリダイレクトします。リダイレク ト時にペイパルがトークンと買い手の支払者IDを渡します。 7. 定期支払いのIPNメッセージおよびメール イベント IPN 買い手へのメール通知 個人設定の作成に成功した あり あり 個人設定の作成に失敗した あり あり paypal. et Cie, S. 買い手が[Close]（閉じる）ボタンをクリックすると、SetExpressCheckout APIオペレーションのリ クエストメッセージで指定した復帰URLへリダイレクトします。 ログイン情報が保存されている場合、次回からミニブラウザでのログイン操作を省略します。お客様に よるフローの開始およびiframeを閉じるアクションには変更ありません。 Digital Goodsが対応している支払い機能 Digital Goodsでは以下の支払い機能を使用できます。 z 定期支払い。デジタルコンテンツが対応していない機能もあります。詳細は15ページ「Digital Goods が対応していない機能」を参照してください。 デジタルコンテンツの取引後の処理 デジタルコンテンツの支払い取引を行った後、ペイパルAPIオペレーションを使用して以下のバックオ フィス処理を行うことができます。 z 14 払戻しの実行 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! OrderDescription InvoiceID NotifyURL PaymentDetailsItem PaymentAction 支払い詳細品目タイプフィールド Name Description Amount Number Quantity Tax ItemCategory SetExpressCheckout SOAPレスポンスフィールド SetExpressCheckoutレスポンスフィールド Token GetExpressCheckoutDetails SOAPリクエストフィールド GetExpressCheckoutDetailsリクエストフィールド Token GetExpressCheckoutDetails SOAPレスポンスフィールド GetExpressCheckoutDetailsレスポンスフィールド Token InvoiceID ContactPhone Note RedirectRequired CheckoutStatus Payer PayerID PayerStatus PayerCountry PayerBusiness PaymentDetails 支払者情報フィールド 支払者名フィールド Salutation FirstName LastName Suffix Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 MiddleName 49 Digital Goodsが対応しているエクスプレス チェックアウトAPIフィールド Error! は、誤りや不備に起因する、あるいは本書または本書の内容を使用した結果生じる、あるいは本書に記載の製品また はサービスの適用または使用の結果生じる（直接的または間接的）損害に対していかなる責任も負わないものとします。PayPal, Inc. z お客様による1度限りの購入（ワンタイムの購入） 、10回までの定期支払い、1度限りの購入と定期支 払いの組み合わせのいずれかの注文の開始 z 1度限りの購入および定期支払いのどちらにも関連付けられていない定期支払いに関する1件以上の 請求処理規約の作成処理フローの開始 通常SetExpressCheckoutリクエストの呼び出し時に、エクスプレス チェックアウト取引の支払い金額 を 設 定 し ま す 。 DoExpressCheckoutPayment リ ク エ ス ト で 金 額 を 確 認 し ま す 。 た だ し 、 SetExpressCheckoutリクエストで支払い金額を0に設定すると、支払いを開始せずに請求処理規約を 作成できます。 定期支払いに対して1件以上の請求処理規約を設定するには、SetExpressCheckoutリクエストを次の ように変更します。 1. BillingFrequency TRIALAMT ScheduleDetails. swfをAPIコールの復帰URLに指定します。 3. SetExpressCheckout APIオペレーションを実行し、エクスプレス チェックアウト取引を設定 します。 SetExpressCheckout APIオペレーションに対するレスポンスが成功したことを確認します。 成功した場合には、SetExpressCheckout APIオペレーションがトークンを返します。ペイパルは このトークンを使用して、APIオペレーションとコマンドの実行をチェックアウト体験の特定のイン スタンスに関連付けます。 20 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! swfに使用し、支払い に対応します。 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 年3月15日 43 Digital GoodsをFlashに統合する方法 Error! ペイパルが買い手をお客様のウェブページにリダイレクトした後のアクション ペイパルが買い手をお客様のウェブページにリダイレクトした後のアクションは、買い手が注文を承認 したかキャンセルしたかによって異なります。 買い手が注文を承認しデジタルコンテンツの支払いを行う場合、以下の操作を行います。 1. は、シンガポール通貨金融庁（Monetary Authority of Singapore）の承 認を必要としません。ご利用の際には、契約条件をよくご確認ください。 免責の告知: PayPal,Inc. 買い手が支払いを承認した場合、購入品目の詳細を含めてDoExpressCheckoutPaymentを呼び出 し、支払いを終了します。 9. js の JavaScript機能でiframeおよびペイパルのミニブラウザの設定および制御を行います。 24 機能と署名 内容 PAYPAL. Use the Home tab to apply 見出し 2 to the text that you want to appear here. フレームを削除して親ページを再読み込みする iframe終了のオプションで、フレームを削除して親ページを再読み込みすることができます。 フレームを削除して親ページの再読み込みを行うには、以下の手順にしたがってください。 1. 買い手が購入する品目ごとに以下のパラメータ値を設定します。 注 : SetExpressCheckout の 呼 び 出 し で 以 下 の パ ラ メ ー タ に 値 を 設 定 し た 場 合 で も 、 DoExpressCheckoutPaymentの呼び出しで再度値を設定する必要があります。値を設定しな いと、デジタルコンテンツ決済向けの手数料率が適用されません。 22 年3月15日 Digital Goodsインテグレーションガイド — エクスプレス チェックアウト編 エクスプレス チェックアウトを利用したデジタルコンテンツ用決済の紹介 Error! オプションで、GetExpressCheckoutDetails APIオペレーションを呼び出して、ウェブページに表 示する買い手の詳細情報を取得します。 2.