概要
VibeFox dLocal Payment は、OpenCart 3 と OpenCart 4 を dLocal のセルフサービス製品である dLocal Go に接続します。購入者は購入手続きの最後のステップで Confirm Order をクリックし、dLocal Go の決済ページに移動して、自国の現地決済方法（カード、銀行振込、現金バウチャー、ウォレット）で支払い、ストアに戻ります。カード情報がお客様のサイトを経由することはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが付くのは dLocal Go が決済を確定した後です。そのため、未払いの試行は注文なしのまま残ります。
ラテンアメリカ、アフリカ、アジアで販売し、dLocal Go のアカウントを持つストアに適しています。この拡張機能が対応するのは 1 回限りの決済のみです。サイト上にカードフォームはなく、カードの保存、定期購読、与信と売上計上の個別処理もありません。また、dLocal Payments のエンタープライズ API（X-Login / X-Trans-Key の認証情報）では動作しません。
主な機能
dLocal Go の決済ページ: 注文金額を注文の通貨で、購入者の国に対して決済として作成します。金額は通貨の小数点以下の桁数に従います。たとえば CLP や JPY では整数の金額になります。
dLocal Go が確定した場合のみ支払い済み: 決済通知は署名で検証され、ステータス、金額、通貨は常に dLocal Go API から取得し直されます。購入者が戻ったときにもステータスを確認します。その後、OpenCart は通常の注文メールを送信します。
金額と通貨の照合: 注文と一致しない決済は、支払い済みにする代わりに、メモ付きの確認中ステータスにします。
二重処理の防止: 繰り返される通知や戻りが、同じ決済を 2 回適用することはありません。新しい決済を開始する前に、同じ購入者セッションの未完了の決済を確認するため、支払い済みの決済が再度請求されるのではなく、確定されます。
サンドボックスと本番: 環境ごとに個別の認証情報を使用します。決済の通知と返金は、その決済が行われた環境の認証情報を常に使用します。
注文ページからの返金: 注文の VibeFox dLocal Payment タブから、dLocal Go が請求した金額と通貨で全額返金と一部返金を行えます。全額返金を行うと Refunded ステータスに設定され、dLocal Go から届いた最終的な返金ステータスがメモに追加されます。
購入者にとって分かりやすい再試行: 決済せずに dLocal Go のページを離れた購入者は、購入手続き中にメッセージを表示され、再試行するか別の決済方法を選べます。
OpenCart の条件とステータス: ジオゾーン、注文の最低金額、並び順、そして支払い済み、完了、確認中、返金済みの注文に対して独自のステータスを設定できます。認証情報や個人データを含まない任意のログを利用できます。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。API キーと API シークレットを持つ dLocal Go のアカウント。通知を受け取るため、HTTPS でインターネットからアクセスできるストア。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。