インテグレーションを本番環境にする

For LLMs: see /docs/amazon-pay/llms.txt | Markdown: /ja/docs/amazon-pay-checkout/ja-take-your-integration-live.md

[ステップ8/8] このステップでは、本番環境の値を使用するようにインテグレーションを更新し、リリース前のチェックリストを確認します。このステップの終わりに、本番環境トランザクションを処理できるようになります。

1. ボタンレンダリングコードの更新

ボタンインテグレーションコードで、publicKeyIdを本番環境のPublic Key IDに置き換えます。Public Key IDを取得しますの手順を繰り返して、本番環境のPublic Ket IDを生成します。手順2の「マーケットプレイススイッチャー」のドロップダウンから、必ず「Amazon Pay(本番環境)」を選択してください。

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'USD',            
        // customize the buyer experience
        checkoutLanguage: 'en_US',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx'
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'EUR',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx'
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'GBP',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx'
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'JPY',            
        // customize the buyer experience
        checkoutLanguage: 'ja_JP',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx'
        }   
    });
</script>

2. リリース前のチェックリストの確認

ビジネスのステークホルダーに適切なユーザーのアクセス権限があることをセラーセントラルで確認します。そして、本番リリース日が共有されていることを確認します。適切な本番リリースが行なわれるように、以下のリリース前チェックリストを確認してください。

アカウント設定の完了

Amazon Payの事業者アカウントの登録が完了し、本番環境で支払いを処理する準備ができていることを確認してください。
すべてのドメインがセラーセントラルに追加されていることを確認します。詳細については、セラーセントラルへのドメインの追加を参照してください。
シームレスな決済エクスペリエンスを維持するために、セラーセントラル上でロゴを追加します。ロゴは自動的に50x150ピクセルにサイズ変更されることに注意してください。
IPNを使用して非同期プロセスを処理している場合は、本番IPNエンドポイントを追加します。詳細については、IPNの設定を参照してください。
開発者アカウントを使用している場合は、本番環境アカウントにアップグレードします: US, EU, UK, JP

購入者エクスペリエンスの最適化

カートから決済ページの流れにAmazon Payボタンが表示されていることを確認します。
購入者が手動で詳細情報の入力を求められる前、つまり決済の開始時にAmazon Payボタンを配置することにより、購入フローでの離脱を減らします。
Amazon Payの決済エクスペリエンスがデスクトップとモバイルの両方のエクスペリエンスに最適化されていることを確認します。
購入者とのコミュニケーションの情報が正確であることを確認します。

一般的なインテグレーションの留意点

一部のAmazon Payトランザクションは非同期で処理されます。これは、Amazon Payが保留のレスポンスを返し、処理が完了するまでオブジェクトがPendingステータスになることを意味します。該当する箇所については、非同期処理の対応をしていることを確認してください。
Amazon Payは、購入者氏名を返します。この氏名が正しく反映されていることを確認してください。一部の購入者は、「ジェーン」など、氏名の一部しか提供しない場合があることに注意してください。

1. ボタンレンダリングコードの更新

ボタンインテグレーションコードで、sandboxパラメータを削除します。また、payloadJSONが変更された場合は、新しい署名を生成する必要があります。
SANDBOXと本番環境でそれぞれのキーペアを生成している場合は、publicKeyIdをLIVE-から始まる本番環境用のPublic Key IDに更新します。

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'USD',            
        // customize the buyer experience
        checkoutLanguage: 'en_US',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'EUR',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'GBP',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'JPY',            
        // customize the buyer experience
        checkoutLanguage: 'ja_JP',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

2. APIエンドポイントの更新

APIエンドポイントをSANDBOXから本番環境に変更します。

Region	SANDBOX APIエンドポイント	本番環境 APIエンドポイント
US	https://pay-api.amazon.com/sandbox/:version	https://pay-api.amazon.com/live/:version
EU/UK	https://pay-api.amazon.eu/sandbox/:version	https://pay-api.amazon.eu/live/:version
JP	https://pay-api.amazon.jp/sandbox/:version	https://pay-api.amazon.jp/live/:version

3. リリース前のチェックリストの確認

アカウント設定の完了

Amazon Payの事業者アカウントの登録が完了し、本番環境で支払いを処理する準備ができていることを確認してください。
すべてのドメインがセラーセントラルに追加されていることを確認します。詳細については、セラーセントラルへのドメインの追加を参照してください。
シームレスな決済エクスペリエンスを維持するために、セラーセントラル上でロゴを追加します。ロゴは自動的に50x150ピクセルにサイズ変更されることに注意してください。
IPNを使用して非同期プロセスを処理している場合は、本番IPNエンドポイントを追加します。詳細については、IPNの設定を参照してください。
開発者アカウントを使用している場合は、本番環境アカウントにアップグレードします: US, EU, UK, JP

購入者エクスペリエンスの最適化

カートから決済ページの流れにAmazon Payボタンが表示されていることを確認します。
購入者が手動で詳細情報の入力を求められる前、つまり決済の開始時にAmazon Payボタンを配置することにより、購入フローでの離脱を減らします。
Amazon Payの決済エクスペリエンスがデスクトップとモバイルの両方のエクスペリエンスに最適化されていることを確認します。
購入者とのコミュニケーションの情報が正確であることを確認します。

一般的なインテグレーションの留意点

一部のAmazon Payトランザクションは非同期で処理されます。これは、Amazon Payが保留のレスポンスを返し、処理が完了するまでオブジェクトがPendingステータスになることを意味します。該当する箇所については、非同期処理の対応をしていることを確認してください。
Amazon Payは、購入者氏名を返します。この氏名が正しく反映されていることを確認してください。一部の購入者は、「ジェーン」など、氏名の一部しか提供しない場合があることに注意してください。