PIX QR 코드: 브라질 결제를 위한 정적 BR Code
PIX는 브라질의 즉시 결제 시스템이며, 그 QR 코드는 EMV QR Code Payment Specification을 따릅니다. 다른 지역의 결제 코드와 같은 필드·길이 문법입니다. 정적 PIX 코드는 수취인 키를 직접 담기 때문에 은행 앱이 서버를 먼저 호출하지 않고도 이체를 구성할 수 있습니다. 인쇄가 저렴하고 오프라인에서도 쓸 수 있지만, 코드가 고정된 스냅숏이라는 뜻이기도 합니다.
정적 PIX 코드의 구조
모든 필드는 두 자리 ID, 두 자리 길이, 값으로 씁니다. 페이로드는 00으로 시작해 63번 필드의 CRC로 끝납니다. 26번 필드는 가맹점 계정 블록이며, 하위 필드 00이 PIX 스킴을, 01이 키를 담습니다.
| 필드 | 예시 값 | 역할 |
|---|---|---|
| 00 | 01 | 페이로드 형식 표시자. |
| 26 | br.gov.bcb.pix + 키 | 가맹점 계정 정보. PIX GUI와 CPF, CNPJ, 이메일, 전화번호 또는 무작위 키. |
| 52 | 0000 | 가맹점 업종 코드. 업종을 모를 때는 0000이 허용됩니다. |
| 53 | 986 | 통화. 986은 브라질 헤알입니다. |
| 58 | BR | 국가 코드. |
| 59 | QrDeco Example | 가맹점 이름. 최대 25자. |
| 60 | Sao Paulo | 가맹점 도시. 최대 15자. |
| 62 | 05 + txid | 추가 데이터. 거래 ID 또는 없을 때 ***. |
| 63 | 3C63 | 이 필드 앞의 전체에 대한 CRC16-CCITT. |
내 키로 PIX 코드 생성하기
- 계정에 실제로 등록된 키 유형을 고르세요. CPF·CNPJ는 숫자로, 이메일은 적힌 그대로, 전화번호는 +55와 번호, 무작위 EVP 키는 UUID로 씁니다.
- 52, 53, 58번 필드를 0000, 986, BR로 설정합니다.
- 59, 60번 필드에 은행이 표시할 이름과 도시를 채웁니다. 둘 다 길이 제한이 있고 마크업을 받지 않습니다.
- CRC를 계산한 뒤 인쇄용은 SVG, 결제 페이지용은 PNG로 내보냅니다.
금액을 비워 두기
54번 필드를 생략하면 결제자가 금액을 입력합니다. 54번을 넣을 때는 소수점을 마침표로 씁니다. 10.50이며 10,50은 안 됩니다. 그러면 앱이 금액을 미리 채웁니다. 금액을 비우는 방식은 팁, 기부, 합계를 먼저 합의하는 카운터에 맞고, 고정 금액은 상품 페이지나 단가가 하나인 서비스에 맞습니다.
txid와 대사
62-05 하위 필드는 거래를 식별합니다. 값 ***은 ID 없음을 뜻하며, 익명 모금함에는 괜찮지만 매장의 일일 매출을 대사하기에는 쓸모가 없습니다. 최대 25자의 짧은 영숫자 인보이스 번호를 쓰고, 어떤 코드를 언제 인쇄했는지 기록해 두세요.
자주 묻는 질문
정적 PIX 코드는 동적 코드와 같은가요?
아니요. 정적 코드는 키와 고정 데이터를 담고, 동적 코드는 결제 서비스가 청구서로 해석하는 URL을 담습니다. 인보이스별 금액과 납기일이 그렇게 동작합니다.
은행 앱이 내 코드를 거부하는 이유는 무엇인가요?
거의 항상 CRC입니다. 이름, 도시, txid를 포함해 무엇이든 수정한 뒤 63번 필드를 다시 계산하고, 각 필드 길이가 값과 여전히 맞는지 확인하세요.
모든 판매에 PIX 코드 하나를 재사용해도 되나요?
금액을 비운 정적 코드라면 가능하지만, 판매마다 새 코드를 만들지 않으면 txid가 모든 결제에서 같습니다. 재사용은 편리함이지 대사 전략이 아닙니다.
결제와 링크에 관한 다른 레시피.