Skip to main content
브라질 고객이 QR 코드를 스캔하거나 Pix 코드를 붙여넣어 은행 앱에서 결제할 수 있습니다. Pix는 브라질 중앙은행(Banco Central do Brasil)이 만든 브라질의 즉시 결제 시스템입니다. 주말과 공휴일을 포함해 하루 24시간 실시간으로 자금을 이체합니다. Dodo Payments는 BRL로 청구되는 일회성 결제 및 구독 결제에서 Pix를 제공합니다.

​
Why Offer Pix?

Dominant in Brazil

Pix는 브라질에서 가장 많이 사용되는 결제 수단으로, 신용카드와 boleto보다 많이 사용됩니다. 브라질 중앙은행에 따르면 2025년 하반기에 Pix는 전체 결제 거래의 54.7%를 처리했습니다.

Instant Settlement

Pix 송금은 연중 언제든지, 어떤 시간대에도 몇 초 안에 완료되므로 은행 처리 시간을 기다릴 필요가 없습니다.

Low Friction

고객은 은행 앱에서 QR 코드를 스캔하거나 Pix 코드를 붙여넣습니다. 카드 번호나 은행 정보를 입력할 필요가 없습니다.

​
Overview

최소 금액은 BRL의 checkout 최소 금액이므로 BRL checkout의 모든 결제 방법에 적용됩니다. BRL 결제 금액은 일회성 결제의 경우에도 최소 $0.50, 구독의 경우 최소 $1.00에 해당하는 금액 이상이어야 합니다. Minimum Amounts를 참조하세요.

​
작동 방식

​
고객 경험

  1. 고객이 checkout에서 Pix를 선택하고 Pix CPF 필드에 CPF(브라질의 11자리 납세자 ID)를 입력합니다.
  2. 고객이 결제를 확인합니다. 전체 화면 오버레이에 QR 코드가 표시되고, 그 아래에 Pix 코드와 코드 복사 버튼이 표시됩니다.
  3. 고객이 은행 앱을 열고 Pix를 선택한 다음 QR 코드를 스캔하거나 Pix 코드를 붙여넣습니다.
  4. 몇 초 안에 결제가 확인됩니다.
  5. Checkout이 결제 완료를 감지하고 고객을 성공 페이지로 리디렉션합니다.
Pix QR 코드는 제한된 시간 후 만료됩니다. 고객이 제때 결제하지 않으면 사이트에서 새로운 checkout을 시작해야 합니다.

​
구성

Pix는 BRL로 청구되는 일회성 결제 및 구독 checkout에 표시됩니다. Dodo Payments는 Adaptive Currency가 활성화된 경우에만 BRL로 청구하므로 Pix를 제공하기 전에 이를 활성화하세요.

​
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 코드가 테스트 페이지를 열며, 여기에서 결제 성공 또는 실패를 시뮬레이션할 수 있습니다.

​
모범 사례

Pix는 BRL로 청구되는 checkout에서만 사용할 수 있으며 Dodo Payments는 Adaptive Currency가 활성화된 경우에만 BRL로 청구합니다. 브라질 고객에게 BRL로 금액을 제시하고 청구할 수 있도록 Adaptive Currency를 활성화하세요.
일부 브라질 고객은 카드 결제를 선호합니다. 대체 결제 수단으로 credit 및 debit를 포함하세요.
Pix QR 코드는 제한된 시간 후 만료됩니다. 고객이 코드가 만료된 후 다시 방문하면 새로운 checkout session을 생성하세요.

​
문제 해결

확인:
  1. 결제 통화가 BRL인가요?
  2. pix이(가) allowed_payment_method_types에 포함되어 있나요?
  3. 고객의 청구 국가가 브라질인가요(BR)? Adaptive Currency에서는 브라질 청구지 주소가 청구 통화를 BRL로 설정합니다.
  4. Adaptive Currency가 활성화되어 있나요?
  5. 금액이 BRL 최소 금액인 0.50 및 USD 최소 금액을 충족하나요?
해결 방법: Pix는 BRL checkout에서만 제공됩니다. API 요청에서 통화와 청구 주소를 확인하세요.
원인: 고객이 만료 시간 내에 결제를 완료하지 않았습니다.해결 방법: 고객은 사이트에서 새로운 checkout을 시작해야 합니다. 고객에게 새로운 payment link를 보내려면 새로운 checkout session을 생성하세요.
원인: 대부분의 Pix 결제는 몇 초 안에 확인되지만 은행에서 간혹 송금이 지연될 수 있습니다.해결 방법: return redirect 대신 payment.succeeded 및 payment.failed webhooks를 사용하여 최종 결제 상태를 확인하세요. 몇 분 내에 결제가 확인되지 않으면 실패한 것으로 처리하세요.

​
관련 페이지

Payment Methods Overview

지원되는 모든 결제 수단을 확인하세요.

Adaptive Currency

BRL을 포함해 고객에게 현지 통화로 청구하세요.

Checkout Guide

checkout 구현 전체 가이드입니다.

Webhooks

결제 확인을 비동기 방식으로 처리하세요.

Testing Process

테스트 데이터 및 checkout 테스트 안내입니다.
마지막 수정일 2026년 10월 8일