```php 'YOUR_PUBLIC_KEY_ID', 'private_key' => 'keys/private.pem', // Path to RSA Private Key (or a string representation) 'region' => 'YOUR_REGION_CODE', 'algorithm' => 'AMZN-PAY-RSASSA-PSS-V2' ); $payload = array( 'shippingAddress' => array( 'name' => 'Susi S', 'addressLine1' => '11 Ditka Ave', 'addressLine2'=> 'Suite 2500', 'city'=> 'Chicago', 'stateOrRegion'=> 'IL', 'postalCode'=> '60602', 'countryCode'=> 'US', 'phoneNumber'=> '800-000-0000' ), 'chargeAmount' => array( 'amount' => '14.00', 'currencyCode' => 'USD' ), 'paymentIntent' => 'AuthorizeWithCapture' ); try { $client = new Amazon\Pay\API\Client($amazonpay_config); $result = $client->finalizeCheckoutSession('bd504926-f659-4ad7-a1a9-9a747aaf5275', $payload); if ($result['status'] === 202) { // Charge Permission is in AuthorizationInitiated state $response = json_decode($result['response'], true); $checkoutSessionState = $response['statusDetails']['state']; $chargeId = $response['chargeId']; $chargePermissionId = $response['chargePermissionId']; } else if ($result['status'] === 200) { $response = json_decode($result['response'], true); $checkoutSessionState = $response['statusDetails']['state']; $chargePermissionId = $response['chargePermissionId']; } else { // check the error echo 'status=' . $result['status'] . '; response=' . $result['response'] . "\n"; } } catch (Exception $e) { // handle the exception echo $e; } ?> ```

```csharp using Amazon.Pay.API.Types; using Amazon.Pay.API.WebStore; using Amazon.Pay.API.WebStore.Types; using Amazon.Pay.API.WebStore.CheckoutSession; public class Sample { public WebStoreClient InitiateClient() { // set up config var payConfiguration = new ApiConfiguration ( region: Region.YOUR_REGION_CODE, publicKeyId: "YOUR_PUBLIC_KEY_ID", privateKey: "PATH_OR_CONTENT_OF_YOUR_PRIVATE_KEY", algorithm: AmazonSignatureAlgorithm.V2 ); // init API client var client = new WebStoreClient(payConfiguration); return client; } public CheckoutSessionResponse FinalizeCheckoutSession(string checkoutSessionId, Address shippingAddress, String paymentIntent) { // prepare the request var request = new FinalizeCheckoutSessionRequest(14.00M, Currency.USD, paymentIntent); request.ShippingAddress = address; // send the request var result = client.FinalizeCheckoutSession(checkoutSessionId, request); // check if API call was successful if (!result.Success) { // do something, e.g. throw an error } return result; } } ```

```Java import com.amazon.pay.api.AmazonPayResponse; import com.amazon.pay.api.PayConfiguration; import com.amazon.pay.api.WebstoreClient; import com.amazon.pay.api.exceptions.AmazonPayClientException; import com.amazon.pay.api.types.Region; import org.json.JSONObject; public void sample() { PayConfiguration payConfiguration = null; try { payConfiguration = new PayConfiguration() .setPublicKeyId("YOUR_PUBLIC_KEY_ID") .setRegion(Region.YOUR_REGION_CODE) .setPrivateKey("YOUR_PRIVATE_KEY") .setAlgorithm("AMZN-PAY-RSASSA-PSS-V2"); WebstoreClient webstoreClient = new WebstoreClient(payConfiguration); AmazonPayResponse response = null; String checkoutSessionId = "bd504926-f659-4ad7-a1a9-9a747aaf5275"; JSONObject payload = new JSONObject(); JSONObject chargeAmount = new JSONObject(); chargeAmount.put("amount", "14.00"); chargeAmount.put("currencyCode", "USD"); payload.put("chargeAmount", chargeAmount); JSONObject shippingAddress = new JSONObject(); shippingAddress.put("name", "Susy S"); shippingAddress.put("addressLine1", "11 Ditka Ave"); shippingAddress.put("addressLine2", "Suite 2500"); shippingAddress.put("city", "Chicago"); shippingAddress.put("stateOrRegion", "IL"); shippingAddress.put("postalCode", "60602"); shippingAddress.put("countryCode", "US"); shippingAddress.put("phoneNumber", "800-000-0000"); payload.put("shippingAddress", shippingAddress); payload.put("paymentIntent", "AuthorizeWithCapture"); response = webstoreClient.finalizeCheckoutSession(checkoutSessionId, payload); String chargePermissionId = response.getResponse().getString("chargePermissionId"); } catch (AmazonPayClientException e) { e.printStackTrace(); } } ```

