Skip to main content
Plans are in early access and subject to change. To request Plans access, contact hi@natural.com.
A plan is a subscription, or 2 to 4 installments, that a payer agrees to once in checkout. Natural keeps the card and the agreement, and you charge each later payment when it falls due. Installment plans aren’t available yet.

​
Lifecycle

  1. Create a plan with POST /plans. It starts pending and returns a checkoutUrl.
  2. The payer agrees to the terms and pays payment 1 in checkout. The plan becomes active, and mandateId names the card agreement it charges.
  3. Charge each later payment with POST /plans/{planId}/payments. A payment can be charged from 12:00 UTC on its due date until 30 days later, or until the next payment opens if that’s sooner.
  4. A plan becomes canceled when its agreement ends, or when checkout ends without payment 1. An installment plan becomes finished after its last payment.