Pix

ブラジルの顧客は、QR コードをスキャンするか Pix コードを貼り付けて、銀行アプリから支払えるようになります。Pix はブラジル中央銀行（Banco Central do Brasil）が作成した、ブラジルの即時決済システムです。週末や祝日を含め、1日24時間、リアルタイムで送金できます。Dodo Payments は、BRL建ての単発決済とサブスクリプションで Pix を提供しています。

Pixを提供する理由

Dominant in Brazil

Pix はブラジルで最も利用されている決済方法で、クレジットカードや boleto を上回っています。ブラジル中央銀行によると、2025年下半期には、Pix がすべての決済取引の54.7%を占めました。

Instant Settlement

Pix の送金は、年間を通じていつでも、どの日でも数秒で完了するため、銀行の処理時間帯を待つ必要はありません。

Low Friction

顧客は銀行アプリで QR コードをスキャンするか、Pix コードを貼り付けます。カード番号や銀行情報を入力する必要はありません。

概要

最小額は BRL の checkout minimum であるため、BRL checkout のすべての支払い方法に適用されます。BRL の支払いは、一回限りの支払いでは $0.50 相当以上、サブスクリプションでは $1.00 相当以上である必要もあります。Minimum Amountsを参照してください。

詳細	値
請求通貨	BRL
対応国	ブラジル
サブスクリプション	はい
最低金額	0.50 BRL
決済	即時

仕組み

顧客体験

顧客はチェックアウトで Pix を選択し、Pix CPF フィールドに CPF（ブラジルの11桁の納税者 ID）を入力します。
顧客が支払いを確認すると、全画面オーバーレイに QR コードが表示され、その下に Pix コードと コードをコピー ボタンが表示されます。
顧客は銀行アプリを開いて Pix を選択し、QR コードをスキャンするか Pix コードを貼り付けます。
支払いは数秒以内に確認されます。
チェックアウトが支払いの完了を検知し、顧客を成功ページにリダイレクトします。

Pix QRコードは一定時間が経過すると有効期限が切れます。顧客が時間内に支払わなかった場合は、サイトから新しいcheckoutを開始する必要があります。

設定

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

Pix は、BRL建ての単発決済とサブスクリプションのチェックアウトに表示されます。Dodo Payments は Adaptive Currency が有効な場合にのみ BRL で請求するため、Pix を提供する前に有効にしてください。

API メソッドタイプ

タイプ	メソッド	国
`pix`	Pix	ブラジル

テスト

Enable Test Mode

ダッシュボードのサイドバーで Live Mode スイッチをオフにし、テストモードで作成した API キーを使用します。

Set Billing Currency to BRL

Adaptive Currency を有効にします。次に、allowed_payment_method_types 内で billing_currency: 'BRL' と pix を指定してチェックアウトセッションを作成します。

Enter Test CPF and Scan the QR Code

Pix CPF フィールドに 00000000000（0を11個）を入力します。チェックアウトにテスト用 QR コードが表示されます。スマートフォンのカメラでスキャンしてください。Pix アプリや銀行アプリは必要ありません。QR コードを開くとテストページが表示され、支払いの成功または失敗をシミュレートできます。

ベストプラクティス

Set billing currency to BRL

Pix は BRL建てのチェックアウトでのみ利用でき、Dodo Payments は Adaptive Currency が有効な場合にのみ BRL で請求します。Adaptive Currency を有効にして、ブラジルの顧客に BRL で見積もり、請求できるようにしてください。

Provide card fallbacks

ブラジルの顧客の中には、カードでの支払いを好む人もいます。代替の決済方法として credit と debit を含めてください。

Handle QR code expiration

Pix QRコードは一定時間が経過すると有効期限が切れます。顧客がコードの有効期限が切れた後に戻ってきた場合は、新しいcheckout sessionを作成してください。

トラブルシューティング

Pix not appearing at checkout

確認:

請求通貨は BRL ですか？
pix は allowed_payment_method_types に含まれていますか？
顧客の請求先国はブラジル（BR）ですか？Adaptive Currency では、ブラジルの請求先住所によって請求通貨が BRL に設定されます。
Adaptive Currency は有効になっていますか？
金額は 0.50 BRL の最小額および USD の最小額を満たしていますか？

解決策: Pix は BRL のチェックアウトでのみ提供されます。API リクエストで通貨と請求先住所を確認してください。

QR code expired

原因: 顧客が有効期限内に支払いを完了しませんでした。解決策: 顧客はサイトから新しいcheckoutを開始する必要があります。新しいpayment linkを送信するには、新しいcheckout sessionを作成してください。

Payment pending

原因: Pix のほとんどの支払いは数秒以内に確認されますが、銀行によって送金が遅れる場合があります。解決策: リターンリダイレクトではなく、最終的な支払いステータスの確認に payment.succeeded と payment.failed の webhook を使用してください。数分以内に支払いが確認されない場合は、失敗として扱ってください。

Payment Methods Overview

対応しているすべての決済方法を確認します。

Adaptive Currency

BRL を含む現地通貨で顧客に請求します。

Checkout Guide

チェックアウト実装の完全ガイドです。

Webhooks

支払い確認を非同期で処理します。

Testing Process

テストデータとチェックアウトのテストに関するガイダンスです。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Pixを提供する理由

Dominant in Brazil

Instant Settlement

Low Friction

概要

仕組み

顧客体験

設定

API メソッドタイプ

テスト

ベストプラクティス

トラブルシューティング

関連ページ

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

​Pixを提供する理由

Dominant in Brazil

Instant Settlement

Low Friction

​概要

​仕組み

​顧客体験

​設定

​API メソッドタイプ

​テスト

​ベストプラクティス

​トラブルシューティング

​関連ページ

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

Pixを提供する理由

概要

仕組み

顧客体験

設定

API メソッドタイプ

テスト

ベストプラクティス

トラブルシューティング

関連ページ