با توکن‌های نمونه آزمایش کنید

این صفحه نحوه استفاده از توکن‌های نمونه برای آزمایش یکپارچه‌سازی شما را شرح می‌دهد.

تولید توکن‌های نمونه

برای آزمایش رمزگشایی توکن روی سرور خود برای ادغام مستقیم، می‌توانید توکن‌های نمونه را در صورت تنظیم محیط روی TEST هنگام ساخت یک نمونه PaymentsClient ایجاد کنید.

وقتی نمونه PaymentsClient با محیط تنظیم شده روی TEST ساخته می‌شود، فراخوانی‌های loadPaymentData طبق معمول کار می‌کنند و از کاربر می‌خواهند که یکی از کارت‌های واقعی خود را انتخاب کند. با این حال، هرگز اطلاعات واقعی از کارت انتخاب شده را برنمی‌گرداند. در عوض، توکنی که حاصل می‌شود همیشه دارای یک payload ثابت است.

مهم: وقتی محیط روی TEST تنظیم شده باشد، هرگز از جزئیات کارت واقعی شما استفاده نمی‌شود، اما قبل از ادامه باید حداقل یک کارت قابل شارژ به حساب گوگل خود اضافه کنید . علاوه بر این، برای تولید توکن‌های نمونه برای کارت‌های توکنیزه شده، باید حداقل یک روش پرداخت پشتیبانی شده را به برنامه Google Wallet نصب و اضافه کنید .

توجه: گوگل کارت‌های آزمایشی ارائه نمی‌دهد. در صورت نیاز به کارت‌های آزمایشی قابل شارژ، با بانک پذیرنده خود تماس بگیرید.

امضا را تأیید کنید

توکن‌های تولید شده در محیط TEST با کلید عمومی آزمایشی شما که قبلاً به گوگل ارسال شده بود، رمزگذاری می‌شوند.

توکن‌ها با کلیدهای آزمایشی گوگل امضا شده‌اند. اگر از Tink استفاده می‌کنید، هنگام ساخت شیء PaymentMethodTokenRecipient ، مطمئن شوید که .fetchSenderVerifyingKeysWith(GooglePaymentsPublicKeysManager.INSTANCE_TEST) تنظیم شده باشد.

بار داده رمزگشایی شده

مهم: نمونه‌های بار داده ارائه شده در اینجا فقط جهت توضیح هستند.

پس از رمزگشایی توکن نمونه، شما محتوای متنی شفاف را دریافت می‌کنید. ساختار محتوای متنی بستگی به این دارد که آیا کارت انتخاب شده توکنیزه شده است، به این معنی که به Google Pay اضافه شده است یا خیر. علاوه بر این، محتوای متنی برای کارت‌های توکنیزه شده متفاوت است که به شبکه کارت بستگی دارد. محتوای متنی برای کارت‌های غیر توکنیزه شده، صرف نظر از شبکه کارت، همیشه یکسان است.

سه فیلد زیر ممکن است در محتوای رمزگشایی‌شده‌ی شما در مقایسه با نمونه‌های موجود در این صفحه متفاوت باشند:

• messageExpiration : یک مهر زمانی که یک هفته از زمان فعلی تنظیم می‌شود.
• messageId : این شناسه به صورت تصادفی برای هر payload تولید می‌شود.
• expirationYear : این مقدار پنج سال پس از سال جاری تنظیم می‌شود.

ساختار بار داده رمزگشایی‌شده بین دو نسخه پروتکل، ECv1 و ECv2، متفاوت است. اگر یکپارچه‌سازی جدیدی را پیاده‌سازی می‌کنید، نسخه ECv2 خواهد بود. اگر در مورد نسخه پروتکل مطمئن نیستید، آن را با نماینده گوگل خود تأیید کنید.

کارت بدون توکن

ویزا

در زیر مثالی از یک payload رمزگشایی شده برای کارت‌های ویزای بدون توکن آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1650574736277",
    "messageId": "AH2Ejtc88ZHJ-2aYBQWzHwvp6l0JsCHgxVt8s91A-ZUikaXNbcjsFm6gg9ExeVR-jzIyT-mJvA_ntvfRsDDOH2jnKMjdTtXIJvPt0NBUU45R7-gnjxkx-sI0ldcWvbDHsV0735yFDbWk",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "4111111111111111",
        "authMethod": "PAN_ONLY"
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "expirationMonth": 12,
    "pan": "4111111111111111"
  }
}

