타사 결제 게이트웨이 설정
자체 타사 결제 게이트웨이를 가져와 결제를 처리하고 환불을 이행합니다. 외부 결제 게이트웨이를 설정하고 추가한 다음, 청구에 연결합니다.
필수 Edition
| 제공 제품: Lightning Experience |
| 지원 제품: Enterprise, Performance, Unlimited 및 Developer Edition, Revenue Cloud |
| Salesforce 결제 기능은 네이티브 및 자체 결제 게이트웨이 모두에서 트랜잭션 모델당 비용을 지불하는 Revenue Cloud Billing 라이센스와 함께 사용할 수 있습니다. 자세한 내용은 Salesforce 계정 담당자에게 문의하십시오. |
| 2025년 7월 이전에 Revenue Cloud Billing 라이센스를 구매한 경우 Salesforce 계정 담당자에게 문의하여 기존 라이센스에 Salesforce 결제 기능을 추가하십시오. |
| 필요한 사용자 권한 | |
|---|---|
| 타사 결제 기능 구성: | 결제 관리자 권한 집합 |
타사 결제 게이트웨이 구성을 위한 초기 설정
타사 결제 게이트웨이를 구성하기 전에 Salesforce 조직과 선호하는 타사 결제 게이트웨이 간 연결을 설정하는 준비 과업을 완료합니다. 시작하려면 다음 세부 사항이 필요합니다.
- 전자상거래 판매자 계정 및 API 키
- Apex 클래스 어댑터 및 어댑터 이름
- 타사 결제 게이트웨이를 인증하는 명명된 자격 증명
- Salesforce 조직에 등록된 타사 결제 게이트웨이 사이트
- 타사 결제 게이트웨이에 대한 액세스 권한이 있는 Salesforce 사이트
-
구현할 타사 결제 게이트웨이에서 전자상거래 판매자 계정을 만듭니다.
- 타사 결제 게이트웨이 공급자에 로그인하고 전자상거래 판매자 계정을 추가합니다.
-
선택한 결제 게이트웨이 플랫폼의 키 관리, 개발자 또는 고급 설정 섹션으로 이동하여 API 키 또는 암호 키를 생성합니다.
API 키는 다음과 같이 표시됩니다.
AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU. - 판매자 계정 사용자 이름 및 API 키를 기록합니다. 명명된 자격 증명을 만들려면 사용자가 필요합니다.
-
Salesforce 조직에서 결제 게이트웨이 Apex 클래스를 만듭니다.
-
결제 게이트웨이 공급자 또는 AppExchange 어댑터 클래스 세부 사항을 가져옵니다.
결제 게이트웨이 어댑터를 구축하고 설정하려면 결제 게이트웨이 어댑터를 참조하십시오. Apex 클래스를 정의하려면 Commerce 결제 네임스페이스를 참조하십시오.
- Apex 클래스를 저장합니다. 결제 게이트웨이 공급자를 만들기 위해 필요한 어댑터 이름을 기록합니다.
-
결제 게이트웨이 공급자 또는 AppExchange 어댑터 클래스 세부 사항을 가져옵니다.
-
Salesforce 조직에서 레거시 명명된 자격 증명을 만들면 인증 매개 변수와 Apex 콜아웃 끝점의 URL을 지정할 수 있습니다.
- 레이블에 대한 사용자에게 친숙한 이름 및 이름에 대한 고유 식별자를 지정합니다.
- 타사 결제 게이트웨이의 URL을 입력합니다.
- ID 유형으로 명명된 주체를 선택하고 인증 프로토콜로 암호 인증을 선택합니다.
- 판매자 계정 사용자 이름을 사용자 이름으로 사용합니다. 결제 게이트웨이 공급자가 요구하는 대로 API 키를 암호로 사용합니다.
- 결제 게이트웨이를 만들기 위해 필요한 이름이 지정된 자격 증명을 저장합니다.
-
Salesforce 조직에서 타사 결제 게이트웨이 사이트를 등록하여 조직에서 결제 게이트웨이 사이트로 Apex 콜아웃이 성공하는지 확인합니다.
- 타사 결제 게이트웨이의 이름 및 URL을 입력합니다.
- 사이트를 활성 상태로 표시하고 변경 사항을 저장합니다.
-
타사 결제 게이트웨이 URL을 Salesforce 조직에서 신뢰할 수 있는 URL로 추가합니다.
- API 이름을 입력합니다.
- 타사 결제 게이트웨이의 URL을 입력합니다.
- URL을 활성으로 표시하고 변경 사항을 저장합니다.
-
타사 게이트웨이에서 결제 알림을 보내고 받을 수 있도록 Salesforce 사이트를 활성화하고 설정합니다.
- 사이트의 레이블, 이름 및 홈페이지를 입력합니다.
- 사이트의 공용 액세스 설정을 결제 API에 대한 게스트 액세스로 설정합니다.
- 사이트 세부 사항을 저장합니다.
타사 결제 게이트웨이에서 알림 설정 구성
결제 게이트웨이는 웹후크를 사용하여 결제 게이트웨이 어댑터에 알림을 보냅니다. 웹후크는 사이트 끝점과 결제 게이트웨이 공급자의 ID의 조합입니다. 타사 결제 게이트웨이의 표준 알림 전송 설정에 URL을 제공하여 웹후크를 만듭니다.
-
이 URL을 사이트의 끝점으로 사용하여
MyDomainName를 사이트의 도메인 및 URL로 대체합니다. 예:https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify -
결제 게이트웨이 공급자의 ID를 찾고 끝점에
?provider=ID쿼리 매개 변수를 추가합니다. 예:https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM - 타사 결제 게이트웨이의 표준 알림 설정에 웹후크를 입력합니다.
결제 게이트웨이 공급자 및 결제 게이트웨이 구성
판매자 계정, 어댑터 클래스, Salesforce 사이트를 설정한 후 결제 게이트웨이 공급자를 추가합니다. 그런 다음, 결제 게이트웨이 공급자에 결제 게이트웨이를 추가합니다.
- 설정에서 빠른 찾기 상자에 청구를 입력한 다음, 안내 설정에서 단계 7: 결제 구성을 선택합니다.
-
타사 결제 게이트웨이 구성 단계를 확장하고 결제 게이트웨이 구성을 클릭한 다음, 구성을 클릭합니다.
노트Winter '26에 생성된 Salesforce 조직의 경우 기본적으로 사용자를 결제 게이트웨이 구성 탭으로 리디렉션하는 7단계: 청구 안내 설정의 결제 구성 버튼을 사용할 수 있습니다. Winter ’26 이전에 생성된 Salesforce 조직의 경우 결제 게이트웨이 구성 탭을 기본적으로 사용할 수 없습니다. 이 문제를 해결하려면 결제 게이트웨이 구성 탭의 설정을 기본값 설정으로 변경합니다.
-
다음 필드를 작성하여 결제 게이트웨이 공급자를 만듭니다.
- 결제 게이트웨이 공급자의 고유한 이름 및 레이블을 입력합니다.
- 드롭다운 목록에서 Apex 어댑터 클래스를 선택합니다.
- 자격 증명에 필요한 지원을 지정합니다. 자세한 내용은 Idempotency Guidelines를 참조하십시오.
- 결제 게이트웨이 공급자 세부 사항을 저장합니다.
-
다음 필드를 작성하여 결제 게이트웨이를 추가합니다.
- 결제 게이트웨이의 고유 이름을 입력합니다.
- 드롭다운 목록에서 결제 게이트웨이 공급자를 선택합니다.
- 드롭다운 목록에서 명명된 자격 증명을 선택합니다.
- 결제 게이트웨이 상태를 활성으로 표시합니다.
- 결제 게이트웨이 세부 사항을 저장합니다.
기존 결제 게이트웨이 공급자가 이미 있는 경우 안내 설정에서 단계 7: 결제 구성을 선택하고, 타사 결제 게이트웨이 구성 단계를 확장하고, 결제 게이트웨이 구성을 클릭합니다. 결제 게이트웨이 구성 페이지에서 결제 게이트웨이를 클릭한 다음, 새로 만들기를 클릭합니다. 구성 단계는 동일합니다.
다중 결제 방법 추가
타사 결제 게이트웨이에서 Automated Clearing House(ACH), Single Euro Payments Area(SEPA), Bankers' Automated Clearing Services(BACS), 대량 전자 결제 시스템(BECS)과 같은 결제 방법에 대한 지원을 구성합니다. 청구 프로필의 저장된 결제 방법 탭에서 결제를 처리하고 환불을 이행하고 저장된 결제 방법을 볼 수 있습니다.
-
ACH, SEPA, BACS 및 BECS와 같은 은행 결제 방법을 추가하려면 tokenizePaymentMethod API를 사용하고
bankPaymentMethod개체의bankType속성을 선택한 은행 결제 방법으로 설정합니다. -
신용 카드 또는 직불 카드와 같은 카드 결제 방법을 추가하려면 tokenizePaymentMethod API를 사용하고
cardPaymentMethod개체에서cardCategory속성을 설정합니다.

