Braintree
Braintree은 사기 행위 감지 및 PayPal 통합을 통해 완전히 사용자 지정 가능한 체크아웃 경험을 제공합니다. Apple Pay, Google Pay, ACH, Venmo 및 로컬 결제 방법을 지원합니다. Braintree은 거래가 Braintree 시스템에서 이루어지기 때문에 가맹점의 PCI 규정 준수 부담을 줄입니다. Braintree 결제 통합은 GENE Commerce에서 개발되었습니다.
1단계: Braintree 자격 증명 가져오기
결제 Braintree (으)로 이동하여 계정에 등록하십시오.
2단계: 기본 설정 완료
-
관리자 사이드바에서 Stores > Settings>Configuration(으)로 이동합니다.
-
왼쪽 패널에서 Sales 을(를) 확장하고 Payment Methods 을(를) 선택합니다.
-
Commerce 설치 시 왼쪽 상단 모서리에서 구성이 적용되는 Store View 을(를) 선택하십시오.
-
Merchant Location 섹션에서 Merchant Country 이(가) 회사 위치로 설정되어 있는지 확인합니다.
-
-
Recommended Solutions 의_Braintree Payments (GENE Commerce v4.6.1 기준 - 릴리스 정보_섹션)에서 Configure 을(를) 클릭합니다.
{width="600" modal="regular"}
-
Title 의 경우 체크아웃 중에 Braintree을 결제 옵션으로 식별하는 제목을 입력하십시오.
-
Braintree 트랜잭션에 대한 현재 운영 체제 Environment 을(를)
Sandbox
또는Production
(으)로 설정샌드박스에서 구성을 테스트할 때 Braintree에서 권장하는 신용 카드 번호만 사용하십시오. Braintree을 사용하여 프로덕션으로 이동할 준비가 되면 Environment 을(를)
Production
(으)로 설정하십시오.{width="600" modal="regular"}
-
Payment Action 을(를) 다음 중 하나로 설정합니다.
Authorize Only
- 구매를 승인하고 자금을 보류합니다. 판매자가 회수 할 때까지 고객의 은행 계좌에서 금액이 인출되지 않습니다.|Intent Sale
- 구매 금액이 승인되어 고객 계정에서 즉시 인출됩니다. 참고: 이 값은 2.3.x 및 이전 릴리스의 승인 및 캡처 입니다.|
-
Braintree 계정에서 Sandbox Merchant ID / Merchant ID 을(를) 입력하십시오.
-
Braintree 계정에서 다음 자격 증명을 입력합니다.
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
note note NOTE (샌드박스 및 프로덕션) 환경 모두에 대해 별도의 필드가 있으며, 다른 필드는 선택한 환경에 따라 렌더링됩니다. -
구성을 저장하기 전에 Validate Credentials 을(를) 클릭하여 자격 증명의 유효성을 검사합니다.
-
Enable Card Payments 을(를)
Yes
(으)로 설정합니다.{width="600" modal="regular"}
고객이 구매할 때마다 다시 입력할 필요가 없도록 고객 정보를 안전하게 저장하려면 Enable Vault for Card Payments 을(를)
Yes
(으)로 설정하십시오.
3단계: 고급 설정 완료
-
Advanced Braintree Settings 섹션에서 를 확장합니다.
{width="550" modal="regular"}
-
Vault Title 의 경우 고객 카드 정보가 저장된 자격 증명 모음을 식별하는 참조를 설명하는 제목을 입력합니다.
-
Braintree 계정에서 Merchant Account ID 을(를) 입력하십시오.
사용할 머천트 계정을 지정하지 않으면 Braintree은 기본 머천트 계정을 사용하여 거래를 처리합니다.
-
PayPal, PayLater, Apple Pay 및 Google Pay를 포함하여 체크아웃 프로세스가 시작될 때 빠른 결제 옵션을 통해 더 빠른 체크아웃 환경을 제공하려면 Enable Checkout Express Payments 을(를)
Yes
(으)로 설정하십시오. -
관리자를 통해 주문한 주문에 대해 고급 사기 도구 검사의 일부로 평가를 위해 트랜잭션을 보내지 못하게 하려면 Skip Fraud Checks on Admin Orders 을(를)
Yes
(으)로 설정하십시오. -
임계값이 충족되거나 초과될 때
Advanced Fraud Protection
검사를 무시하도록 Bypass Fraud Protection Threshold 을(를) 설정하십시오.이 필드를 비워 두면 이 옵션이 비활성화됩니다.
-
스토어와 Braintree 간의 상호 작용에 대한 로그 파일을 저장하려면 Debug 을(를)
Yes
(으)로 설정하십시오. -
고객이 신용 카드 뒷면에서 3자리 보안 코드를 제공하도록 하려면 CVV Verification 을(를)
Yes
(으)로 설정합니다.CVV 인증을 사용하는 경우 Braintree 계정의 설정/처리 섹션에서 AVS 및/또는 CVV를 사용하도록 설정하십시오.
-
모든 결제 방법에 대해 장바구니 라인 항목을 보내려면 Send Card Line Items 을(를)
Yes
(으)로 설정하십시오. -
Credit Card Types 의 경우 스토어에서 Braintree 결제로 사용할 수 있는 각 신용 카드를 선택하십시오.
여러 카드 유형을 선택하려면 Ctrl 키(PC) 또는 Command 키(Mac)를 누른 채 각 옵션을 클릭합니다.
-
Sort Order 의 경우 체크아웃 중에 다른 결제 방법과 함께 나열할 때 Braintree이 표시되는 순서를 확인하려면 번호를 입력하십시오.
4단계: Braintree 웹후크 설정 완료
-
사기 방지, ACH 결제 및 로컬 결제 방법을 위해 웹후크 기능을 사용하려면 Enable Webhook 을(를)
Yes
(으)로 설정하십시오. -
Fraud Protection URL 필드의 URL을 복사하여 Braintree 계정에 Webhook Destination URL(으)로 추가하십시오.
note important IMPORTANT 이 URL은 안전하고 공개적으로 액세스할 수 있어야 합니다. -
Fraud Protection Approve Order Status 필드를 설정하여 Braintree에서 사기 행위 보호를 승인하는 시기를 확인합니다.
선택한 주문 상태가 Commerce 주문에 할당됩니다.
-
Fraud Protection Reject Order Status 필드를 설정하여 Braintree에 의해 사기 행위 보호가 거부되는 시기를 확인합니다.
선택한 주문 상태가 Commerce 주문에 할당됩니다.
5단계: 국가별 설정 완료
-
Payment from Applicable Countries 을(를) 다음 중 하나로 설정합니다.
All Allowed Countries
- 스토어 구성에 지정된 모든 국가의 고객이 이 결제 방법을 사용할 수 있습니다.Specific Countries
- 이 옵션을 선택하면 Payment from Specific Countries 목록이 나타납니다. Ctrl 키(PC) 또는 Command 키(Mac)를 누른 채로 목록에서 고객이 스토어에서 구매할 수 있는 각 국가를 선택합니다.
{width="600" modal="regular"}
-
Country Specific Credit Card Types 을(를) 설정하려면:
-
Add 을(를) 클릭합니다.
-
Country 을(를) 설정하고 각 Allowed Credit Card Type 을(를) 선택하십시오.
-
각 국가에서 수락하는 신용 카드를 식별하려면 이 단계를 반복합니다.
-
6단계: Braintree 설정을 통해 ACH 완료
-
ACH를 Braintree 결제 옵션으로 포함하려면 Enable ACH Direct Debit 을(를)
Yes
(으)로 설정하십시오. -
고객은 일회용 ACH 직불 결제 방법을 보관하고 나중에 사용할 수 있도록 저장할 수 있습니다. 저장하면 Enable Vault for ACH Direct Debit 을(를)
Yes
(으)로 설정한 경우 고객이 결제 정보를 다시 입력하거나 인증할 필요 없이 ACH 직불카드를 다시 사용할 수 있습니다. -
Sort Order 의 경우 체크아웃 중에 다른 결제 옵션과 함께 나열될 때 Braintree ACH 결제 옵션이 표시되는 순서를 결정하려면 숫자를 입력하십시오.
7단계: Braintree 설정을 통해 Apple Pay 완료
-
Apple Pay을(를) Braintree 결제 옵션으로 포함하려면 Enable ApplePay through Braintree 을(를)
Yes
(으)로 설정하십시오.먼저 Braintree 계정에서 도메인 이름을 확인하세요.
-
고객이 Apple Pay를 사용하여 구매할 때마다 다시 입력할 필요가 없도록 고객 정보를 안전하게 저장하려면 Enable Vault for ApplePay 을(를)
Yes
(으)로 설정하십시오. -
Payment Action 을(를) 다음 중 하나로 설정합니다.
Authorize Only
- 구매를 승인하고 자금을 보류합니다. 판매자가 판매를 캡처 할 때까지 고객의 은행 계좌에서 금액이 인출되지 않습니다.Intent Sale
- 구매 금액이 승인되어 고객 계정에서 즉시 인출됩니다.
-
Merchant Name 의 경우 Apple 결제 대화 상자에서 고객에게 표시되는 레이블을 지정하는 텍스트를 입력하십시오.
-
Sort Order 의 경우 체크아웃 중에 다른 결제 옵션과 함께 나열될 때 Apple Pay 결제 옵션이 표시되는 순서를 결정하려면 숫자를 입력하십시오.
8단계: 로컬 결제 방법 설정 완료
-
로컬 결제 방법을 Braintree 결제 방법으로 포함하려면 Enable Local Payment Methods 을(를)
Yes
(으)로 설정하십시오. -
Title 의 경우 체크아웃 결제 방법 섹션에 나타나는 레이블에 사용할 텍스트를 입력하십시오(기본값:
Local Payments
). -
Fallback Button Text 의 경우 고객을 웹 사이트로 다시 안내하기 위해 대체 Braintree 페이지에 나타나는 단추에 사용할 텍스트를 입력하십시오(예:
Complete Checkout
). -
Redirect on Fail 에 로컬 결제 방법 트랜잭션이 취소되거나 실패하거나 오류가 발생할 때 고객을 리디렉션해야 하는 URL을 입력하십시오. 결제 페이지(예:
https://www.domain.com/checkout#payment
)여야 합니다. -
Allowed Payment Methods 에 대해 사용할 로컬 결제 방법을 선택하십시오.
옵션:
Bancontact
/EPS
/giropay
/iDeal
/Klarna Pay Now
/SOFORT
/MyBank
/P24
/SEPA/ELV Direct Debit
(아직 지원되지 않음){width="600" modal="regular"}
note note NOTE 번들 Braintree 확장은 Braintree 개발자 설명서에 나열된 모든 로컬 결제 방법을 지원하지 않습니다. 다른 로컬 결제 방법은 향후 릴리스에서 지원될 예정입니다. -
Sort Order 의 경우 체크아웃 중에 다른 결제 옵션과 함께 나열될 때 로컬 결제 방법이 표시되는 순서를 결정하려면 숫자를 입력하십시오.
9단계: Braintree 설정을 통해 Google Pay 완료
-
Google Pay을(를) Braintree 결제 옵션으로 포함하려면 Enable GooglePay Through Braintree 을(를)
Yes
(으)로 설정하십시오. -
고객이 Google Pay를 사용하여 구매할 때마다 다시 입력할 필요가 없도록 고객 정보를 안전하게 저장하려면 Enable Vault for GooglePay 을(를)
Yes
(으)로 설정하십시오. -
Payment Action 을(를) 다음 중 하나로 설정합니다.
Authorize Only
- 구매를 승인하고 자금을 보류합니다. 판매자가 판매를 캡처 할 때까지 고객의 은행 계좌에서 금액이 인출되지 않습니다.Intent Sale
- 구매 금액이 승인되어 고객 계정에서 즉시 인출됩니다.
-
Button Color 을(를) 설정하여 Google Pay 단추의 색을 결정합니다.
White
또는Black
-
Merchant ID 의 경우 MerchantID(Google 제공)를 입력하십시오.
-
Accepted Cards 의 경우 고객이 Google Pay을(를) 사용하여 주문하는 데 사용할 수 있는 카드 유형을 선택하십시오.
옵션:
Visa
/MasterCard
/AMEX
/Discover
/JCB
-
Sort Order 의 경우 체크아웃 중에 다른 결제 옵션과 함께 나열될 때 Google Pay이(가) 표시되는 순서를 확인하려면 숫자를 입력하세요.
10단계: Braintree 설정을 통해 Venmo 완료
-
Venmo를 Braintree 결제 옵션으로 포함하려면 Enable Venmo through Braintree 을(를)
Yes
(으)로 설정하십시오. -
Enable Vault for Venmo 을(를)
Yes
(으)로 설정하여 고객의 Venmo 계정을 저장할 수 있도록 하여 고객이 향후 트랜잭션을 위해 Venmo 계정에 다시 로그인할 필요가 없도록 합니다.{width="600" modal="regular"}
-
Payment Action 을(를) 다음 중 하나로 설정합니다.
Authorize Only
- 구매를 승인하고 자금을 보류합니다. 판매자가 판매를 캡처 할 때까지 고객의 은행 계좌에서 금액이 인출되지 않습니다.Intent Sale
- 구매 금액이 승인되어 고객 계정에서 즉시 인출됩니다.
-
Sort Order 의 경우 체크아웃 중에 다른 결제 옵션과 함께 나열될 때 Venmo가 표시되는 순서를 확인하려면 숫자를 입력하세요.
11단계: Braintree 설정을 통해 PayPal 완료
-
PayPal을 Braintree 결제 옵션으로 포함하려면 Enable PayPal through Braintree 을(를)
Yes
(으)로 설정하십시오. -
Braintree 결제 방법을 통해 PayPal을 지정하십시오.
note note NOTE PayPal Credit 또는 PayPal PayLater 을(를) 사용하도록 설정할 수 있습니다. 두 메서드를 동시에 활성화할 수 없습니다. -
PayPal Credit을(를) Braintree 결제 옵션으로 포함하려면 Enable PayPal Credit through Braintree 을(를)
Yes
(으)로 설정하십시오.Braintree을 통해 PayPal 사용 을(를)
Yes
(으)로 설정하면 이 필드만 표시됩니다.note note NOTE PayPal 크레딧은 미국과 영국에서만 사용할 수 있습니다. Merchant Country 필드에 대해 선택한 값이 US
또는UK
이(가) 아닌 경우 PayPal 크레딧을 사용할 수 없습니다. -
PayPal PayLater을(를) Braintree 결제 옵션으로 포함하려면 Enable PayPal PayLater through Braintree 을(를)
Yes
(으)로 설정하십시오.Enable PayPal PayLater through Braintree 을(를)
Yes
(으)로 설정하면 이 필드만 표시됩니다.3 에서 지불(Pay in 3)과 같은 오퍼에 대해 사이트에 PayLater 메시지를 표시하여 고객이 무이자 월별 3회 지불로 결제할 수 있습니다. Braintree 통합은 이 기능을 홍보하기 위해 사이트에 메시지를 표시할 수 있습니다. 다른 콘텐츠, 마케팅 또는 자료와 함께 PayLater 오퍼를 홍보할 수 없습니다.
-
-
Title 의 경우 체크아웃 중에 PayPal로 결제 Braintree 옵션을 식별하는 제목을 입력하십시오.
-
Vault Enabled 을(를)
Yes
(으)로 설정하여 고객의 PayPal 계정을 저장하는 보안 자격 증명 모음을 사용하도록 설정합니다. 저장된 PayPal 계정은 향후 거래에 사용할 수 있으며, 이렇게 하면 고객의 단계 수가 줄어듭니다. -
Send Cart Line Items for PayPal 을(를)
Yes
(으)로 설정하여 PayPal에 기프트 카드, 항목에 대한 선물 포장, 주문에 대한 선물 포장, 스토어 크레딧, 배송 및 세금과 함께 라인 항목(주문 항목)을 보냅니다. -
Sort Order 의 경우 체크아웃 중에 다른 결제 옵션과 함께 나열될 때 Braintree PayPal 결제 옵션이 표시되는 순서를 결정하려면 숫자를 입력하십시오.
-
판매자 이름을 스토어 구성에 정의된 것과 다르게 표시하려면 Override Merchant Name 필드에 표시할 이름을 입력하십시오.
-
Payment Action 을(를) 다음 중 하나로 설정합니다.
Authorize Only
- 구매를 승인하고 자금을 보류합니다. 판매자가 판매를 캡처 할 때까지 고객의 은행 계좌에서 금액이 인출되지 않습니다.Authorize and Capture
- 구매 금액이 승인되어 고객 계정에서 즉시 인출됩니다.
-
PayPal에서 처리하는 Braintree 트랜잭션에 대해 Payment from Applicable Countries 을(를) 다음 중 하나로 설정합니다.
All Allowed Countries
- 스토어 구성에 지정된 모든 국가의 고객이 이 결제 방법을 사용할 수 있습니다.Specific Countries
- 이 옵션을 선택하면 Payment from Specific Countries 목록이 나타납니다. Ctrl 키(PC) 또는 Command 키(Mac)를 누른 채로 목록에서 고객이 스토어에서 구매할 수 있는 각 국가를 선택합니다.
-
고객이 청구 주소를 제공하도록 하려면 Require Customer’s Billing Address 을(를)
Yes
(으)로 설정하십시오.note note NOTE 이 기능은 PayPal 기술 지원에서 계정에 대해 활성화해야 합니다. -
Braintree을 통해 스토어와 PayPal 간의 상호 작용에 대한 로그 파일을 저장하려면 Debug 을(를)
Yes
(으)로 설정합니다. -
미니 장바구니와 장바구니 페이지 모두에 PayPal 단추를 표시하려면 Display on Shopping Cart 을(를)
Yes
(으)로 설정하십시오.
12단계: 스타일 설정 설정
-
Location 의 경우 PayPal 단추 및 메시지를 렌더링할 위치를 선택하십시오.
Mini-Cart and Cart Page
,Checkout Page
또는Product Page
{width="600" modal="regular"}
Mini-Cart and Cart Page
이 섹션의 옵션 및 설정은 Location 필드의 설정에 따라 다릅니다.
- PayPal Button Type 을(를) 다음 세 가지 유형의 단추 중 하나로 설정합니다.
PayPal Button
/PayPal Pay Later Button
/PayPal Credit Button
PayPal Button
이 섹션의 옵션 및 설정은 PayPal Button Type 필드에서 선택한 단추 유형에 따라 다릅니다.
-
선택한 위치의 상점 앞에 PayPal 단추를 표시하려면 Show PayPal Button 을(를)
Yes
(으)로 설정하십시오. -
Button Label 에 대해 PayPal 단추 레이블
Paypal
,Checkout
,Buynow
또는Pay
을(를) 선택하십시오. -
Color 의 경우 PayPal 단추 색상:
Blue
,Black
,Gold
또는Silver
을(를) 선택하십시오. -
Shape 에 대해 PayPal 단추 셰이프
Pill
또는Rectangle
을(를) 선택하십시오. -
Size (Deprecated) 의 경우 PayPal 단추 크기(
Medium
,Large
또는Responsive
)를 선택하십시오.
PayLater Messaging
-
선택한 위치의 상점 앞에 PayLater 메시지를 표시하려면 Show PayLater Messaging 을(를)
Yes
(으)로 설정하십시오.이 메시지에는 사용 가능한 오퍼에 대한 PayLater 메시지가 표시됩니다(제한 적용).
-
Message Layout 의 경우 PayLater 메시지 레이아웃을 선택하십시오.
Text
또는Flex
-
Logo 의 경우 PayPal 로고 형식(
Inline
,Primary
,Alternative
또는None
)을 선택하십시오. -
Logo Position 의 경우 PayPal 로고 위치:
Left
,Right
또는Top
을(를) 선택하십시오. -
Text Color 의 경우 PayLater 메시지 텍스트 색(
Black
,White
,Monochrome
또는Grayscale
)을 선택하십시오.
이러한 옵션이 설정되면 PayPal 버튼과 PayLater 메시지의 미리 보기를 볼 수 있습니다. 설정을 적용하거나 값을 재설정하는 데 사용할 수 있는 컨트롤이 있습니다.
-
단추 및 PayLater 메시지에 대해 선택한 스타일 설정을 저장하고 현재 위치 및 현재 단추 유형에 적용하려면 Apply 을(를) 클릭합니다.
-
단추 및 PayLater 메시지 값에 대해 선택한 스타일 설정을 저장하고 모든 단추 유형 및 위치에 적용하려면 Apply to All Buttons 을(를) 클릭합니다.
-
단추 및 PayLater 메시지에 대한 권장 기본값으로 스타일 설정을 반환하고 모든 단추 유형 및 위치에 적용하려면 Reset to Recommended Defaults 을(를) 클릭합니다.
13단계: 3D 확인 설정 완료
-
인증 프로그램(예: VISA에서 확인)에 등록된 신용 카드를 사용하는 고객에 대한 인증 단계를 추가하려면 3D Secure Verification 을(를)
Yes
(으)로 설정하십시오.이 프로세스 중에 검증을 위해 제출된 트랜잭션 금액이 승인을 위해 전송된 금액과 대조됩니다.
-
모든 트랜잭션에 대해 항상 3D 보안 요청에 도전하려면 Always request 3DS 을(를)
Yes
(으)로 설정합니다. -
Threshold Amount 의 경우 3D 확인을 트리거하는 데 필요한 최소 주문 수량을 입력하십시오.
-
Verify for Applicable Countries 을(를) 다음 중 하나로 설정합니다.
All Allowed Countries
- 스토어 구성에 지정된 모든 국가의 고객이 이 결제 방법을 사용할 수 있습니다.Specific Countries
- 이 옵션을 선택하면 Verify for Specific Countries 목록이 나타납니다. Ctrl 키(PC) 또는 Command 키(Mac)를 누른 채로 목록에서 고객이 스토어에서 구매할 수 있는 각 국가를 선택합니다.
{width="600" modal="regular"}
14단계: Braintree 동적 설명자 설정
다음 설명자는 고객 신용 카드 명세서에서의 구매를 식별하는 데 사용됩니다. 각 구매와 연관된 회사를 명확하게 식별하여 충전의 수를 줄일 수 있습니다. 계정에 대해 동적 설명자가 활성화되지 않은 경우 Braintree 지원 센터에 문의하십시오.
-
다음 지침에 따라 Name, Phone 및 URL 에 대한 동적 설명자를 입력하십시오.
-
Name - 이름 설명자에 별표(*)로 구분된 두 부분이 있습니다. For example:
company*myproduct
설명자의 첫 번째 부분은 회사 또는 DBA를 식별하고 두 번째 부분은 제품을 식별합니다. 설명자의
company
및product
부분의 길이는 최대 22자의 조합 길이에 대해 다음과 같은 방법으로 할당할 수 있습니다.이름 설명자의 문자
옵션 1:
Company
은(는) 3자여야 하며Product
은(는) 최대 18자일 수 있습니다.옵션 2:
Company
은(는) 7자여야 하며Product
은(는) 최대 14자일 수 있습니다.옵션 3:
Company
은(는) 12자여야 하며Product
은(는) 9자까지 가능합니다. -
Phone - 전화 설명자 길이는 10~14자여야 하며 숫자, 대시, 괄호 및 마침표만 포함할 수 있습니다. For example:
9999999999
(999) 999-9999
999.999.9999
-
URL - URL 설명자는 도메인 이름을 나타내며 최대 13자까지 가능합니다. For example:
company.com
-
-
Braintree 구성이 완료되면 Save Config 을(를) 클릭합니다.
2.4 업그레이드 정보
Adobe Commerce 및 Magento Open Source 2.4.0부터 Braintree 확장이 릴리스에 포함됩니다. Marketplace Braintree 확장이 설치된 2.4.0 이전 버전에서 Commerce 2.4.x로 마이그레이션하는 경우 해당 확장(paypal/module-braintree
또는 gene/module-braintree
)을 제거하고 Magento_Braintree
대신 PayPal_Braintree
네임스페이스를 사용하도록 코드 사용자 지정을 업데이트해야 합니다. Commerce Marketplace에 배포되는 핵심 Commerce Braintree 결제 번들 확장 기능 및 확장 기능의 구성 설정이 유지되며 이전 버전과 함께 배치된 결제는 정상적으로 캡처, 무효화 또는 환급될 수 있습니다.