測試

模擬支付以測試您的整合。

介紹

為確認您的整合能正常運作，請在不移動資金的情況下模擬交易。您可以通過在測試模式下創建和操作資源來完成此操作（在所有 API 呼叫中使用測試 API 金鑰）。可以使用專門的測試支付方式來完成測試結帳工作階段。

測試支付方式可讓您模擬多種情況：

成功支付
因拒絕或資料無效而導致的支付錯誤
由於銀行轉賬或便利店支付等非同步支付方式而延遲的支付

結帳結果可以透過測試授權結果開關來控制，這個開關僅供測試使用。

成功會使付款成功
- 同步付款方式（信用卡、PayPay 等）：您將立即收到成功回應。
- 異步付款方式（便利店、Pay-easy 等）：您將在 10 秒延遲後收到成功回應。
拒絕會使付款失敗
- 同步付款方式（信用卡、PayPay 等）：付款將被拒絕，結帳頁面會顯示付款詳細資訊輸入畫面以便重新嘗試（例如：使用不同的信用卡）。
- 異步付款方式（便利店、Pay-easy 等）：付款永遠不會完成，訂單將保持在處理狀態。

當您準備好將整合部署到正式環境時，請將測試 API 金鑰替換為正式環境的金鑰。如果您的整合使用測試 API 金鑰，您將無法處理正式的付款。

完成一次成功的測試支付

創建一個支付的結帳工作階段使用我們的 API 創建一個結帳工作階段。
- 使用您的測試 API 金鑰在測試模式下創建結帳工作階段。

bash

curl --location 'https://api.tokenz.one/v2/checkoutsession' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer secret_test_YOUR_KEY_HERE' \
--data '{
  "amount": {
    "currency": "JPY",
    "amount": 1200
  },
  "itemDetails": [
    {
      "product": {
        "label": "星辰碎片禮包",
        "description": "1,200 遊戲內星辰碎片",
        "images": [],
        "quantity": 1,
        "price": {
          "currency": "JPY",
          "amount": 1200
        },
        "taxCategory": "VIRTUAL_CURRENCY"
      }
    }
  ],
  "successUrl": "http://localhost:9000/success",
  "pendingUrl": "http://localhost:9000/pending",
  "cancelUrl": "http://localhost:9000/cancel",
  "customerInfo": {
    "emailAddress": "user@email.com"
  },
  "description": "description",
  "reference": "reference"
}'

完成 Tokenz 結帳打開創建結帳工作階段 API 呼叫返回的 url。

選擇「信用卡」
填入任意的電子郵件地址，並且從下列測試卡中選擇一張測試卡的資料。
確認測試授權結果開關切換為成功，這可以確保你的測試支付會被承認。
點擊「支付」，這筆交易會被承認，然後你會看到我們的支付成功畫面。如果你設定了 webhook，你會收到一個 order.succeeded webhook。
當你點及「OK」時，你將會被帶到你於創建結帳工作階段時所指定的 successUrl。

永遠不要在測試模式下使用真實的卡資料。請使用下列測試卡。

測試卡號

可視需要左右捲動

品牌	卡號	安全碼	日期
		任意 3 位數字	任意未來日期
		任意 3 位數字	任意未來日期
		任意 3 位數字	任意未來日期
		任意 3 位數字	任意未來日期
		任意 3 位數字	任意未來日期
		任意 3 位數字	任意未來日期
		任意 4 位數字	任意未來日期
		任意 4 位數字	任意未來日期
		任意 3 位數字	任意未來日期
		任意 3 位數字	任意未來日期

測試一次失敗的支付

當消費者的支付失敗時（例：信用卡被拒絕），我們會允許消費者重新嘗試支付，你並不需要針對支付失敗的訂單作任何處理。

在收到成功付款的確認之前，請不要履行訂單。

創建一個支付的結帳工作階段
使用我們的 API 創建一個結帳工作階段。
- 使用您的測試 API 金鑰在測試模式下創建結帳工作階段。

bash

curl --location 'https://api.tokenz.one/v2/checkoutsession' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer secret_test_YOUR_KEY_HERE' \
--data '{
  "amount": {
    "currency": "JPY",
    "amount": 1200
  },
  "itemDetails": [
    {
      "product": {
        "label": "星辰碎片禮包",
        "description": "1,200 遊戲內星辰碎片",
        "images": [],
        "quantity": 1,
        "price": {
          "currency": "JPY",
          "amount": 1200
        },
        "taxCategory": "VIRTUAL_CURRENCY"
      }
    }
  ],
  "successUrl": "http://localhost:9000/success",
  "pendingUrl": "http://localhost:9000/pending",
  "cancelUrl": "http://localhost:9000/cancel",
  "customerInfo": {
    "emailAddress": "user@email.com"
  },
  "description": "description",
  "reference": "reference"
}'