مسترکارت

در زیر مثالی از یک payload رمزگشایی شده برای کارت‌های مسترکارت توکن نشده آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1650574585777",
    "messageId": "AH2Ejte23Sp0DBWqKVQ1d8ICVQialPGgXSsTT4NnCjNy3i-jdJg6B_wllO8590dFfrLg16GqGcuSrEPjl-sQZ-K8sKCL62ahwh5kzUv4ggLwioImJmuEuKfAiEQBRW0L8zlo0Nv6LFuk",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "5555555555554444",
        "authMethod": "PAN_ONLY"
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "expirationMonth": 12,
    "pan": "5555555555554444"
  }
}

امریکن اکسپرس

در ادامه مثالی از یک payload رمزگشایی‌شده برای کارت‌های آمریکن اکسپرس بدون توکن آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1650574857349",
    "messageId": "AH2EjtcmoURSXm2RhZ8ihnJrsty-7Ewm3NEnJDM-Atw9ewbIPvuarglows0vtaCV33b4z3PpM5RsMklbpe0aNPK5_BanGxmp_JSsOEtZYuf4m3cHTtKnxpQeonN07XDK-DUPKAaRwLfY",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "378282246310005",
        "authMethod": "PAN_ONLY"
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "expirationMonth": 12,
    "pan": "378282246310005"
  }
}

کشف کنید

در زیر مثالی از یک payload رمزگشایی شده برای کارت‌های Discover بدون توکن آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1650574781399",
    "messageId": "AH2EjteSxPPpbJOXKXzG1Cqkh1kzJz0UP1AG4w75n9q7gCtWsawfRlqtUZofjIBnKlbozvASxKkkdbjv2-rOfNGd_st4kFqPeb6O3IE-fXeIcHzH8x56tMRylEnfnrF6x01ET8KdUeLS",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "6011111111111117",
        "authMethod": "PAN_ONLY"
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "expirationMonth": 12,
    "pan": "6011111111111117"
  }
}

جی سی بی

در ادامه مثالی از یک payload رمزگشایی‌شده برای کارت‌های JCB بدون توکن آمده است:

ای سی وی ۲

{
        {
          "gatewayMerchantId": "some-merchant-id",
          "messageExpiration": "1650574736277",
          "messageId": "AH2Ejtc88ZHJ-2aYBQWzHwvp6l0JsCHgxVt8s91A-ZUikaXNbcjsFm6gg9ExeVR-jzIyT-mJvA_ntvfRsDDOH2jnKMjdTtXIJvPt0NBUU45R7-gnjxkx-sI0ldcWvbDHsV0735yFDbWk",
          "paymentMethod": "CARD",
          "paymentMethodDetails": {
              "expirationYear": 2028,
              "expirationMonth": 12,
              "pan": "4111111111111111",
              "authMethod": "PAN_ONLY"
          }
      }

ای سی وی ۱

{
        {
          "messageExpiration": "1507738377032",
          "paymentMethod": "CARD",
          "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
          "paymentMethodDetails": {
            "expirationYear": 2028,
            "expirationMonth": 12,
            "pan": "4111111111111111"
          }
        }
  }
}

کارت توکنیزه شده

«کارت توکنیزه‌شده» به کارت‌هایی اشاره دارد که به کیف پول گوگل اضافه می‌شوند.

میزان داده‌های رمزگشایی‌شده‌ی یک کارت توکنیزه‌شده به نوع کارت انتخاب‌شده بستگی دارد. سه مثال زیر، داده‌های رمزگشایی‌شده‌ی مربوط به انواع مختلف کارت‌های توکنیزه‌شده را نشان می‌دهند.

ویزا

