# Partially update a cart payment

Endpoint: PATCH /cart/payments/{paymentID}
Version: 1.0.457.36910
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2 scopes: FullAccess, Shopper

## Path parameters:

  - `paymentID` (string, required)
    ID of the payment.

## Request fields (application/json):

  - `ID` (string)

  - `Type` (string)
    Enum: "PurchaseOrder", "CreditCard", "SpendingAccount"

  - `CreditCardID` (string)
    Only writeable on create.

  - `SpendingAccountID` (string)
    Only writeable on create.

  - `Description` (string)

  - `Amount` (number)
    If null, payment applies to order total (or total of specific line items, if set), less any other payments where Amount is set. Value can only be negative if processing a payment for an order return.

  - `Accepted` (boolean)
    All payments must be Accepted to submit an order. This property should be updated after authorizing or capturing the payment in your middleware by a user with the elevated OrderAdmin role.

  - `OrderReturnID` (string)
    Used to indicate this payment is associated with an order return.

  - `xp` (object)

## Response 200 fields (application/json):

  - `ID` (string)

  - `Type` (string)
    Enum: "PurchaseOrder", "CreditCard", "SpendingAccount"

  - `DateCreated` (string)

  - `CreditCardID` (string)
    Only writeable on create.

  - `SpendingAccountID` (string)
    Only writeable on create.

  - `Description` (string)

  - `Currency` (string)
    Inherited from order.

  - `Amount` (number)
    If null, payment applies to order total (or total of specific line items, if set), less any other payments where Amount is set. Value can only be negative if processing a payment for an order return.

  - `Accepted` (boolean)
    All payments must be Accepted to submit an order. This property should be updated after authorizing or capturing the payment in your middleware by a user with the elevated OrderAdmin role.

  - `OrderReturnID` (string)
    Used to indicate this payment is associated with an order return.

  - `xp` (object)

  - `Transactions` (array)

  - `Transactions.ID` (string)

  - `Transactions.Type` (string)

  - `Transactions.DateExecuted` (string)

  - `Transactions.Currency` (string)
    Usually the same as Payment.Currency, but can be different. A marketplace owner may capture funds from the buyer user in one currency and process a payout to the seller in another.

  - `Transactions.Amount` (number)
    Usually the same as Payment.Amount, but can be different. A charge might have a subsequent partial credit, for example.

  - `Transactions.Succeeded` (boolean)

  - `Transactions.ResultCode` (string)

  - `Transactions.ResultMessage` (string)

  - `Transactions.xp` (object)

## Response 4XX:

  - `4XX` (unknown)
    Expected errors range from 400-409. Anything in the 5XX range indicates a server issue and should be reported to support.

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: 404

  - `ErrorCode` (string)
    Example: NotFoundError

  - `Message` (string)
    Example: Object not found

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}

