ধাপ ১: স্যান্ডবক্স সেট-আপ করা

স্যান্ডবক্স হল Google Wallet-এর পরিচয় পরিষেবার জন্য একটি টেস্ট এনভায়রনমেন্ট। এটি আসল আইডির পরিবর্তে টেস্ট আইডি ব্যবহার করে, যাতে আপনি প্রোডাকশন ডেটা স্পর্শ না করেই আপনার ইন্টিগ্রেশন তৈরি এবং ডিবাগ করতে পারেন।

ডিফল্ট হিসেবে, Google Wallet আসল ID সহ প্রোডাকশন মোডে চলে। এই ধাপে, আপনি একটি টেস্ট ডিভাইস স্যান্ডবক্স মোডে পরিবর্তন করেন এবং স্যান্ডবক্স অনুরোধ ও উত্তরের জন্য আপনার সার্ভার কনফিগার করেন।

এই পৃষ্ঠায় ধাপ

শুরু করার আগে

ধাপ ক: আপনার টেস্ট অ্যাকাউন্টের জন্য স্যান্ডবক্স অ্যাক্সেসের অনুরোধ করুন

স্যান্ডবক্স ও প্রোডাকশনের মধ্যে পরিবর্তন করার বিকল্প ডিফল্ট হিসেবে লুকানো থাকে। আপনার টেস্ট ডিভাইসে টগল চালু করতে, আপনার Google অ্যাকাউন্ট অবশ্যই স্যান্ডবক্সের অনুমোদিত তালিকায় যোগ করতে হবে:

  1. Google Wallet-এ আপনি যে Google অ্যাকাউন্ট ব্যবহার করেন সেটি দিয়ে Google Pay Sandbox অ্যাক্সেসের অনুরোধ ফর্ম পূরণ করুন।
  2. আপনি যদি এমন কোনও দেশ বা অঞ্চল থেকে পরীক্ষা করেন যেখানে ডিজিটাল আইডি এখনও আনুষ্ঠানিকভাবে লঞ্চ করা হয়নি, তাহলে আপনার টেস্ট অ্যাকাউন্টের Gmail আইডি wallet-identity-rp-support@google.com-এ ইমেল করুন।

ধাপ খ: আপনার ডিভাইস স্যান্ডবক্স মোডে পাল্টান

  1. আপনার Android টেস্ট ডিভাইসে সেটিংস অ্যাপ খুলুন।
  2. স্ক্রিনের একেবারে উপরে আপনার Google অ্যাকাউন্ট / প্রোফাইল ছবিতে ট্যাপ করুন (এটি আপনার নাম এবং "Google পরিষেবা এবং পছন্দ" দেখায়)।
  3. প্রম্পট করা হলে, আপনার প্রোফাইল বেছে নিন, তারপর সব পরিষেবা বিকল্পে ট্যাপ করুন।
  4. অন্যান্য বিভাগে গিয়ে TapAndPay Environment বিকল্পে ট্যাপ করুন। আপনি TapAndPay এনভায়রনমেন্ট দেখতে না পেলে, আপনার ডিভাইস রিবুট করুন এবং ধাপ ১ থেকে আবার শুরু করুন। এখনও না দেখতে পেলে, আপনার অ্যাকাউন্ট স্যান্ডবক্সের অনুমোদিত তালিকায় আছে কিনা তা যাচাই করুন (ধাপ ক)।
  5. ড্রপ-ডাউন মেনুতে ট্যাপ করে SANDBOX বেছে নিন।

    TapAndPay এনভায়রনমেন্ট বাছাইকারী

  6. একটি ডায়ালগ আপনাকে বিজ্ঞপ্তি দিয়ে জানায় যে এনভায়রনমেন্ট পরিবর্তন করা হয়েছে। ঠিক আছে বিকল্পে ট্যাপ করুন এবং আপনার ডিভাইস রিবুট করুন।

    এনভায়রনমেন্ট পরিবর্তনের কনফার্মেশন স্ক্রিনশট

  7. রিবুট করার পরে Google Wallet খুলুন। আপনি যদি নিম্নলিখিত ডায়ালগ দেখতে পান, তাহলে Google Wallet জোর করে বন্ধ করুন এবং আবার খুলুন যাতে এটি স্যান্ডবক্স এনভায়রনমেন্টের সাথে সিঙ্ক হয়:

    Google Wallet ডায়ালগ জোর করে বন্ধ করুন