در زیر مثالی از یک payload رمزگشایی شده برای کارت‌های ویزا توکنیزه شده آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1561533871082",
    "messageId": "AH2Ejtc8qBlP_MCAV0jJG7ErQKeDrkEUtQ0N3QRvPXWJc-jgC0VTfgmarDRZvTwuzirQPdUjkMkiQ7tnDidZbtlQTO-mAgMIdXRMuYedhZXnCcokmkJOOnE7jBn-pvkyBncOgpPWFFn3",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "4895370012003478",
        "authMethod": "CRYPTOGRAM_3DS",
        "eciIndicator": "07",
        "cryptogram": "AgAAAAAABk4DWZ4C28yUQAAAAAA="
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "TOKENIZED_CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "dpan": "4895370012003478",
    "expirationMonth": 12,
    "authMethod": "3DS",
    "3dsCryptogram": "AgAAAAAABk4DWZ4C28yUQAAAAAA=",
    "3dsEciIndicator": "07"
  }
}

مسترکارت

در زیر مثالی از یک payload رمزگشایی شده برای کارت‌های مسترکارت توکنیزه شده آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1561533871082",
    "messageId": "AH2Ejtc8qBlP_MCAV0jJG7ErQKeDrkEUtQ0N3QRvPXWJc-jgC0VTfgmarDRZvTwuzirQPdUjkMkiQ7tnDidZbtlQTO-mAgMIdXRMuYedhZXnCcokmkJOOnE7jBn-pvkyBncOgpPWFFn3",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "5204240250197840",
        "authMethod": "CRYPTOGRAM_3DS",
        "eciIndicator": "02",
        "cryptogram": "ALnt+yWSJdXBACMLLWMNGgADFA=="
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "TOKENIZED_CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "dpan": "5204240250197840",
    "expirationMonth": 12,
    "authMethod": "3DS",
    "3dsCryptogram": "ALnt+yWSJdXBACMLLWMNGgADFA==",
    "3dsEciIndicator": "02"
  }
}

امریکن اکسپرس

در زیر مثالی از یک payload رمزگشایی شده برای کارت‌های American Express توکن‌دار شده آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1561534208255",
    "messageId": "AH2Ejtf3Lp6LzjK6BswXBvVKZapBJNgMUbVHF_TORaVi7lV0tvRfzvApsZm-RAXF_szQq9qS_BwLTgZGrXvk0ZydZwUISo4x6dxojDoz0fl7loXwZ8JApFrQWU__ExxljKY4Y4mu2aQz",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "370295136149943",
        "authMethod": "CRYPTOGRAM_3DS",
        "cryptogram": "JnPYbs6FkC1tiVLREAABoAAAkgA="
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "TOKENIZED_CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "dpan": "370295136149943",
    "expirationMonth": 12,
    "authMethod": "3DS",
    "3dsCryptogram": "JnPYbs6FkC1tiVLREAABoAAAkgA="
  }
}

تمام شبکه‌های دیگر

در ادامه مثالی از یک payload رمزگشایی‌شده برای کارت‌های توکن‌شده برای سایر شبکه‌ها آمده است:

ای سی وی ۲

{
    "gatewayMerchantId": "some-merchant-id",
    "messageExpiration": "1561534208255",
    "messageId": "AH2EjterqtEqlB9vQvy2kJEugwCDYtMzVtLrVH26Qd1RDFK_EFsFmPdpPOqcCIedXNpAc6sCM61GuYM_bgVl930tU8I0Ar0WUx87MIw36skUC-IT_APvbx4qRqw9Hfu2W-7zY6LMdgZ5",
    "paymentMethod": "CARD",
    "paymentMethodDetails": {
        "expirationYear": 2028,
        "expirationMonth": 12,
        "pan": "5204240250197840",
        "authMethod": "CRYPTOGRAM_3DS",
        "cryptogram": "ALnt+yWSJdXBACMLLWMNGgADFA=="
    }
}

ای سی وی ۱

{
  "messageExpiration": "1507738377032",
  "paymentMethod": "TOKENIZED_CARD",
  "messageId": "AH2EjtcHYs1Ye-ZIZuZXd7eNO4QjQfZjBDtP2ti0tob_a5o22lHmGWHsBVYrrSylkFC3ZTsRdvMadQpwOGCIl7XxhTKcfElmgF7UFbcI8CeUZCWRmbTH5s7h69Baqr4FAM735VNThPiP",
  "paymentMethodDetails": {
    "expirationYear": 2028,
    "dpan": "5204240250197840",
    "expirationMonth": 12,
    "authMethod": "3DS",
    "3dsCryptogram": "ALnt+yWSJdXBACMLLWMNGgADFA=="
  }
}