Set Payment Method

Select a payment method for the order checkout.

Endpoint

POST /api/shop/checkout/payment-method

Request Headers

Header	Required	Description
Content-Type	Yes	application/json
X-STOREFRONT-KEY	Yes	Your storefront API key
Authorization	Yes	Bearer token (customer login required)

Request Body

{
  "payment": {
    "method": "paypal"
  }
}

Payment Method Options

Common payment methods:

• paypal - PayPal
• stripe - Stripe
• cod - Cash on Delivery
• bank_transfer - Bank Transfer

Response Fields (200 OK)

Field	Type	Description
paymentMethod	object	Selected payment method details
message	string	Success message

Payment Method Fields

Field	Type	Description
method	string	Payment method code
title	string	Display name
description	string	Method description
instructions	string	Payment instructions

Use Cases

• Select PayPal payment
• Choose credit card
• Use cash on delivery
• Select bank transfer
• Finalize payment details

Validation Rules

• Payment method must be available
• Must have valid billing address
• Some methods restricted by location
• Payment may require additional setup

Related Resources

• Get Payment Methods
• Set Billing Address
• Place Order