Template sales (one link, many payments)
A template sale is one payment link that many buyers can pay, for example a link you share on a social network. Create it with generate-sale and sale_type: template. The sale_url you get back has the form …/sale/template/<id>.
| Field | Value |
|---|---|
sale_type |
template |
How it works:
- Each payment creates a new sale (
sale_type4,SaleFromTemplate) with its ownpayme_sale_idand its own callbacks. The template sale itself staysinitial. - The link stays open until you cancel it with
cancel-template(send the template's ID assale_payme_id), or untilsale_expiry_secondspasses, if you sent it. Cancelling works only while the template isinitialand sets it tocanceled; payments on it then fail with error305.
Limits:
- You can't send
buyer_keywith a template (error606). echeckisn't supported on templates (error4).
Every other generate-sale field is on Create a sale. A template is not the multi-method checkout (sale_payment_method: multi), which lets one buyer choose how to pay: see Create a multi-method checkout sale.