---
title: "POST /#X-Amz-Target=AWSMPCommerceService_v20200301.SendAgreementPaymentRequest"
method: POST
path: "/#X-Amz-Target=AWSMPCommerceService_v20200301.SendAgreementPaymentRequest"
---

# POST /#X-Amz-Target=AWSMPCommerceService_v20200301.SendAgreementPaymentRequest

`POST /#X-Amz-Target=AWSMPCommerceService_v20200301.SendAgreementPaymentRequest`

Allows sellers (proposers) to submit a payment request to buyers (acceptors) for a specific charge amount for an agreement that includes a `VariablePaymentTerm`. The payment request is created in `PENDING_APPROVAL` status, at which point the buyer can accept or reject it.

The agreement must be active and have a `VariablePaymentTerm` to support payment requests. The `chargeAmount` must not exceed the remaining available balance under the `VariablePaymentTerm` `maxTotalChargeAmount`.

## Headers

- `X-Amz-Target` 'AWSMPCommerceService_v20200301.SendAgreementPaymentRequest', required

## Request body

- SendAgreementPaymentRequestInput
  - `clientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
  - `agreementId` string, required — The unique identifier of the agreement for which the payment request is being submitted. Use <code>GetAgreementTerms</code> to retrieve agreement term details.
  - `termId` string, required — The unique identifier of the <code>VariablePaymentTerm</code> for the agreement that the payment request is being sent for.
  - `name` string, required — A descriptive name for the payment request (5-64 characters).
  - `chargeAmount` string, required — <p>The amount requested to be charged to the buyer, positive decimal value in the currency of the accepted term.</p> <note> <p>A <code>ValidationException</code> is returned if the <code>chargeAmount</code> exceeds the available balance, if the agreement doesn't have an active <code>VariablePaymentTerm</code>, or if the <code>termId</code> is invalid.</p> </note>
  - `description` string, password — An optional detailed description of the payment request (1-2000 characters).

## Response `200`

Success

- SendAgreementPaymentRequestOutput
  - `paymentRequestId` string — The unique identifier for the sent payment request.
  - `agreementId` string — The agreement identifier for this payment request.
  - `status` 'VALIDATING' | 'VALIDATION_FAILED' | 'PENDING_APPROVAL' | 'APPROVED' | 'REJECTED' | 'CANCELLED' — The current status of the payment request. The initial status is <code>PENDING_APPROVAL</code>.
  - `name` string — The descriptive name of the payment request.
  - `description` string, password — The detailed description of the payment request, if provided.
  - `chargeAmount` string — The amount being charged to the buyer.
  - `currencyCode` string — The currency code for the charge amount (e.g., <code>USD</code>).
  - `createdAt` string, date-time — The time when the payment request was created.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalServerException
- `485` — ConflictException

---

[API](https://skmtc.net/aws/apis/marketplace-agreement.md) · [All operations](https://skmtc.net/aws/apis/marketplace-agreement/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/marketplace-agreement/versions/a16aac0fa99c/schema)