The Reference Docs Developer Hub

Welcome to the Reference Docs developer hub. You'll find comprehensive guides and documentation to help you start working with Reference Docs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Prepaid Account Balance

Have subscribers prepay for their future purchases and collect cash immediately. You can now drive higher acquisition and conversion rates by offering discounts to your customers if they make a prepayment.

Overview

Allows customers to pay in advance and have money added to an account balance which can be used to pay for future subscription and one time purchase invoices. Specifically, a customer can make a purchase that is immediately reflected in the customer’s account balance. Then as the customer is invoiced, the customer’s prepaid balance is automatically deducted by the invoiced amount. This way, merchants can collect payments upfront instead of at the time of invoice.

With Prepaid Account Balance, merchants can reduce transaction costs significantly. There are no transaction fees or interchange charges when a subscriber is using the account balance. Have your subscribers add to their prepaid account balance for subscriptions that have multiple billing periods in a term or for micro-transactions.

How to create a Prepaid Account Balance

Prepaid Account Balance can be updated in API V2, API V3, or the Admin Console.

  • For the V3 API, create a Purchase request for a line_item with an "origin" = "prepayment" .
  • For the V2 API, create a Purchase for a charge adjustment with an "origin" = "prepayment".
  • For the Recurly Admin Console, create a charge with a timeframe of immediately. Select Prepaid Account Balance and provide an amount. You can preview the charge before it is created.

When the purchase request is successful, the amount of the transaction will be added to the Account Balance. All future subscriptions and one time purchases will pull from the account balance until it reaches zero. When the account balance reaches zero, the card on file will be billed for future transactions. If the purchase transaction fails, the invoice will be marked as failed and will not be collected by dunning.

The Hosted Account Management page will display the account balance, active subscriptions and all associated invoices to provide clarity for subscribers.

The Hosted Account Management page will display the account balance, active subscriptions and all associated invoices to provide clarity for subscribers.

A few things to note about Prepaid Account Balances:

  • Must be tax-exempt. Taxes should be charged if needed when the actual product/service is sold.
  • Purchase requests to add to the prepaid account balance should not be combined with other line items in the request.
  • Purchase requests for the prepaid account balance must be invoiced immediately and can't be invoiced at renewal.
  • Credits from prepaid account balance cannot pay for additional account balances. Prepaid balances will not be used towards subsequent prepaid account balance purchases.
  • Account balance from credits on an account will be used towards the prepaid amount. If an account has $10 of credit and adds a $100 prepaid account balance, only $90 will be charged to the payment method used for the transaction.
  • Revenue Recognition for account balance will need to be managed by the merchant. Specify how you want to recognize the balance and the subsequent subscriptions/one time purchases. In order to keep your books aligned, recognize revenue on the initial purchase or the subsequent purchases but not both.
  • See Adjustments for the order of how credits and account balance are used on invoices.
  • If Account Hierarchy is enabled on your site, Credit invoices from the parent account can be used to pay for the child account

Prepaid Account Balance for Manual Invoices

If the collection method is set to Manual, the account balance will be updated immediately with the prepaid amount. If an ACH, direct debit, or other payment method is used that doesn't receive an immediate response, the credit invoice is available before the charge invoice is paid. Ensure you have a proper collection process to collect the manual invoices.

Refunds

Prepaid account balances that haven't been utilized can be refunded. The amount will be refunded back to the original payment method. Each invoice will have an associated credit and charge invoice which can be used for the refund. If the account balance has already been utilized, the invoice will not be refundable.

Prerequisites

  • Credit Invoices and Only Bill What Changed must be enabled to utilize the prepaid account balance.
  • Available on all Recurly plans

Updated 29 days ago

Prepaid Account Balance


Have subscribers prepay for their future purchases and collect cash immediately. You can now drive higher acquisition and conversion rates by offering discounts to your customers if they make a prepayment.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.