完成 Tokenz 結帳
打開創建結帳工作階段 API 呼叫返回的 url。
- 選擇「信用卡」
- 填寫電子郵件地址，並使用其中一張測試卡的資料填寫卡片詳細資訊。
- 將測試授權結果開關切換到拒絕。這樣可以確保您的付款會被拒絕。
- 點擊「支付」。付款將被拒絕，您會被重新導向回卡片輸入頁面，在那裡您可以再次嘗試付款。

完成一次非同步測試支付

要測試非同步支付的流程，可以使用便利店支付作為測試。這使您能夠測試如何處理延遲的支付成功通知。

創建一個 "konbini" 支付的結帳工作階段
使用我們的 API 創建一個結帳工作階段。
- 使用您的測試 API 金鑰在測試模式下創建結帳工作階段。
- 指定 KONBINI 為接受的支付方式。

bash

curl --location 'https://api.tokenz.one/v2/checkoutsession' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer secret_test_YOUR_KEY_HERE' \
--data '{
  "amount": {
    "currency": "JPY",
    "amount": 1200
  },
  "itemDetails": [
    {
      "product": {
        "label": "星辰碎片禮包",
        "description": "1,200 遊戲內星辰碎片",
        "images": [],
        "quantity": 1,
        "price": {
          "currency": "JPY",
          "amount": 1200
        },
        "taxCategory": "VIRTUAL_CURRENCY"
      }
    }
  ],
  "successUrl": "http://localhost:9000/success",
  "pendingUrl": "http://localhost:9000/pending",
  "cancelUrl": "http://localhost:9000/cancel",
  "customerInfo": {
    "emailAddress": "user@email.com"
  },
  "description": "description",
  "reference": "reference",
  "paymentMethodKinds": [
    "KONBINI"
  ]
}'

完成 Tokenz 結帳
打開創建結帳工作階段 API 呼叫返回的 url。
- 請確認右上角的國家/地區已選擇 Japan
- 選擇 Konbini 作為支付方式
- 填寫任何名稱、電子郵件地址和電話號碼，並選擇一個便利商店。
- 將測試授權結果開關保持為成功。這可以確保您的訂單支付成功。點擊 支付 按鈕以啟動支付。
- 結帳螢幕顯示在便利商店支付的說明。
- 支付完成後（測試支付的情況下為 10 秒後），會顯示支付成功畫面。如果您設定了 webhook，您也會收到一個 order.succeeded webhook。
- 當您點擊「OK」，您將被重定向到您在創建結帳工作階段時指定的 successUrl。

不要嘗試在便利店支付測試付款。測試結帳僅供測試，無需進行實際支付。

測試錢包支付，如 PayPay 或支付寶

在實際支付過程中，用戶需要登入他們的錢包並批准付款。為了讓您能夠在沒有帳戶的情況下測試錢包支付，在測試結帳時，我們只模擬重定向到錢包提供商的過程。

創建 PayPay 支付的結帳工作階段
使用我們的 API 創建一個結帳工作階段。
- 使用您的測試 API 金鑰在測試模式下創建結帳工作階段。
- 指定 PAYPAY 為接受的支付方式。

bash

curl --location 'https://api.tokenz.one/v2/checkoutsession' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer secret_test_YOUR_KEY_HERE' \
--data '{
  "amount": {
    "currency": "JPY",
    "amount": 1200
  },
  "itemDetails": [
    {
      "product": {
        "label": "星辰碎片禮包",
        "description": "1,200 遊戲內星辰碎片",
        "images": [],
        "quantity": 1,
        "price": {
          "currency": "JPY",
          "amount": 1200
        },
        "taxCategory": "VIRTUAL_CURRENCY"
      }
    }
  ],
  "successUrl": "http://localhost:9000/success",
  "pendingUrl": "http://localhost:9000/pending",
  "cancelUrl": "http://localhost:9000/cancel",
  "customerInfo": {
    "emailAddress": "user@email.com"
  },
  "description": "description",
  "reference": "reference",
  "paymentMethodKinds": [
    "PAYPAY"
  ]
}'

完成 Tokenz 結帳
打開創建結帳工作階段 API 呼叫返回的 url。
- 填寫電子郵件地址。
- 根據您想要的結果，將測試授權結果開關設定為成功或拒絕。
- 點擊「使用 PayPay」，在實際付款情況下，這會將用戶重定向到 PayPay 完成購買。在測試付款的情況下，我們只顯示一個測試用畫面，所以您不需要 PayPay 帳戶就能進行測試。
- 點擊「支付」。根據測試結果開關的設定，付款會被成功處理或被拒絕。