PayPal
このページで
PayPal を開始する#
このページは、DEUNAとのPayPalの統合を成功させるための包括的なガイドを提供します。
PayPalは、世界的に認められているデジタル決済プラットフォームであり、顧客と商人が電子決済を行うための安全で便利な方法を提供します。
仕組み#
PayPalには、ニーズに応じて選択できる2種類の決済プロセスがあります。
PayPalチェックアウト
全体的なチェックアウトプロセスに対するより多くの制御を提供する、ワンタイム決済体験。
- 顧客をウェブサイト内に留保したまま、決済承認プロセス中にPayPalとの連携をスムーズに行うことができます。
- チェックアウトでは、顧客のPayPalアカウントを保存する機能は提供されません。
- チェックアウトは、認証されていない、または新規ユーザーのみに対して行われます。したがって、既存のIDがないため、支払い方法の選択はできません。
PayPal Vault
このフローにより、お客様が取引中に存在する必要がなく、取引中に再認証する必要もなくなります。
- PayPal Vaultは、認証されたユーザーのみが利用できます。
- Vaultでは、支払い方法の選択が可能です。
要件#
以下の内容は、PayPalとの成功的な統合に必要な要件をすべてリストアップしています。
- 環境で使用:
- サンドボックス: https://api.sandbox.deuna.io
- 本番環境: https://api.deuna.io
- Postman コレクション:
https://www.postman.com/deunaonline/workspace/deuna/folder/30572503-42f68d9b-0763-4002-ba5f-7d1168462e59?action=share&source=copy-link&creator=36841419&ctx=documentation
統合手順#
技術要件が設定されたら、統合を開始できます。
1. Configurar el procesador de pagos
- Agregue PayPal Wallet a su DEUNA Adminの接続.
- Busque "PayPal Wallet" y luego ingrese sus credenciales de cuenta de negocio de PayPal.
接続
決済、ウォレット、および不正検知の統合を発見および管理します。
| 接続 | 種類 | ステータス | アクション |
|---|---|---|---|
| Adyen | 決済ゲートウェイ | 接続済み | |
| Worldpay | 決済ゲートウェイ | 接続済み | |
| PayPal | 決済方法 | 接続済み | |
| Mercado Pago | 決済方法 | 接続されていない | |
| Riskified | 不正検知エンジン | 接続されていない |
2. Pay Nowボタン
-
このオプションは、DEUNA Adminで、商人のPayPal支払い方法設定を通じて直接制御されます。
-
デフォルト: CONTINUE — デフォルトですべての商人に有効になっています(特別な操作は不要)。
-
商人は、Adminからいつでも「Pay Now」を有効にできます。そのため、新しい技術的な統合は不要です。
-
この変更は、必要に応じていつでも取り消すことができます。これは統合時に一度決めるのではなく、商人が独立して制御できるスイッチです。
適切なオプションの選択方法
-
検討すべき主な質問は次のとおりです。「購入者がPayPalで支払いを確認した後、最終金額が確定し、サイト上で追加の確認画面が表示されることはありませんか?」
-
もし答えが「はい」の場合 → 「PAY NOW」を使用してください。
-
もし答えが「いいえ」(購入者はまだアイテム、住所、配送、追加オプションを変更したり、最終確認画面を表示したりできる場合)→ デフォルトオプションを使用してください(特別な操作は不要)。
「PAY NOW」を使用するタイミング
-
推奨されるのは、取引フローで、購入者がPayPalにリダイレクトされる時点で、価格がすでに確定している場合です。
-
製品ページでの直接購入/「Buy Now」機能で、カートや追加の確認ステップがない場合。
-
固定価格で選択されるチケットや予約(例:座席、手荷物、アップグレードの選択はPayPalからの戻り後に発生しない場合)。
-
定額、変更不可のサブスクリプションと定期支払い。
-
即時/ワンクリック決済、各ステップが離脱率を増加させる。
-
デジタル商品(アプリ、ゲーム、コンテンツ)、購入者は「支払い=即時提供」を期待します。
CONTINUE (デフォルト) の使用に関する情報
-
PayPal経由で戻った後、商人がサイト上でまだ確認またはレビューのステップがある場合に推奨:
- 複数の商品が含まれるカート、購入者が商品を加えたり、クーポンを適用したり、配送を確認したりしてから確定できる。
- 配送または税金が承認後にのみ計算されるフロー(例:配送先住所に依存)。
- 承認後に追加オプションがある予約、例えば座席の選択やアップグレードなど、最終的な決済前に。
-
3. 注文の作成
Para realizar una compra, primero debe crear un pedido de DEUNA.
以下の手順に従ってください。 注文の作成.
La API devolverá un order_token フロー全体で使用されます。
Campos requeridos:
| フィールド | 説明 | Value |
|---|---|---|
order.store_code | Código único de la tienda | all |
order.payment_method | Tipo de método de pago DEUNA (Para integración de API) | wallet |
order.items_total_amount | Monto total de los artículos sin impuestos ni descuentos. | 2000 |
Consideraciones:
- Acerca de
order.items:total_amount.original_amountdebe serunit_price.amount * quantity.total_amount.amountdebe ser((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.total_amount.total_discountes el valor total de los descuentos para la cantidad de artículos.
order.items_total_amountes la suma de los precios unitarios de los artículos, este monto se suma aorder.total_tax_amountおよびマイナスorder.discount_amountは、以下の条件を満たす必要があります。order.total_amount.order.sub_totalこれは、商品の単価から割引を差し引いた金額であり、この金額は次のものに加算されます。order.total_tax_amount必須要件order.total_amount.
4. 統合の種類を選択
注文を作成した後、ニーズに最適な統合の種類を選択:
5. FraudNetを統合
Fraudnet es una biblioteca desarrollada por PayPal que analiza los datos enviados a través del navegador durante todo el proceso de compra para prevenir posibles fraudes en las transacciones.
Fraudnet debe estar en funcionamiento durante todo el proceso de transacción. Para su integración, PayPal proporciona la siguiente documentación: Integrar FraudNet
6. 支払い検証
支払いを確認し、PayPalのルールを正しく使用していることを確認。
Montos de descuento
PayPalでの割引は、注文レベルでサポートされています。ペイロードには、割引を処理する必要があります。 discount_amount field.