Pixのコードから印刷できるQRコードを作る
銀行アプリからPixのコピペ文字列をコピーして貼り付け、コードをデザイン。レジ横の案内板、配達袋、請求書用に印刷対応で書き出せます。
Google マップで開きます。座標でも構いません(37.4224, -122.0841)。
ビジネスの「クチコミを書く」フォームが開きます。プレイス ID か、それを含む Google マップのリンクを貼り付けてください。
UPI リンクにはチェックサムがありません。ID を打ち間違えると、問題なく読み取れるのに別人へ支払われるコードになります。決済アプリから ID を貼り付け、印刷前に自分宛てに 1 ルピー送って確認してください。
コピーしたまま貼り付けてください。KoloQR はペイロードを組み立てません。銀行が発行したものをそのまま符号化し、印刷前に検査します。
SVG・PNG・JPG • 最大2MB
Pix QRコードとは?
Pix QRコードとは、BR Codeを収めたQRコードのことです。BR Codeはブラジル中央銀行がPix向けに定めた決済用の文字列で、EMVCoの加盟店提示フォーマットで書かれています。ブラジルの銀行アプリで読み取ると、受取人あての送金画面が開き、多くの場合は金額まで入力済みです。同じ文字列を模様ではなくテキストで表示したものが、ブラジルで「Pix Copia e Cola」と呼ばれるものです。

静的と動的では振る舞いが違う
Pixには2種類のQRコードがあり、印刷物に向くのは片方だけです。
- 静的(QR Estático) - 決済の内容がすべて文字列の中にあります。Pixキー、氏名、都市、必要なら金額まで。期限切れがなく、読み取る側はオフラインでも動き、何度でも支払えます。印刷するのはこちらです。
- 動的(QR Dinâmico) - 文字列には、決済事業者がホストするデータへのリンクが入ります。支払う側のアプリが読み取り時に取得するため、金額や支払期限を取引ごとに設定でき、コード自体が期限切れになることもあります。
- Copia e Cola - 3つ目の種類ではありません。同じ文字列をプレーンテキストで表したもので、読み取る代わりに銀行アプリへ貼り付けます。テキストがあれば、コードの中身はすべて手元にあります。
静的なPixコードを印刷すれば何年も使えます。動的なものを印刷すれば、期限付きのリンクを印刷したことになります。動的コードが向くのは画面です。決済ページ、WhatsAppのメッセージ、送付した請求書など、支払いごとに新しく生成できる場所が適しています。市場の屋台、レジ横の案内板、配達袋が求めるのは静的なほうで、しかも今後動かすつもりのないキーで作られたものです。
KoloQRは銀行が発行した文字列をそのままコード化します
PixのBR Codeは自由なテキストではありません。長さを前置きしたフィールドの連なりで、識別子 br.gov.bcb.pix の下にPixキー、レアルを表す通貨986、国コードBR、氏名、都市が並び、最後に手前すべてを対象としたCRC16のチェックサムで閉じられます。1文字でも変わればチェックサムが合わなくなり、支払う側のアプリは別人に送金するのではなくコードを拒否します。KoloQRがキーからPixの文字列を組み立てないのは、まさにこのためです。銀行アプリがすでに正しいものを発行しているのですから、安全なのは組み直すことではなくコピーすることです。銀行アプリのPixの画面を開き、QRコードで受け取るを選び、表示されたCopia e Colaのテキストを取ってください。その文字列をKoloQRに貼り付ければ、銀行が生成したとおりの内容を持つコードが、印刷所の求めるサイズと品質で書き出せます。銀行アプリがやってくれないのは、まさにその部分です。
QRコードを作成
Pix QRコードが使われている場面
Pixはカード端末が届かなかった場所にも届きます。こうしたコードの多くは、そういう場所で使われています。
- 1
印刷するPixキーを選ぶ
PixキーにはCPF、CNPJ、電話番号、メールアドレス、ランダムキーが使えます。印刷物にはランダムキーを。口座を示しつつ、身分証番号や電話番号を路上の看板に載せずに済みます。
- 2
銀行アプリで静的コードを生成する
Pixの画面でQRコードによる受け取りを選び、静的を指定します。決まった価格の案内板なら金額を入れ、支払う側が決めるなら空欄のままに。そのうえでCopia e Colaのテキストをコピーします。
- 3
文字列を貼ってコードをデザインする
KoloQRでPixの種類を選び、コピーしたままの文字列を貼り付けます。余計な削除も改行もしないこと。KoloQRがチェックサムを計算し直してペイロードを読み戻すので、フィールドの下に出る名前・都市・金額は、支払う人が見るものと同じです。そのうえでデザインを。何よりコントラストを優先してください。屋外で急いで読み取られるコードです。
- 4
印刷前に自分あてに1レアル送る
完成したコードを実際の銀行アプリで読み取り、確認画面まで進みます。表示される氏名と都市が自分のものか確かめ、1レアル送金してから、SVGかPDFで書き出してください。

