---
title: API Version 2 移行ガイド
url: ja/amazon-pay-checkout/ja-version-two-migration-guide.html
---


API version2では、重大な変更が導入されています。 APIエンドポイントのversionパラメータを更新し、このガイドに従ってversion1からversion2に移行します。

* TOC
{:toc}
{::options toc_levels="3" /}

### API関連の更新

一部のパラメーターの名前が変更されたか、再構築されました。以下の変更を確認し、影響を受けるパラメーターの1つを具体的に参照している場合は、コードを更新してください。

#### Checkout Session

<table width="100%" border="1">
    <tbody>
        <tr id=''>
            <td id='' style='vertical-align: top; font-weight: bold; width: 25%;' class='bold'>パラメータ-
                <br /></td>
            <td id='' style='vertical-align: top; font-weight: bold; width: 75%;' class='bold'>変更の説明
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>billingAddress
                <br /></td>
            <td id='' style='vertical-align: top;'>billingAddressがpaymentPreferences配列からトップレベルノードに移動しました
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>webCheckoutDetail
                <br /></td>
            <td id='' style='vertical-align: top;'>webCheckoutDetailの名前がwebCheckoutDetailsに変更されました
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>paymentDetail
                <br /></td>
            <td id='' style='vertical-align: top;'>PaymentDetailの名前がpaymentDetailsに変更されました
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>statusDetail
                <br /></td>
            <td id='' style='vertical-align: top;'>statusDetailの名前がstatusDetailsに変更されました
                <br /></td>
        </tr>
    </tbody>
</table>

#### Charge Permission

<table width="100%" border="1">
    <tbody>
        <tr id=''>
            <td id='' style='vertical-align: top; font-weight: bold; width: 25%;' class='bold'>パラメータ-
                <br /></td>
            <td id='' style='vertical-align: top; font-weight: bold; width: 75%;' class='bold'>変更の説明
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>billingAddress
                <br /></td>
            <td id='' style='vertical-align: top;'>billingAddressがpaymentPreferences配列からトップレベルノードに移動しました
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>chargeAmountLimit
                <br /></td>
            <td id='' style='vertical-align: top;'>amountLimitとaccountBalanceをカプセル化する制限に置き換えられました
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>statusDetail
                <br /></td>
            <td id='' style='vertical-align: top;'>statusDetailの名前がstatusDetailsに変更されました
                <br /></td>
        </tr>
    </tbody>
</table>

#### Charge

<table width="100%" border="1">
    <tbody>
        <tr id=''>
            <td id='' style='vertical-align: top; font-weight: bold; width: 25%;' class='bold'>パラメータ-
                <br /></td>
            <td id='' style='vertical-align: top; font-weight: bold; width: 75%;' class='bold'>変更の説明
                <br /></td>
        </tr>
        <tr id='CVa9CAx084w'>
            <td id='' style='vertical-align: top;'>statusDetail
                <br /></td>
            <td id='' style='vertical-align: top;'>statusDetailの名前がstatusDetailsに変更されました
                <br /></td>
        </tr>
    </tbody>
</table>

#### Refund

<table width="100%" border="1">
    <tbody>
        <tr id=''>
            <td id='' style='vertical-align: top; font-weight: bold; width: 25%;' class='bold'>パラメータ-
                <br /></td>
            <td id='' style='vertical-align: top; font-weight: bold; width: 75%;' class='bold'>変更の説明
                <br /></td>
        </tr>
        <tr id='CVa9CAx084w'>
            <td id='' style='vertical-align: top;'>statusDetail
                <br /></td>
            <td id='' style='vertical-align: top;'>statusDetailの名前がstatusDetailsに変更されました
                <br /></td>
        </tr>
    </tbody>
</table>

### Complete Checkout Session API

Version 2のCheckout Sessionオブジェクトは、`paymentIntent`を確定するために、購入者が`amazonResultReturnUrl`にリダイレクトされたときに確認されなければなりません。24時間以内に確認されないCheckout Sessionはキャンセルされます。

購入者が`amazonResultReturnUrl`にリダイレクトされたときにCheckout Sessionの状態を検証するために実行していた<a href="../amazon-pay-api-v2/checkout-session.md#get-checkout-session" target="_blank" rel="noopener noreferrer">Get Checkout Session</a>を、<a href="../amazon-pay-api-v2/checkout-session.md#complete-checkout-session" target="_blank" rel="noopener noreferrer">Complete Checkout Session</a>リクエストに変更してください。トランザクション処理が成功した場合、Complete Checkout sessionは成功レスポンスを返します。それ以外の場合は、エラーレスポンスを返します。

支払いを承認および取得するために実装した他のロジックは変更する必要はありません。