ধাপ গ: আপনার ডিভাইস স্যান্ডবক্স মোডে আছে কিনা তা কনফার্ম করুন

  1. Google Wallet অ্যাপ খুলুন।
  2. স্ক্রিনের সবচেয়ে উপরে ডানদিকে, আপনার প্রোফাইল ছবি বা অ্যাকাউন্ট > Wallet সেটিংস বিকল্পে ট্যাপ করুন।
  3. পৃষ্ঠার একদম নিচে যান। আপনি যদি এমন কোনও কনফার্মেশন মেসেজ দেখতে পান যাতে SANDBOX লেখা আছে, তাহলে আপনার ডিভাইস স্যান্ডবক্স কলের জন্য কনফিগার করা আছে। আপনি কোনও মেসেজ দেখতে না পেলে, এটি প্রোডাকশন মোডে আছে।
প্রোডাকশন মোড
ছবি ১: প্রোডাকশন মোড
স্যান্ডবক্স মোড
ছবি ২: স্যান্ডবক্স মোড

কিছু ডিভাইসে Google সেটিংসে Google Wallet দেখা যায় না। ওইসব ডিভাইসে Google Wallet সেটিংস খুলতে, নিম্নলিখিত কমান্ডের সাথে adb ব্যবহার করুন:

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

প্রোডাকশনে ফিরে যান

ধাপ খ আবার করুন, তবে SANDBOX-এর পরিবর্তে PRODUCTION বেছে নিন।

Wear OS ডিভাইস

কানেক্ট করা Wear OS ডিভাইসে স্যান্ডবক্স মোড চালু করতে, একটি খালি ফাইল যোগ করুন এবং রিবুট করুন:

adb shell touch /sdcard/Download/android_pay_env_override_sandbox
adb reboot

প্রোডাকশনে ফিরে যেতে, ফাইলটি মুছে দিন এবং রিবুট করুন:

adb shell rm /sdcard/Download/android_pay_env_override_sandbox
adb reboot

ধাপ ঘ: স্যান্ডবক্সের জন্য আপনার সার্ভার কনফিগার করুন

টু-ওয়ে স্যান্ডবক্স কনফিগারেশন, যা আউটবাউন্ড সাইন-ইন করা OpenID4VP অনুরোধ এবং ইনবাউন্ড Utopia টেস্ট ক্রেডেনশিয়াল যাচাইকরণ দেখায়

স্যান্ডবক্সে আপনার সার্ভারের দুটি জিনিস প্রয়োজন:

  1. Google Wallet-এর স্যান্ডবক্সের মাধ্যমে বিশ্বস্ত সাইনিং ক্রেডেনশিয়ালের জন্য অনুরোধ করুন:
    • রিলাইং পার্টি: Google-এর আগে থেকে বিশ্বস্ত স্যান্ডবক্স টেস্ট কী পেয়ার এবং নিম্নলিখিত স্যাম্পেল মেটাডেটা ব্যবহার করুন। আপনাকে কোনও ফর্ম জমা দিতে হবে না।
    • যাচাইকারী রেজিস্ট্রার: আপনার নিজস্ব স্যান্ডবক্স রুট CA (Google এটি স্যান্ডবক্স ট্রাস্ট স্টোরে যোগ করার পরে) দ্বারা ইস্যু করা লিফ সার্টিফিকেট সহ অনুরোধে স্বাক্ষর করুন এবং ধাপ ৩.A: আপনার CA সার্টিফিকেট প্রোফাইল এবং CBOR মেটাডেটা কনফিগার করুন-এ বর্ণিত আপনার নিজস্ব gw_rp_metadata_bytes তৈরি করুন।
  2. রেসপন্স যাচাইকরণ ট্রাস্ট অ্যাঙ্কর: স্যান্ডবক্স টেস্ট আইডি থেকে রেসপন্স যাচাই করতে, রিলাইং পার্টি এবং যাচাইকারী রেজিস্ট্রার, উভয়কেই তাদের সার্ভারের ট্রাস্ট স্টোরে Utopia Sandbox cert যোগ করতে হবে।

