샌드박스는 Google 월렛의 ID 서비스 테스트 환경입니다. 실제 ID 대신 테스트 ID를 사용하므로 프로덕션 데이터를 건드리지 않고 통합을 빌드하고 디버그할 수 있습니다.
기본적으로 Google 월렛은 리얼 ID를 사용하여 프로덕션 모드에서 실행됩니다. 이 단계에서는 테스트 기기를 샌드박스 모드로 전환하고 샌드박스 요청 및 응답을 위해 서버를 구성합니다.
과정 선택하기 RP, VR 또는 오프라인
이 페이지의 단계
시작하기 전에
- 초기화할 수 있는 Android 기기 샌드박스로 전환하면 기기의 기존 프로덕션 월렛 데이터가 삭제되므로 개인 휴대전화를 사용하지 마세요.
- 해당 기기의 Google 월렛에 로그인된 @gmail.com Google 계정
- 검증자 등록기관만 해당: Google에서 샌드박스 루트 CA를 샌드박스 트러스트 저장소에 추가할 수 있도록 샌드박스 및 프로덕션 루트 CA 인증서와 함께 검증자 등록기관 온보딩 접수 양식을 제출합니다. 5.A단계: 접수 양식, 루트 인증서 제출 및 서비스 약관 동의를 참고하세요.
A단계: 테스트 계정의 샌드박스 액세스 권한 요청
샌드박스와 프로덕션 간에 전환하는 옵션은 기본적으로 숨겨져 있습니다. 테스트 기기에서 전환 버튼을 사용 설정하려면 Google 계정을 샌드박스 허용 목록에 추가해야 합니다.
- Google 월렛에서 사용하는 Google 계정으로 Google Pay 샌드박스 액세스 요청 양식을 작성합니다.
- 디지털 신분증이 아직 공식적으로 출시되지 않은 국가 또는 지역에서 테스트하는 경우 테스트 계정의 Gmail 주소를
wallet-identity-rp-support@google.com로 이메일로 보내세요.
B단계: 기기를 샌드박스 모드로 전환하기
- Android 테스트 기기에서 설정 앱을 엽니다.
- 화면 상단에서 Google 계정 / 프로필 사진을 탭합니다(이름과 'Google 서비스 및 환경설정'이 표시됨).
- 메시지가 표시되면 프로필을 선택한 다음 모든 서비스를 탭합니다.
- 기타 카테고리로 이동하여 TapAndPay Environment를 탭합니다. TapAndPay Environment가 표시되지 않으면 기기를 재부팅하고 1단계부터 다시 시작합니다. 여전히 누락된 경우 계정이 샌드박스 허용 목록에 있는지 확인합니다 (A단계).
드롭다운 메뉴를 탭하고 SANDBOX를 선택합니다.

환경이 변경되었다는 대화상자가 표시됩니다. 확인을 탭하고 기기를 재부팅합니다.

재부팅 후 Google 월렛을 엽니다. 다음 대화상자가 표시되면 Google 월렛을 강제 종료하고 다시 열어 샌드박스 환경에 동기화합니다.

C단계: 기기가 샌드박스 모드인지 확인하기
- Google 월렛 앱 을 엽니다.
- 오른쪽 상단에서 프로필 사진 또는 계정 > 월렛 설정을 탭합니다.
- 페이지 하단으로 이동합니다. SANDBOX라는 확인 메시지가 표시되면 기기가 샌드박스 호출용으로 구성된 것입니다. 메시지가 표시되지 않으면 프로덕션 모드입니다.
일부 기기에서는 Google 설정에 Google 월렛이 표시되지 않습니다. 이러한 기기에서 Google 월렛 설정을 열려면 다음 명령어와 함께 adb를 사용하세요.
adb shell am start -n com.google.android.gms/com.google.android.gms.tapandpay.settings.TapAndPaySettingsActivity
프로덕션으로 다시 전환
B단계를 반복하되 SANDBOX 대신 PRODUCTION을 선택합니다.
Wear OS 기기
연결된 Wear OS 기기에서 샌드박스 모드를 사용 설정하려면 빈 파일을 추가하고 재부팅합니다.
adb shell touch /sdcard/Download/android_pay_env_override_sandboxadb reboot
프로덕션으로 다시 전환하려면 파일을 삭제하고 재부팅합니다.
adb shell rm /sdcard/Download/android_pay_env_override_sandboxadb reboot
D단계: 샌드박스용 서버 구성

