샌드박스 모드로 카드 테스트
샌드박스 모드는 실제 결제 및 결제 거부를 제외한 결제 프로세스 관련 모든 기능을 지원하는 독립형 환경입니다. 토큰 입수 시 “mode”:“sandbox”를 전송하여 샌드박스에 액세스할 수 있습니다.
결제 UI를 열려면 이 링크를 사용하여 획득한 토큰을 지정합니다. https://sandbox-secure.xsolla.com/paystation4/?token={token}.
샌드박스 모드에서는 은행 카드로 결제하는 동안 다음과 같은 결제 UI 상호작용 시나리오를 테스트할 수 있습니다.
일회성 구매 테스트
테스트 결제 진행하기
- 샌드박스 모드로 결제 UI를 엽니다.
- 은행 카드 결제 방식을 선택합니다.
- 은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
- 지불을 클릭합니다.
카드 세부 정보 외에도 다음 조건 중 하나라도 충족하는 경우 우편번호를 지정해야 합니다.
- 사용자의 국가가 미국 또는 캐나다입니다.
- 은행 식별 번호(BIN)가 카드가 미국에서 발급되었음을 나타냅니다.
유효한 우편번호(예: 12345)를 지정할 수 있습니다. 이는 판매 세율을 결정하며 결제 테스트 진행에 영향을 주지 않습니다.
샌드박스 은행 카드 결제를 진행할 수 있는 통화: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
샌드박스 모드로 진행한 거래에 대한 수수료를 포함한 세부 정보 확인하기:
- 관리자 페이지를 엽니다.
- 계정 > 거래 레지스트리로 이동합니다.
- 테스트 거래 보기 상자를 확인합니다.
또한 관리자 페이지에서 지원 > 거래 검색 섹션의 거래 세부 정보를 확인하고 환불을 요청할 수 있습니다.
환불
- 환불 웹훅을 구성합니다.
- 성공적인 테스트 결제를 진행합니다.
- 환불 요청 API 메소드를 호출합니다.
결제 환불에 대한 알림이 웹훅 URL로 전송됩니다.
부분 환불
- 부분 환불 웹훅을 구성합니다.
- 성공적인 테스트 결제를 진행합니다.
- 부분 환불 요청 API 메소드를 호출합니다.
부분 결제 환불에 대한 알림이 웹훅 URL로 전송됩니다.
부정 결제 거래 차단하기
- AFS 거부 거래 웹훅을 구성합니다.
- 다음 카드로 테스트 결제를 진행합니다.
| 카드 | 나라 | 3-D Secure |
|---|---|---|
| 카드 번호: 5159084825528450 유효 기간: 12/40 CVV2: 3자리 카드 종류: Mastercard | 미국 | 아니요 |
Chargeback
은행 참여 없이 이 시나리오를 테스트하는 샌드박스 모드용 별도의 API 호출이 개발되었습니다.
지불 거절 테스트 방법:
- 환불 웹훅을 구성합니다.
- 성공적인 테스트 결제를 진행합니다.
- 지불 거절 API 메소드를 호출합니다.
다음 코드를 사용하는 환불 웹훅을 받게 됩니다.
| 코드 | 환불 이유 | 설명 |
|---|---|---|
| 2 | Chargeback | 거래 지불 거절이 요청되었습니다. |
저장된 카드 테스트
카드 저장
카드 저장을 테스트하는 2가지 방법:테스트 결제를 진행하는 동안 카드 저장
- 결제 계정 추가 웹훅을 구성합니다.
- 샌드박스 모드로 결제 UI를 엽니다.
- 은행 카드 결제 방식을 선택합니다.
- 은행 카드 세부 정보를 입력합니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
- 향후 결제를 위해 이 카드를 저장 상자를 선택 표시합니다.
- 지금 지불을 클릭합니다.
새 카드 추가에 대한 알림이 웹훅 URL로 전송됩니다.
저장된 방식 섹션에 저장된 카드가 표시됩니다.
카드 세부 정보 외에도 다음 조건 중 하나라도 충족하는 경우 우편번호를 지정해야 합니다.
- 사용자의 국가가 미국 또는 캐나다입니다.
- 은행 식별 번호(BIN)가 카드가 미국에서 발급되었음을 나타냅니다.
유효한 우편번호(예: 12345)를 지정할 수 있습니다. 이는 판매 세율을 결정하며 결제 테스트 진행에 영향을 주지 않습니다.
샌드박스 은행 카드 결제를 진행할 수 있는 통화: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
샌드박스 모드로 진행한 거래에 대한 수수료를 포함한 세부 정보 확인하기:
- 관리자 페이지를 엽니다.
- 계정 > 거래 레지스트리로 이동합니다.
- 테스트 거래 보기 상자를 확인합니다.
또한 관리자 페이지에서 지원 > 거래 검색 섹션의 거래 세부 정보를 확인하고 환불을 요청할 수 있습니다.
사용자 계정으로부터 카드 저장하기
- 결제 계정 추가 웹훅을 구성합니다.
- 샌드박스 모드로 결제 UI를 엽니다.
- 저장됨으로 이동합니다.
- 연필 모양 아이콘을 클릭한 후 새 방식 추가를 선택합니다.
- 은행 카드를 클릭합니다.
- 은행 카드 세부 정보를 입력합니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
- 저장을 클릭합니다.
새 카드 추가에 대한 알림이 웹훅 URL로 전송됩니다.
저장된 방식 섹션에 저장된 카드가 표시됩니다.
저장된 카드 삭제
저장된 카드 삭제를 테스트하는 2가지 방법:API를 통해 저장된 카드 삭제하기
카드 삭제에 대한 알림이 웹훅 URL로 전송됩니다.
결제 UI에서 저장된 카드 삭제하기
- 결제 계정 제거 웹훅을 구성합니다.
- 샌드박스 모드로 결제 UI를 엽니다.
- 저장됨으로 이동합니다.
- 연필 모양 아이콘을 클릭합니다.
- 방식 편집을 클릭합니다.
- 카드를 선택하고 휴지통 아이콘을 클릭합니다.
카드 삭제에 대한 알림이 웹훅 URL로 전송됩니다.
저장한 카드로 청구
저장된 카드로 결제를 테스트하는 방법:- 일회성 청구(예: 저장된 카드로 구매).
- 정기 청구(예: 정기 결제 비용 지불)를 모두 테스트할 수 있습니다.
API를 통해 저장한 카드로 청구하기
- 결제 웹훅을 구성합니다.
- 샌드박스 모드로 카드를 저장합니다.
- 저장한 정으로 청구 API 메소드를 호출합니다.
성공한 결제에 대한 알림이 웹훅 URL로 전송됩니다.
결제 UI에서 저장된 카드로 청구하기
- 결제 웹훅을 구성합니다.
- 샌드박스 모드로 카드를 저장합니다.
- 샌드박스 모드로 결제 UI를 엽니다.
- 저장한 결제 계정의 목록에서 해당하는 카드를 클릭합니다.
- 지불을 클릭합니다.
성공한 결제에 대한 알림이 웹훅 URL로 전송됩니다.
저장된 카드 목록 가져오기
- 샌드박스 모드로 카드를 저장합니다.
- 저장된 계정 가져오기 API 메소드를 호출합니다.
응답으로 마스킹된 데이터를 가져옵니다.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
