Korumalı Alan Modu

Google Cüzdan, varsayılan olarak gerçek kimliklerle üretim modunda çalışır. Google Cüzdan'ı yeniden yapılandırarak sandbox modunda çalıştırabilirsiniz. İstekler, Google'ın korumalı alan ortamına yönlendirilir.

Geliştirme ve ön üretim testi sırasında korumalı alan modunu kullanmanızı öneririz. Hazır olduğunuzda cihazı tekrar üretim moduna geçirebilirsiniz.

Korumalı alanın çalışma süresi

Korumalı alan ortamında, üretim ortamımızdaki gibi çalışma süresi SLA'ları yoktur. Sandbox kesintisiyle ilgili olduğunu düşündüğünüz bir hatayla karşılaşırsanız bizimle iletişime geçmeden önce bir ABD iş günü bekleyin. Kesintiler genellikle bu süre içinde kendiliğinden çözülür. Olası kesinti nedeniyle, kritik yayın süreçlerinizin hiçbirini korumalı alan ortamına bağlı olacak şekilde tasarlamayın.

Android cihazda korumalı alan modunu etkinleştirme ve devre dışı bırakma

TapAndPay ortam ayarlarını kullanarak sandbox modunu etkinleştirebilirsiniz. Üretim moduna dönmek için aynı adımları uygulayın ancak sandbox yerine üretim'i seçin.

TapAndPay ortam ayarlarını kullanma

Koruma alanı modunu etkinleştirmek için aşağıdaki adımları uygulayın:

  1. Ayarlar uygulamasını açın.
  2. Ekranın en üst kısmında Google Hesabınıza / Profil Resminize dokunun (adınız ve "Google hizmetleri ve tercihleri" gösterilir).
  3. Seçenek sunulursa profilinizi seçin, ardından Tüm hizmetler'e dokunun.
  4. Diğer kategorisine gidin ve TapAndPay Environment'a dokunun. TapAndPay Environment'ı görmüyorsanız cihazınızı yeniden başlatın ve 1. adımdan itibaren işlemleri tekrarlayın.
  5. Açılır menüye dokunun ve SANDBOX'ı seçin.
    6. Ortam değişikliği onayının ekran görüntüsü
  6. Ortamın değiştiğini bildiren aşağıdaki iletişim kutusunu görmeniz gerekir. Tamam'a dokunun ve cihazınızı yeniden başlatın.
    7. Ortam değişikliği onayının ekran görüntüsü

Google Cüzdan ortamını senkronize etme

Yeniden başlattıktan sonra Google Cüzdan'ı açtığınızda aşağıdaki iletişim kutusunu görebilirsiniz. Bu durumda Google Cüzdan'ı durdurmaya zorlamanız ve yeniden açmanız gerekir:

Ortam değişikliği onayının ekran görüntüsü

Wear OS cihazda sandbox modunu etkinleştirme ve devre dışı bırakma

Bağlı bir Wear OS cihazda sandbox modunu etkinleştirmek için aşağıdaki örnekte gösterildiği gibi boş bir dosya ekleyip yeniden başlatın:

adb shell touch /sdcard/Download/android_pay_env_override_sandbox
adb reboot

Bağlı bir Wear OS cihazda tekrar üretim moduna geçmek için dosyayı silin ve cihazı yeniden başlatın. Aşağıdaki örnekte bu işlem gösterilmektedir:

adb shell rm /sdcard/Download/android_pay_env_override_sandbox
adb reboot

Android cihazınızın korumalı alan veya üretim modunda olup olmadığını kontrol etme

Android cihazınızın sandbox veya üretim modunda olup olmadığını görmek için aşağıdaki adımları uygulayın.

  1. Google Cüzdan uygulamasını açın.
  2. Sağ üstte, profil resminize veya hesabınıza > Cüzdan ayarları'na dokunun.
  3. Sayfanın en altına gidin. SANDBOX yazan bir onay mesajı görürseniz korumalı alan çağrıları yapacak şekilde yapılandırılmışsınızdır. Mesaj görmüyorsanız üretim çağrıları yapacak şekilde yapılandırılmışsınızdır.
Üretim modu
Şekil 1: Üretim modu
Korumalı alan modu
Şekil 2: Sandbox modu

Bazı cihazların Google Ayarları'nda Google Cüzdan bulunmaz. Google Cüzdan Ayarları'na erişmek için aşağıdaki komutla adb'yi kullanmanız gerekir:

adb shell am start -n com.google.android.gms/com.google.android.gms.tapandpay.settings.TapAndPaySettingsActivity

Korumalı alanda imzalı istekleri test etme

Kendi üretim anahtarlarınızı kaydetmeden korumalı alan ortamında imzalı istekleri test etmek için aşağıdaki test anahtarı çiftini kullanabilirsiniz. Bu anahtarlar, korumalı alan ortamında önceden güvenilir olarak kabul edilir.

Test Anahtarları

Özel Anahtar (PEM):

-----BEGIN PRIVATE KEY-----
MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQggRmIZIHQhXcYIeZ7
KSqS/WwJrsOetdI8ZE4HG0fd+3uhRANCAAR3GR6mdt/NOErO7+XtKqo7orgXWPMI
jEQDeE1PP4KWXTBAhuewPvF8uOiYakz5Jqd1kEFKfiecZEZRrLnC7U+e
-----END PRIVATE KEY-----

Relying Party Metadata (Base64url CBOR):

2BhY56Juc2NoZW1hX3ZlcnNpb25idjFnZGlzcGxheaNsZGlzcGxheV9uYW1leBhURVNUIFVTRSBPTkxZIFNhbmRib3ggUlBobG9nb191cml4YWh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9pL3Byb2R1Y3Rsb2dvcy9nb29nbGVnL3Y2L3dlYi02NGRwL2xvZ29fZ29vZ2xlZ19jb2xvcl8xeF93ZWJfNjRkcC5wbmdycHJpdmFjeV9wb2xpY3lfdXJpeCNodHRwczovL3BvbGljaWVzLmdvb2dsZS5jb20vcHJpdmFjeQ

Kimlik doğrulama hizmeti meta verileri (CBOR dökümü):

#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"
  }
}

Genel Sertifika (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-----

Talimatlar

  1. İsteğinizi (JWS) imzalamak için test özel anahtarını kullanın.
  2. Test ortak sertifikasını isteğinizin x5c üstbilgisine yerleştirin.
  3. client_id değerini bu sertifikanın x509_hash olarak ayarlayın. Karma hesaplama hakkında ayrıntılı bilgi için Online Kabul - İmzalı İstekler başlıklı makaleyi inceleyin.