{"record":{"id":"c2b3c31cebf6a452","repo":"antiwork/gumroad","slug":"gift-purchases-cannot-be-on-installment-plans","errorCode":null,"errorMessage":"Gift purchases cannot be on installment plans.","messagePattern":"Gift purchases cannot be on installment plans\\.","errorType":"exception","errorClass":"Purchase::PurchaseInvalid","httpStatus":null,"severity":"error","filePath":"app/services/purchase/create_service.rb","lineNumber":331,"sourceCode":"\n        purchase = result[:purchase] || restartable_subscription.original_purchase\n        self.purchase = purchase\n        Rails.logger.info(\"Subscription #{restartable_subscription.external_id} restarted during checkout for product #{product.id}\")\n        return purchase, nil\n      else\n        return nil, result[:error_message]\n      end\n    end\n\n    def create_gift\n      # A seller buying their own product can only ever be a test purchase, and test purchases were\n      # never built for gifts, so this case has to be rejected. The message names what the seller\n      # actually did and points at the supported way to give a product away, because the old wording\n      # (\"Test gift purchases have not been enabled yet.\") described an internal capability and read\n      # as a flag we could switch on for them, which generated support tickets asking us to do that.\n      raise Purchase::PurchaseInvalid, \"You can't gift your own product. To give it away for free, create a 100% off discount code under Checkout > Discounts and share the checkout link.\" if buyer == product.user\n      raise Purchase::PurchaseInvalid, \"You cannot gift a product to yourself. Please try gifting to another email.\" if giftee_email == purchase_params[:email]\n      raise Purchase::PurchaseInvalid, \"Gift purchases cannot be on installment plans.\" if params[:pay_in_installments]\n\n      if product.can_gift?\n        gift = product.gifts.build(giftee_email:, gift_note: gift_params[:gift_note], gifter_email: params[:purchase][:email], is_recipient_hidden: gift_params[:giftee_email].blank?)\n        error_message = gift.save ? nil : gift.errors.full_messages[0]\n        raise Purchase::PurchaseInvalid, error_message if error_message.present?\n\n        gift\n      else\n        error_message = product.user.gifting_disabled? ? \"The creator has disabled gifting for their products.\" : \"Gifting is not yet enabled for pre-orders.\"\n        raise Purchase::PurchaseInvalid, error_message\n      end\n    end\n\n    def validate_perceived_price\n      if purchase_params[:perceived_price_cents] && !Purchase::MAX_PRICE_RANGE.cover?(purchase_params[:perceived_price_cents])\n        raise Purchase::PurchaseInvalid, \"Purchase price is invalid. Please check the price.\"\n      end\n    end","sourceCodeStart":313,"sourceCodeEnd":349,"githubUrl":"https://github.com/antiwork/gumroad/blob/afeacbd394069a1cbf0c6c50ee8e900925050370/app/services/purchase/create_service.rb#L313-L349","documentation":"Raised when a gift purchase also requests installment payments (params[:pay_in_installments] truthy). Installment plans charge the buyer over time while gifts settle immediately against a recipient-side purchase, so the two options are mutually exclusive in create_gift.","triggerScenarios":"Gift params present (is_gift?) and params[:pay_in_installments] truthy in the same checkout request.","commonSituations":"Buyer toggled installment payments before switching the checkout to a gift and the client kept the flag; integrations that send pay_in_installments unconditionally.","solutions":["Turn off installment payments (pay in full) to gift the product.","Keep installments and remove the gift params to buy for yourself.","Integrators: make the gift and installment options mutually exclusive in the checkout UI."],"exampleFix":"# before: both flags sent together\nparams[:gift] = { giftee_email: 'friend@example.com' }\nparams[:pay_in_installments] = true\n\n# after: gift purchases pay in full\nparams[:pay_in_installments] = false if params[:gift].present?","handlingStrategy":"validation","validationCode":"params[:pay_in_installments] = false if params[:gift].present?","typeGuard":null,"tryCatchPattern":"begin\n  Purchase::CreateService.new(product:, params:, buyer:).perform\nrescue Purchase::PurchaseInvalid => e\n  # ask the buyer to pick one: full-price gift or non-gift installment purchase\n  render_checkout_error(e.message) if e.message == 'Gift purchases cannot be on installment plans.'\nend","preventionTips":["Make the gift and installment options mutually exclusive in the checkout UI.","Clear pay_in_installments whenever the buyer switches the checkout into gift mode."],"tags":["gifting","installments","checkout","gumroad"],"backgroundTag":"gifting-not-allowed","analyzedSha":"afeacbd394069a1cbf0c6c50ee8e900925050370","analyzedAt":"2026-08-21T17:58:52.159Z","schemaVersion":2},"datasetVersion":"2026-08-21T18:17:14.833Z"}