Why Offer Pix?
Dominant in Brazil
Pix는 브라질에서 가장 많이 사용되는 결제 수단으로, 신용카드와 boleto보다 많이 사용됩니다. 브라질 중앙은행에 따르면 2025년 하반기에 Pix는 전체 결제 거래의 54.7%를 처리했습니다.
Instant Settlement
Pix 송금은 연중 언제든지, 어떤 시간대에도 몇 초 안에 완료되므로 은행 처리 시간을 기다릴 필요가 없습니다.
Low Friction
고객은 은행 앱에서 QR 코드를 스캔하거나 Pix 코드를 붙여넣습니다. 카드 번호나 은행 정보를 입력할 필요가 없습니다.
Overview
최소 금액은 BRL checkout의 최소 금액이므로 BRL checkout의 모든 결제 수단에 적용됩니다.작동 방식
고객 경험
- 고객이 checkout에서 Pix를 선택하고 Pix CPF 필드에 CPF(브라질의 11자리 납세자 ID)를 입력합니다.
- 고객이 결제를 확인합니다. 전체 화면 오버레이에 QR 코드가 표시되고, 그 아래에 Pix 코드와 코드 복사 버튼이 표시됩니다.
- 고객이 은행 앱을 열고 Pix를 선택한 다음 QR 코드를 스캔하거나 Pix 코드를 붙여넣습니다.
- 몇 초 안에 결제가 확인됩니다.
- Checkout이 결제 완료를 감지하고 고객을 성공 페이지로 리디렉션합니다.
Pix QR 코드는 제한된 시간 후 만료됩니다. 고객이 제때 결제하지 않으면 사이트에서 새로운 checkout을 시작해야 합니다.
구성
API 메서드 유형
테스트
1
Enable Test Mode
대시보드 사이드바에서 Live Mode 전환을 끄고 테스트 모드에서 생성한 API 키를 사용하세요.
2
Set Billing Currency to BRL
Adaptive Currency를 활성화하세요. 그런 다음
allowed_payment_method_types에서 billing_currency: 'BRL' 및 pix를 사용해 checkout session을 생성하세요.3
Enter Test CPF and Scan the QR Code
Pix CPF 필드에
00000000000(0 열한 자리)를 입력하세요. Checkout에 테스트 QR 코드가 표시됩니다. 휴대폰 카메라로 스캔하세요. Pix 앱이나 은행 앱은 필요하지 않습니다. QR 코드가 테스트 페이지를 열며, 여기에서 결제 성공 또는 실패를 시뮬레이션할 수 있습니다.모범 사례
Set billing currency to BRL
Set billing currency to BRL
Pix는 BRL로 청구되는 checkout에서만 사용할 수 있으며 Dodo Payments는 Adaptive Currency가 활성화된 경우에만 BRL로 청구합니다. 브라질 고객에게 BRL로 금액을 제시하고 청구할 수 있도록 Adaptive Currency를 활성화하세요.
Provide card fallbacks
Provide card fallbacks
일부 브라질 고객은 카드 결제를 선호합니다. 대체 결제 수단으로
credit 및 debit를 포함하세요.Handle QR code expiration
Handle QR code expiration
Pix QR 코드는 제한된 시간 후 만료됩니다. 고객이 코드가 만료된 후 다시 방문하면 새로운 checkout session을 생성하세요.
문제 해결
Pix not appearing at checkout
Pix not appearing at checkout
확인 사항:
- 청구 통화가
BRL인가요? pix가allowed_payment_method_types에 포함되어 있나요?- 고객의 청구 국가가 브라질(
BR)인가요? Adaptive Currency를 사용하면 브라질 청구 주소가 청구 통화를 BRL로 설정합니다. - Adaptive Currency가 활성화되어 있나요?
- 금액이 0.50 BRL 최소 금액을 충족하나요?
QR code expired
QR code expired
원인: 고객이 만료 시간 내에 결제를 완료하지 않았습니다.해결 방법: 고객은 사이트에서 새로운 checkout을 시작해야 합니다. 고객에게 새로운 payment link를 보내려면 새로운 checkout session을 생성하세요.
Payment pending
Payment pending
원인: 대부분의 Pix 결제는 몇 초 안에 확인되지만 은행에서 간혹 송금이 지연될 수 있습니다.해결 방법: return redirect 대신
payment.succeeded 및 payment.failed webhooks를 사용하여 최종 결제 상태를 확인하세요. 몇 분 내에 결제가 확인되지 않으면 실패한 것으로 처리하세요.관련 페이지
Payment Methods Overview
지원되는 모든 결제 수단을 확인하세요.
Adaptive Currency
BRL을 포함해 고객에게 현지 통화로 청구하세요.
Checkout Guide
checkout 구현 전체 가이드입니다.
Webhooks
결제 확인을 비동기 방식으로 처리하세요.
Testing Process
테스트 데이터 및 checkout 테스트 안내입니다.