Does POST /V1/carts/mine/set-payment-information require authentication?

This endpoint requires a Bearer token. The `self` ACL means a customer token (when the caller owns the resource) or an admin token both work.

MageSmith

POSTCheckout · Magento 2.4.9 Self (customer or admin)

POST /V1/carts/mine/set-payment-information

Q: What does the POST /V1/carts/mine/set-payment-information endpoint do in Magento 2?

POST /V1/carts/mine/set-payment-information is a Magento 2 REST endpoint in the Checkout module. Set payment information for a specified cart. Requires a customer or admin Bearer token (whichever owns the resource).

Q: What parameters does POST /V1/carts/mine/set-payment-information accept?

This endpoint accepts 3 parameters: cartId (int) required; paymentMethod (Magento\Quote\Api\Data\PaymentInterface) required; billingAddress (Magento\Quote\Api\Data\AddressInterface).

POST /V1/carts/mine/set-payment-information is a Magento 2 REST endpoint in the Checkout module. Set payment information for a specified cart. Requires a customer or admin Bearer token (whichever owns the resource).

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

int

Order ID.

Service contract

Magento\Checkout\Api\PaymentInformationManagementInterface::savePaymentInformation

Authorization

Self — a customer Bearer token (when the caller owns the resource) or an admin token both work.

Body parameters

cartId int Required

paymentMethod Magento\Quote\Api\Data\PaymentInterface Required

billingAddress Magento\Quote\Api\Data\AddressInterface default: null

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> customer or admin token (whoever owns the resource)

Path

/V1/carts/mine/set-payment-information

Body

{
  "billingAddress": {
    "city": "",
    "company": "",
    "country_id": "",
    "custom_attributes": [
      {
        "attribute_code": "",
        "value": ""
      }
    ],
    "customer_address_id": 0,
    "customer_id": 0,
    "email": "",
    "extension_attributes": {},
    "fax": "",
    "firstname": "",
    "id": 0,
    "lastname": "",
    "middlename": "",
    "postcode": "",
    "prefix": "",
    "region": "",
    "region_code": "",
    "region_id": 0,
    "same_as_billing": 0,
    "save_in_address_book": 0,
    "street": [
      {}
    ],
    "suffix": "",
    "telephone": "",
    "vat_id": ""
  },
  "cartId": 0,
  "paymentMethod": {
    "additional_data": [
      {}
    ],
    "extension_attributes": {},
    "method": "",
    "po_number": ""
  }
}