diff --git a/content/docs/admin-api/guides/payment-methods/shop-pay.mdx b/content/docs/admin-api/guides/payment-methods/shop-pay.mdx index e9a8909..13ba89d 100644 --- a/content/docs/admin-api/guides/payment-methods/shop-pay.mdx +++ b/content/docs/admin-api/guides/payment-methods/shop-pay.mdx @@ -13,7 +13,7 @@ import { Callout } from 'fumadocs-ui/components/callout'; For custom Shop Pay checkouts, there are two checkout flows available, the standard method where a user enters their shipping address, chooses products, and then checks out via Shop Pay; and the "One-Click" method, where the user is not required to enter shipping information before being redirected to Shop Pay checkout. -Your store must have an active Shop Pay account to use the Shop Pay payment method. +Your store must have an active Shop Pay account to use the Shop Pay payment method. Merchants connect one under **Settings > Payments > Shop Pay**; see [Shop Pay](https://docs.nextcommerce.com/docs/features/payments/shop-pay) in the merchant docs for setup. ## API Payment Redirect Flow @@ -63,3 +63,17 @@ Shop Pay does not support one-click upsells through the [ordersAddLineItemsCreat ## Recurring Shop Pay does not support recurring transactions and cannot be used as a payment method for an order with subscription items. + +## Capture and Refunds + +Capture timing follows the **Payment capture method** set in the merchant's Shop Pay store in Shopify. With **Automatically at checkout**, which is the recommended setting, payments are captured when the customer pays. With **Manually**, payments are only authorized: Shopify holds them for 7 days, and NEXT's auto-capture (on fulfillment or after a delay) doesn't apply to `shop_pay` yet, so capture them through the [capture API](/docs/admin-api/reference/orders/ordersCaptureCreate) or the dashboard. + +- **Capture** is full amount only. Partial captures aren't supported. +- **Refunds** can be full or partial once the payment is captured. Refunds can return as pending until Shopify confirms them. +- **Refunding an uncaptured order** voids the whole authorization, whatever amount you request. +- **Disputes** are handled in the merchant's Shop Pay store in Shopify admin, not in NEXT. + +## Campaigns API + +Campaigns built on the [Campaigns API](/docs/campaigns/api) accept `shop_pay` as a payment method and follow the same redirect flow. Shop Pay must be enabled as a payment method on each campaign. +