```JavaScript const fs = require('fs'); const Client = require('@amazonpay/amazon-pay-api-sdk-nodejs'); const config = { publicKeyId: 'YOUR_PUBLIC_KEY_ID', privateKey: fs.readFileSync('tst/private.pem'), region: 'YOUR_REGION_CODE', algorithm: 'AMZN-PAY-RSASSA-PSS-V2' }; const payload = { chargeAmount: { amount: "14.00", currencyCode: "USD" }, shippingAddress: { "name": "Susy S", "addressLine1": "11 Ditka Ave", "addressLine2": "Suite 2500", "city": "Chicago", "stateOrRegion": "IL", "postalCode": "60602", "countryCode": "US", "phoneNumber": "800-000-0000" }, paymentIntent: "AuthorizeWithCapture", }; const testPayClient = new Client.WebStoreClient(config); const response = testPayClient.finalizeCheckoutSession('bd504926-f659-4ad7-a1a9-9a747aaf5275', payload); response.then(function (result) { console.log(result.data); }).catch(err => { console.log(err); }); ```

```php 'YOUR_PUBLIC_KEY_ID', 'private_key' => 'keys/private.pem', // Path to RSA Private Key (or a string representation) 'region' => 'YOUR_REGION_CODE', 'sandbox' => true, 'algorithm' => 'AMZN-PAY-RSASSA-PSS-V2' ); $payload = array( 'shippingAddress' => array( 'name' => 'Susi S', 'addressLine1' => '11 Ditka Ave', 'addressLine2'=> 'Suite 2500', 'city'=> 'Chicago', 'stateOrRegion'=> 'IL', 'postalCode'=> '60602', 'countryCode'=> 'US', 'phoneNumber'=> '800-000-0000' ), 'chargeAmount' => array( 'amount' => '14.00', 'currencyCode' => 'USD' ), 'paymentIntent' => 'AuthorizeWithCapture' ); try { $client = new Amazon\Pay\API\Client($amazonpay_config); $result = $client->finalizeCheckoutSession('bd504926-f659-4ad7-a1a9-9a747aaf5275', $payload); if ($result['status'] === 202) { // Charge Permission is in AuthorizationInitiated state $response = json_decode($result['response'], true); $checkoutSessionState = $response['statusDetails']['state']; $chargeId = $response['chargeId']; $chargePermissionId = $response['chargePermissionId']; } else if ($result['status'] === 200) { $response = json_decode($result['response'], true); $checkoutSessionState = $response['statusDetails']['state']; $chargePermissionId = $response['chargePermissionId']; } else { // check the error echo 'status=' . $result['status'] . '; response=' . $result['response'] . "\n"; } } catch (Exception $e) { // handle the exception echo $e; } ?> ```

```csharp using Amazon.Pay.API.Types; using Amazon.Pay.API.WebStore; using Amazon.Pay.API.WebStore.Types; using Amazon.Pay.API.WebStore.CheckoutSession; public class Sample { public WebStoreClient InitiateClient() { // set up config var payConfiguration = new ApiConfiguration ( region: Region.YOUR_REGION_CODE, environment: Environment.Sandbox, publicKeyId: "YOUR_PUBLIC_KEY_ID", privateKey: "PATH_OR_CONTENT_OF_YOUR_PRIVATE_KEY", algorithm: AmazonSignatureAlgorithm.V2 ); // init API client var client = new WebStoreClient(payConfiguration); return client; } public CheckoutSessionResponse FinalizeCheckoutSession(string checkoutSessionId, Address shippingAddress, String paymentIntent) { // prepare the request var request = new FinalizeCheckoutSessionRequest(14.00M, Currency.USD, paymentIntent); request.ShippingAddress = address; // send the request var result = client.FinalizeCheckoutSession(checkoutSessionId, request); // check if API call was successful if (!result.Success) { // do something, e.g. throw an error } return result; } } ```

