概要
VibeFox dLocal Payment は、PrestaShop を dLocal のセルフサービス製品である dLocal Go に接続します。決済手順で購入者が dLocal Go を選ぶと、dLocal Go の決済ページに移動し、自国の決済方法(現地カード、銀行振込、現金払いバウチャー、ウォレットなど)で支払い、貴店に戻ります。カード情報が貴店のサイトを通ることはありません。注文は dLocal Go が決済を確認した後にのみ作成されるため、支払いを中断しても未払いの注文は残りません。
ラテンアメリカ、アフリカ、アジア向けに販売し、dLocal Go アカウントを持つストアに適しています。本モジュールは 1 回限りの決済のみに対応しています。貴店のサイト上のカード入力フォーム、保存済みカード、定期購入、オーソリとキャプチャの分離には対応しておらず、エンタープライズ向けの dLocal Payments API(X-Login / X-Trans-Key 認証情報)では動作しません。
主な機能
dLocal Go 決済ページ: カート合計額について、カートの通貨と購入者の国で決済が作成されます。金額は通貨の小数桁に合わせて扱われます。たとえば CLP と JPY では整数の金額になります。
dLocal Go の確認後にのみ支払い済み: 決済通知は署名で検証され、注文を変更する前に、ステータス、金額、通貨が必ず dLocal Go API から読み直されます。購入者が戻ったときにもステータスが確認されます。
金額と通貨のチェック: カートと一致しない決済は、注文を支払い済みにする代わりに、確認のため dLocal payment on hold にします。
二重処理なし: 通知の繰り返しや購入者の再訪によって、注文が 2 件作成されたり、決済が 2 回記録されたりすることはありません。
サンドボックスと本番: 環境ごとに別々の認証情報を使用します。通知と返金は、その決済が行われた環境自身の認証情報を使用します。
注文画面からの返金: 注文の dLocal Go payment ブロックで全額返金と一部返金ができます。金額と通貨は dLocal Go が請求したものに従います。全額返金を行うと注文は Refunded になります。
購入者にやさしい再試行: 支払わずに dLocal Go のページを離れた購入者には、チェックアウトでメッセージが表示され、再試行するか別の支払い方法を選べます。
注文ページの dLocal Go ブロック: 決済 ID、環境、ステータス、支払い済み金額と返金済み金額、返金履歴とメモ。支払い済み注文の自動完了(任意)と、認証情報を含まないログ。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。API キーと API シークレットを持つ dLocal Go アカウント。インターネットからアクセスでき、本番では HTTPS を使用するストア。vibefox.net で購入した VibeFox ライセンスキー(1 つのキーは 1 つのドメインで使用可能)。