샌드박스에서 서버에는 다음 두 가지가 필요합니다.
- Google 월렛의 샌드박스에서 신뢰하는 서명 사용자 인증 정보를 요청합니다.
- 신뢰 당사자: Google의 사전 신뢰 샌드박스 테스트 키 쌍과 다음 샘플 메타데이터를 사용합니다. 양식을 제출하지 않아도 됩니다.
- 검증 도구 등록기관: 자체 샌드박스 루트 CA에서 발급한 리프 인증서로 요청에 서명하고 (Google에서 샌드박스 트러스트 저장소에 추가한 후) 3.A단계: CA 인증서 프로필 및 CBOR 메타데이터 구성에 설명된 대로 자체
gw_rp_metadata_bytes를 생성합니다.
- 응답 확인 신뢰 앵커: 신뢰 당사자와 인증자 등록기관 모두 샌드박스 테스트 ID의 응답을 검증하기 위해 서버의 트러스트 저장소에 Utopia 샌드박스 인증서를 추가해야 합니다.
샌드박스 테스트 키 및 메타데이터 (신뢰 당사자)
자체 프로덕션 키를 등록하지 않고 샌드박스 환경에서 서명된 요청을 테스트하려면 다음 테스트 키 쌍을 사용하면 됩니다. 이러한 키는 샌드박스 환경에서 사전 신뢰됩니다.
안내
- 테스트 비공개 키를 사용하여 요청 (JWS)에 서명합니다.
- 요청의
x5c헤더에 테스트 공개 인증서를 삽입합니다. client_id를 이 인증서의x509_hash로 설정합니다. 해시 계산에 관한 자세한 내용은 서명된 요청을 참고하세요.client_metadata의gw_rp_metadata_bytes를 다음 테스트 Relying Party Metadata (Base64url CBOR)로 설정합니다.
비공개 키 (PEM):
-----BEGIN PRIVATE KEY----- MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQggRmIZIHQhXcYIeZ7 KSqS/WwJrsOetdI8ZE4HG0fd+3uhRANCAAR3GR6mdt/NOErO7+XtKqo7orgXWPMI jEQDeE1PP4KWXTBAhuewPvF8uOiYakz5Jqd1kEFKfiecZEZRrLnC7U+e -----END PRIVATE KEY-----
신뢰 당사자 메타데이터 (Base64url CBOR):
2BhY56Juc2NoZW1hX3ZlcnNpb25idjFnZGlzcGxheaNsZGlzcGxheV9uYW1leBhURVNUIFVTRSBPTkxZIFNhbmRib3ggUlBobG9nb191cml4YWh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9pL3Byb2R1Y3Rsb2dvcy9nb29nbGVnL3Y2L3dlYi02NGRwL2xvZ29fZ29vZ2xlZ19jb2xvcl8xeF93ZWJfNjRkcC5wbmdycHJpdmFjeV9wb2xpY3lfdXJpeCNodHRwczovL3BvbGljaWVzLmdvb2dsZS5jb20vcHJpdmFjeQ
신뢰 당사자 메타데이터 (CBOR 덤프):
#24# .bstr
{
"schema_version": "v1",
"display": {
"display_name": "TEST USE ONLY Sandbox RP",
"logo_uri": "https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-64dp/logo_googleg_color_1x_web_64dp.png",
"privacy_policy_uri": "https://policies.google.com/privacy"
}
}공개 인증서 (PEM):
Certificate: Data: Version: 3 (0x2) Serial Number: 97:99:aa:8b:09:93:5a:20:c1:8b:27:6c:e2:da:91:97:f2:b7:79:8d Signature Algorithm: ecdsa-with-SHA256 Issuer: O=Google, OU=Wallet, CN=TEST USE ONLY Sandbox RP Validity Not Before: Jun 2 00:39:54 2026 GMT Not After : Jun 2 00:39:54 2027 GMT Subject: O=Google, OU=Wallet, CN=TEST USE ONLY Sandbox RP Subject Public Key Info: Public Key Algorithm: id-ecPublicKey Public-Key: (256 bit) pub: 04:77:19:1e:a6:76:df:cd:38:4a:ce:ef:e5:ed:2a: aa:3b:a2:b8:17:58:f3:08:8c:44:03:78:4d:4f:3f: 82:96:5d:30:40:86:e7:b0:3e:f1:7c:b8:e8:98:6a: 4c:f9:26:a7:75:90:41:4a:7e:27:9c:64:46:51:ac: b9:c2:ed:4f:9e ASN1 OID: prime256v1 NIST CURVE: P-256 X509v3 extensions: X509v3 Subject Key Identifier: 29:CA:DA:07:9B:1F:68:FA:80:01:E1:68:E3:38:E8:5A:5C:28:B1:6A X509v3 Authority Key Identifier: 29:CA:DA:07:9B:1F:68:FA:80:01:E1:68:E3:38:E8:5A:5C:28:B1:6A X509v3 Basic Constraints: critical CA:TRUE 1.3.6.1.4.1.11129.10.1: . ...?..!H.Z\j...uT2. .u.:.O.... 0 Signature Algorithm: ecdsa-with-SHA256 Signature Value: 30:46:02:21:00:91:94:fa:b9:85:82:92:bd:6a:98:44:73:ec: 30:26:1f:92:01:8f:5b:06:d7:8f:21:34:dc:76:f0:89:3c:04: 8c:02:21:00:ae:3e:9d:46:99:bd:63:7a:cc:59:30:66:48:d0: 75:cc:c9:82:07:ca:39:f1:f0:df:2b:07:7b:32:b9:5b:3f:0a -----BEGIN CERTIFICATE----- MIICFDCCAbmgAwIBAgIVAJeZqosJk1ogwYsnbOLakZfyt3mNMAoGCCqGSM49BAMC MEUxDzANBgNVBAoMBkdvb2dsZTEPMA0GA1UECwwGV2FsbGV0MSEwHwYDVQQDDBhU RVNUIFVTRSBPTkxZIFNhbmRib3ggUlAwHhcNMjYwNjAyMDAzOTU0WhcNMjcwNjAy MDAzOTU0WjBFMQ8wDQYDVQQKDAZHb29nbGUxDzANBgNVBAsMBldhbGxldDEhMB8G A1UEAwwYVEVTVCBVU0UgT05MWSBTYW5kYm94IFJQMFkwEwYHKoZIzj0CAQYIKoZI zj0DAQcDQgAEdxkepnbfzThKzu/l7SqqO6K4F1jzCIxEA3hNTz+Cll0wQIbnsD7x fLjomGpM+SandZBBSn4nnGRGUay5wu1PnqOBhTCBgjAdBgNVHQ4EFgQUKcraB5sf aPqAAeFo4zjoWlwosWowHwYDVR0jBBgwFoAUKcraB5sfaPqAAeFo4zjoWlwosWow DwYDVR0TAQH/BAUwAwEB/zAvBgkrBgEEAdZ5CgEEIgQg5taUP70bIUiJWlxqkwYP dVQyoyCvdaw62E8u4ASBIDAwCgYIKoZIzj0EAwIDSQAwRgIhAJGU+rmFgpK9aphE c+wwJh+SAY9bBtePITTcdvCJPASMAiEArj6dRpm9Y3rMWTBmSNB1zMmCB8o58fDf Kwd7MrlbPwo= -----END CERTIFICATE-----
샌드박스 IACA 루트 인증서 (모든 파트너)
샌드박스에서 프로비저닝된 테스트 ID는 Google의 샌드박스 발급 기관 (Utopia)에서 서명합니다. 샌드박스 테스트 신분증 패스에서 반환된 응답의 issuerAuth 서명을 암호화 방식으로 검증하려면 이 루트 인증서를 인증자의 트러스트 저장소에 추가하세요 (프로덕션에서는 신뢰하지 마세요).
| 환경 | 발급기관 / 국가 | 사용자 인증 정보 유형 | IACA 루트 인증서 |
|---|---|---|---|
| 샌드박스 | Utopia | 신분증 패스 (com.google.wallet.idcard.1) |
Utopia Sandbox 인증서 다운로드 |
지원되는 미국 주 및 국가의 프로덕션 IACA 루트 인증서는 지원되는 발급기관 및 IACA 인증서를 참고하세요.
샌드박스 업타임
샌드박스 환경에는 프로덕션 환경과 같은 업타임 SLA가 없습니다. 샌드박스 중단과 관련된 것으로 의심되는 오류가 발생하면 미국 영업일 기준 하루 동안 기다린 후 Google에 문의하세요. 서비스 중단은 일반적으로 이 기간 내에 해결됩니다. 다운타임이 발생할 수 있으므로 중요한 출시 프로세스가 샌드박스 환경에 종속되도록 설계하지 마세요.