Process refund for subscription order

Processes a refund for a fulfilled subscription order. This creates a refund in Shopify and returns the money to the customer’s original payment method.

Full behavior, validation rules, and side effects

What it does:

1. Validates order is eligible for refund (fulfilled, not already refunded)
2. Creates refund transaction in Shopify
3. Processes refund with payment gateway
4. Updates order status to ‘Refunded’
5. Sends refund confirmation email to customer
6. Logs refund activity

Refund Eligibility:

• Order must be fulfilled
• Cannot already be refunded
• Must be within merchant’s refund policy window
• Payment gateway must support refunds

Refund Processing:

• Refund is processed to original payment method
• Takes 5-10 business days to appear in customer’s account
• Processing fees are typically not refunded
• Partial refunds are supported (if configured)

Important Warnings:

• This action cannot be undone
• Refunded orders cannot be un-refunded
• Inventory is restocked automatically
• Refunds may incur gateway fees

Authentication: Customer must be logged in and own the subscription

PUT /subscriptions/cp/api/subscription-billing-attempts/refund-fulfillment/{id}

Process refund for subscription order

cURL

curl --request PUT \
  --url https://www.myshop.com/apps/subscriptions/cp/api/subscription-billing-attempts/refund-fulfillment/{id}

200

{
  "success": true,
  "refundId": "123456",
  "refundAmount": 44.49,
  "message": "Refund processed successfully. Amount will appear in 5-10 business days."
}

Path Parameters

id · integer<int64> · required

Billing attempt ID to refund

Query Parameters

subscriptionContractId · integer<int64>

Subscription contract ID for validation

Response

200

application/json

Refund processed successfully