```Java import com.amazon.pay.api.AmazonPayResponse; import com.amazon.pay.api.PayConfiguration; import com.amazon.pay.api.WebstoreClient; import com.amazon.pay.api.exceptions.AmazonPayClientException; import com.amazon.pay.api.types.Region; import org.json.JSONObject; public void sample() { PayConfiguration payConfiguration = null; try { payConfiguration = new PayConfiguration() .setPublicKeyId("YOUR_PUBLIC_KEY_ID") .setRegion(Region.YOUR_REGION_CODE) .setPrivateKey("YOUR_PRIVATE_KEY") .setEnvironment(Environment.SANDBOX) .setAlgorithm("AMZN-PAY-RSASSA-PSS-V2"); WebstoreClient webstoreClient = new WebstoreClient(payConfiguration); AmazonPayResponse response = null; String checkoutSessionId = "bd504926-f659-4ad7-a1a9-9a747aaf5275"; JSONObject payload = new JSONObject(); JSONObject chargeAmount = new JSONObject(); chargeAmount.put("amount", "14.00"); chargeAmount.put("currencyCode", "USD"); payload.put("chargeAmount", chargeAmount); JSONObject shippingAddress = new JSONObject(); shippingAddress.put("name", "Susy S"); shippingAddress.put("addressLine1", "11 Ditka Ave"); shippingAddress.put("addressLine2", "Suite 2500"); shippingAddress.put("city", "Chicago"); shippingAddress.put("stateOrRegion", "IL"); shippingAddress.put("postalCode", "60602"); shippingAddress.put("countryCode", "US"); shippingAddress.put("phoneNumber", "800-000-0000"); payload.put("shippingAddress", shippingAddress); payload.put("paymentIntent", "AuthorizeWithCapture"); response = webstoreClient.finalizeCheckoutSession(checkoutSessionId, payload); String chargePermissionId = response.getResponse().getString("chargePermissionId"); } catch (AmazonPayClientException e) { e.printStackTrace(); } } ```

```JavaScript const fs = require('fs'); const Client = require('@amazonpay/amazon-pay-api-sdk-nodejs'); const config = { publicKeyId: 'YOUR_PUBLIC_KEY_ID', privateKey: fs.readFileSync('tst/private.pem'), region: 'YOUR_REGION_CODE', sandbox: true, algorithm: 'AMZN-PAY-RSASSA-PSS-V2' }; const payload = { chargeAmount: { amount: "14.00", currencyCode: "USD" }, shippingAddress: { "name": "Susy S", "addressLine1": "11 Ditka Ave", "addressLine2": "Suite 2500", "city": "Chicago", "stateOrRegion": "IL", "postalCode": "60602", "countryCode": "US", "phoneNumber": "800-000-0000" }, paymentIntent: "AuthorizeWithCapture", }; const testPayClient = new Client.WebStoreClient(config); const response = testPayClient.finalizeCheckoutSession('bd504926-f659-4ad7-a1a9-9a747aaf5275', payload); response.then(function (result) { console.log(result.data); }).catch(err => { console.log(err); }); ```

paymentIntent	説明
AuthorizeWithCapture	支払いのオーソリが取得され、売上請求も実施されます。 1. `ChargeId`の保管 - `ChargeId`は返金実施時の為に必ず保管してください。 2. `ChargePermissionId`の保管 - もし `totalOrderAmount` を設定していて、売上請求が未済のレコードがある場合は、延期されたトランザクションを管理するを参照してください。また、30日以内であれば、`ChargePermissionId` を使用して、Get Charge Permissionを行い、購入者とトランザクションの情報を取得することもできます。情報を30日を超えて保持するには、データを事業者側で保存する必要があります。
Authorize	オーソリが取得されます。 1. `ChargeId`の保管 - 後に売上請求するのCharge IDを格納する必要があります。詳細については、延期されたトランザクションを管理するを参照してください。 2. `ChargePermissionId`の保管 - もし `totalOrderAmount` を設定していて、売上請求が未済のレコードがある場合は、延期されたトランザクションを管理するを参照してください。また、30日以内であれば、`ChargePermissionId` を使用して、Get Charge Permissionを行い、購入者とトランザクションの情報を取得することもできます。情報を30日を超えて保持するには、データを事業者側で保存する必要があります。
Confirm	オーソリが取得されず、売上請求も行なわれません。 1. `ChargePermissionId`の保管 - `ChargePermissionId`を将来行うオーソリ取得、売上請求の為に保管します。詳細については、延期されたトランザクションを管理するを参照してください。また、30日以内であれば、`ChargePermissionId` を使用して、Get Charge Permissionを行い、購入者とトランザクションの情報を取得することもできます。情報を30日を超えて保持するには、データを事業者側で保存する必要があります。