どのファイル形式をダウンロードすべき?
KoloQRはPix QRコードを3つの形式で書き出せます。どこで見られるかで選んでください。
- PNG メールやWhatsAppで送る請求書、画面に決まった大きさで表示するコードに。
- SVG レジ横の案内板、ラミネートしたカード、シールなど、印刷所が拡大してもエッジが甘くならない用途に。
- PDF 印刷所への入稿や、自分で刷ってラミネートする価格カードに。
Pixの文字列は長めです。ランダムキーと氏名、都市を含む静的なBR Codeは100文字を超えることが多く、短いリンクよりシンボルバージョンが数段階上がります。つまり同じ正方形の中にモジュールが増え、1つずつが小さくなるということです。ここから2つのことが言えます。URLのコードより大きめに刷ること、そして加盟店名を短くすること。名前は25文字、都市は15文字が上限で、使わなかった文字数のぶんだけ模様は粗く、読み取りに寛容になります。
QRコードを作成Pix QRコードのベストプラクティス
印刷された決済コードは、このコレクションの中で最も狙われる対象です。だからこのリストの半分は、模様ではなく看板そのものの話になります。
公開する場所にはランダムキーを使う
ランダムキーは何も明かしません。路上に面した看板にCPFや電話番号を刷れば、身分証番号や連絡先を公開することになります。どちらもチラシ100枚に載ってしまえば取り返せません。
コードの横に自分の名前を刷る
支払う側のアプリは、確定前に誰に支払うのかを表示します。同じ名前をコードの横に刷っておけば、その画面が客にも実行できる確認手段になります。
静的は刷る、動的は画面で見せる
動的コードには期限があり、ホストされたデータに依存します。ラミネートするもの、貼り付けるもの、印刷所に出すものは静的にしてください。
自分のコードの上に貼られたシールに注意する
本物の決済コードを不正なもので覆うのは、無人の看板に対する定番の攻撃です。改ざんが分かるラミネートを使い、毎日始業時に自分の看板を確認してください。
金額があるなら指定する
価格ごとに1つのコードにすれば、合計の打ち間違いも、どちらが間違えたのかという言い争いもなくなります。金額なしのコードはチップの瓶に向くもので、メニューに向くものではありません。
加盟店名と都市は短く
名前は25文字、都市は15文字。どちらも下回れば文字列が短くなり、印刷された模様が粗いままで読み取りやすくなります。
キーを移したら刷り直す
Pixキーは銀行間で持ち運べますし、削除もできます。すでに手元にないキーで刷ったコードは、黙って入金を受け付けなくなる看板です。
思っているより大きくする
Pixの文字列は密で、こうしたコードは屋外で、腕を伸ばした距離から、しばしば強い日差しの下で読み取られます。読み取り距離の10分の1は目標ではなく下限です。
明るい地に濃いモジュールを
反転や低コントラストの決済コードは、まさにお金がやり取りされる明かりの下で失敗します。常に明るい地に濃いモジュールで、四辺それぞれにモジュール4つぶんのクワイエットゾーンを空けてください。
スキャンアプリではなく実際の支払いでテストする
汎用のスキャナは文字列が読めたことしか教えてくれません。チェックサムが通り、キーが解決し、確認画面の名前が自分のものだと分かるのは銀行アプリだけです。
Pix QRコードが動かない理由
Pixのコードは、スマホを持った客の目の前で失敗します。だから看板を出したあとではなく、出す前に次を確かめてください。
銀行アプリが「無効なコード」と表示する
- 原因
- 銀行が発行したあとに文字列が変わっています。削られた空白、コピー&ペーストで入った改行、表計算ソフトで落ちた1文字などです。末尾のCRC16チェックサムが残りと合わなくなっています。
- 対処法
- 銀行アプリからCopia e Colaのテキストをもう一度コピーし、何も編集せずに貼り付けてください。打ち直さないこと、ワープロソフトを通さないこと。
汎用スキャナでは読めるのに支払いが始まらない
- 原因
- それは想定どおりです。スマホのカメラには数字と文字の長い並びが見えているだけで、決済ではありません。BR CodeはPixを解するアプリにしか意味を持ちません。
- 対処法
- ブラジルの銀行アプリのPixスキャナで試してください。自分あての送金画面が開けばコードは正常です。カメラアプリの挙動は関係ありません。
動いていたコードが動かなくなった
- 原因
- 背後のPixキーが削除されたか他行に移されたか、あるいは印刷したのが動的コードで、そのデータが期限切れになったかのどちらかです。
- 対処法
- キーがまだ自分の口座に登録されているか確認し、印刷したのが静的か動的かを確かめてください。持ち続けるつもりのキーで作った静的コードから刷り直します。
違う相手に支払ってしまったという報告が来る
- 原因
- 印刷したコードの上に不正なシールが貼られています。世界中どこでも、無人の決済看板に対する定番の攻撃です。
- 対処法
- 看板を外し、コードの横に自分の名前を入れたラミネート版に替え、送信前に確認画面の名前を見るよう客に伝えてください。詐欺は銀行に届け出を。Pixには申告された詐欺のための特別な返金の仕組みがありますが、カードのチャージバックとは違い、必ず取り戻せるわけではありません。
問題がファイルにあるのか印刷にあるのか判断できない場合は、書き出した画像をQRコードスキャナーに読み込ませてください。パソコンでは読めて紙では読めないなら、原因はファイルより後の工程にあります。
Questions? Answered
Pix QRコードはBR Codeを収めたものです。BR Codeはブラジル中央銀行の決済用文字列で、EMVCoフォーマットで書かれています。ブラジルの銀行アプリで読み取ると受取人あての送金画面が開き、多くは金額も入力済みです。
作れません。Pixの文字列は支払う側の銀行が検証するチェックサムで終わるため、Pixが信頼する発行元から来る必要があります。銀行アプリで生成し、Copia e Colaをコピーして、その文字列をKoloQRでコード化・デザイン・印刷してください。
Pix Copia e Colaは、BR CodeをQRコードではなくテキストで表示したもので、銀行アプリに貼り付けて使います。テキストとコードのデータは同じで、片方があればもう片方を作れます。
静的です。静的コードは決済データを模様の中に持ち、期限切れがなく、何度でも支払えます。動的はホストされたデータを指すため期限切れがあり、レジにラミネートしたいものではありません。
ランダムキーです。誰でも写真に撮れる看板にCPFや電話番号、メールアドレスを載せずに口座を示せます。キーは無料で、複数持てます。
入れられます。銀行アプリで静的コードを生成するときに金額欄があり、支払う側には入力済みの状態で表示されます。チップや寄付など、支払う側が決める場面では空欄のままに。
静的にはありません。背後のPixキーが口座に登録されている限り動きます。動的は期限切れになり得ます。データが模様の中ではなく事業者のサーバー上にあるためです。
BR Codeはリンクではないので、カメラには開くものがなく、たいてい生の文字列を表示するだけです。スマホが動作できるURIであるUPIコードとはこの点が違います。コードの不具合ではありません。銀行アプリのPixスキャナで試してください。
あります。決めるのはコードではなく各銀行です。夜間に低い上限を設けるのはよくあることです。印刷したコードで上限は上がらないので、高額を支払う客は自分のアプリで上限を調整する必要があるかもしれません。
読み取り距離のおよそ10分の1、1メートルから読む案内板なら10cm程度です。Pixの文字列は密なので、多めに取ってください。印刷サイズ計算ツールが距離と内容から割り出します。
関連ページ
このページの続きになるページ - 同じ場面、同じ種類のコード、あるいは次に決めることについて。
小売店
棚札・店頭のガラス・レジのサインから、商品情報や在庫、レビューのリンクへ。
理髪店・バーバー
窓からの予約、席ごとの次回予約コード、口コミとInstagram。cm単位のサイズと、ヘアスプレーや鏡前の照明に耐える仕上げまで。
PayPal QRコード
スキャンをPayPal.meのリンクへ送り、印刷したコードから支払いを受け取れます。
PromptPay QRコード
タイの銀行アプリが発行したPromptPayの文字列を、デザインして印刷できるコードにします。
PayNow QRコード
シンガポールの銀行アプリが発行したPayNowの文字列を、デザインして印刷できるコードにします。
QRコードの印刷サイズ計算ツール
読み取り距離、データ量、素材から、ミリ単位の最小幅を出します。その裏側にあるモジュールサイズとクワイエットゾーンも一緒に。
KoloQRを選ぶ理由
- ウェブサイト、メニュー、Wi-Fi、PDF、名刺用のQRコードを作成
- 色・ロゴ・オリジナルの形をカスタマイズ
- 高品質なPNG・SVGファイルをダウンロード
- 印刷にもデジタルにも対応