স্যান্ডবক্স টেস্ট কী ও মেটাডেটা (রিলাইং পার্টি)

আপনার নিজের প্রোডাকশন কী রেজিস্টার না করে স্যান্ডবক্স এনভায়রনমেন্টে সাইন করা অনুরোধ পরীক্ষা করতে, আপনি নিম্নলিখিত টেস্ট কী পেয়ার ব্যবহার করতে পারেন। এইসব 'কী' স্যান্ডবক্স এনভায়রনমেন্টে আগে থেকেই বিশ্বস্ত।

নির্দেশাবলী

  1. আপনার অনুরোধ (JWS) স্বাক্ষর করতে টেস্ট ব্যক্তিগত কী ব্যবহার করুন।
  2. আপনার অনুরোধের x5c হেডারে টেস্ট পাবলিক সার্টিফিকেট এম্বেড করুন।
  3. এই সার্টিফিকেটের x509_hash-এ client_id সেট করুন। হ্যাশ গণনা করার ব্যাপারে বিস্তারিত জানতে স্বাক্ষরিত অনুরোধ দেখুন।
  4. client_metadata-এ gw_rp_metadata_bytes-কে নিম্নলিখিত টেস্ট রিলাইং পার্টি মেটাডেটা (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 রুট সার্টিফিকেট (সব পার্টনার)

স্যান্ডবক্সে টেস্ট আইডি Google-এর স্যান্ডবক্স ইস্যুয়িং অথরিটি (Utopia) দ্বারা স্বাক্ষরিত হয়। স্যান্ডবক্স টেস্ট আইডি পাস থেকে ফেরত আসা উত্তরে issuerAuth স্বাক্ষর ক্রিপ্টোগ্রাফিকভাবে যাচাই করতে, আপনার যাচাইকারীর ট্রাস্ট স্টোরে এই রুট সার্টিফিকেট যোগ করুন (প্রোডাকশনে এটি বিশ্বাস করবেন না):

পরিবেশ ইস্যুকারী / দেশ ক্রেডেনশিয়ালের ধরন IACA রুট সার্টিফিকেট
Sandbox Utopia ID পাস (com.google.wallet.idcard.1) Utopia Sandbox সার্টিফিকেট ডাউনলোড করুন

মার্কিন যুক্তরাষ্ট্রের যেসব রাজ্য ও দেশে প্রোডাকশন IACA রুট সার্টিফিকেট কাজ করে, সেগুলির জন্য কাজ করে এমন ইস্যুকারী ও IACA সার্টিফিকেট দেখুন।

স্যান্ডবক্স আপটাইম

আমাদের প্রোডাকশন এনভায়রনমেন্টের মতো স্যান্ডবক্স এনভায়রনমেন্টে আপটাইম SLA নেই। আপনি যদি এমন কোনও সমস্যার সম্মুখীন হন যা আপনার সন্দেহ হয় যে স্যান্ডবক্স আউটেজের সাথে সম্পর্কিত, তাহলে আমাদের সাথে যোগাযোগ করার আগে মার্কিন যুক্তরাষ্ট্রের এক কর্মদিবস অপেক্ষা করুন। আউটেজ সাধারণত সেই সময়সীমার মধ্যেই ঠিক হয়ে যায়। ডাউনটাইমের সম্ভাবনা থাকার কারণে, আপনার কোনও গুরুত্বপূর্ণ রিলিজ প্রসেস স্যান্ডবক্স এনভায়রনমেন্টের উপর নির্ভর করে ডিজাইন করবেন না।

পরের ধাপ

ধাপ ২: টেস্ট আইডি তৈরি করুন →