名前	ロケーション	説明
checkoutSessionId (必須) Type: string	Path parameter	Checkout Session識別子
paymentIntent (必須) Type: string	Body	購入者への支払いフロー
chargeAmount (必須) Type: price	Body	決済時に`paymentIntent`を使用して処理される金額。Checkout Sessionオブジェクトの`paymentDetails.chargeAmount`と一致する必要があります
totalOrderAmount Type: price	Body	注文の総額。この項目に値が指定されている場合は、Checkout Sessionオブジェクト`paymentDetails.totalOrderAmount`と一致する必要があります
canHandlePendingAuthorization Type: boolean	Body	非同期オーソリ処理を行うかどうかのBoolean 詳細は asynchronous processing をご参照ください
shippingAddress (必須) Type: address	Body	Amazonが検証するための配送先住所 `PayAndShip`では必須です
billingAddress (必須) Type: address	Body	Amazonが検証するための請求先住所 `PayOnly`では必須です
supplementaryData Type: string	Body	オーダーにおける補足データ（通常は利用しません）

HTTPステータスコード	理由コード	説明
400 BAD_REQUEST	CurrencyMismatch	リクエストで提供された通貨コードが、決済時に設定された通貨と一致しません
400 BAD_REQUEST	TransactionAmountExceeded	Checkout Sessionで許可されている最大請求金額を超えました
404 NOT_FOUND	ResourceNotFound	Checkout Sessionは、30日後に完全に削除されます。以降、Checkout Sessionに対してリクエストを行うと、このエラーコードが返されます
409 CONFLICT	ChargeAmountMismatch	Checkout Sessionオブジェクトの`chargeAmount`とリクエスト`chargeAmount`が一致していません
409 CONFLICT	TotalOrderAmountMismatch	Checkout Sessionオブジェクトの`TotalOrderAmount`とリクエスト`TotalOrderAmount`が一致していません
409 CONFLICT	CanHandlePendingAuthorizationMismatch	Checkout Sessionオブジェクトの`canHandlePendingAuthorization`とリクエスト`canHandlePendingAuthorization`が一致していません
409 CONFLICT	PaymentIntentMismatch	Checkout Sessionオブジェクトの`paymentIntent`とリクエスト`paymentIntent`が一致していません
409 CONFLICT	ShippingAddressMismatch	Checkout Sessionオブジェクトとリクエスト`ShippingAddress`が一致していません
409 CONFLICT	BillingAddressMismatch	Checkout Sessionオブジェクトとリクエスト`billingAddress`が一致していません
422 UNPROCESSABLE_ENTITY	CheckoutSessionCanceled	購入者が取引をキャンセルしたか、支払いが拒否されたため、決済に失敗しました
422 UNPROCESSABLE_ENTITY	InvalidCheckoutSessionStatus	その処理が許可されていないstateのCheckout Sessionに対して処理を実行しようとしました
422 UNPROCESSABLE_ENTITY	InvalidChargeStatus	その処理が許可されていないstateのChargeに対して処理を実行しようとしました。または、`paymentIntent`がAuthorizeWithCaptureで`canHandlePendingAuthorization`をtrueに設定しているCheckout Sessionに対して、Complete Checkout Sessionを実行しようとしました
422 UNPROCESSABLE_ENTITY	HardDeclined	Chargeはhard declinedとなりました。再試行は成功しません。購入者に連絡して、別のお支払い方法を選択してもらいます
422 UNPROCESSABLE_ENTITY	PaymentMethodNotAllowed	購入者が選択した支払い方法は、このChargeに対しては許可されていません
422 UNPROCESSABLE_ENTITY	AmazonRejected	ChargeはAmazonによって拒否されました。紐づくCharge Permissionもキャンセルされます
422 UNPROCESSABLE_ENTITY	MFANotCompleted	トランザクションを処理するには、購入者が多要素認証(MFA)を完了する必要があります
422 UNPROCESSABLE_ENTITY	TransactionTimedOut	`canHandlePendingAuthorization`がfalseの場合,Amazon Payがオーソリを取得するのに十分な時間な時間が取れずChargeは拒否されました。購入者に連絡して、別の支払い方法を選択してもらいます。このエラーが頻繁に発生する場合は、`canHandlePendingAuthorization`をtrueに設定して下さい。もし`canHandlePendingAuthorization`をtrueにした場合,Amazon Payが注文の有効性を判断できなかったため、このChargeは拒否されました。購入者に連絡して、別の支払い方法を選択してもらいます。詳細については、非同期処理を参照してください
500 INTERNAL_SERVER_ERROR	ProcessingFailure	内部処理エラーのため、AmazonはChargeを処理できませんでした。 Charge PermissionがChargeable状態の場合にのみChargeを再試行する必要があります