{"title":"Apply Provider Voucher Form - Liquid Form Reference","slug":"apply-provider-voucher-form-reference","url":"https://support.storeconnect.com/articles/apply-provider-voucher-form-reference","url_markdown":"https://support.storeconnect.com/articles/apply-provider-voucher-form-reference.md","subtitle":null,"summary":"The `apply-provider-voucher` Liquid form applies a voucher from a specific voucher provider (e.g. a third-party gift card) to the cart at checkout.","type":"Developer_Documentation","video_url":"","keywords":"liquid, forms, apply-provider-voucher, checkout, voucher provider, gift card, storeconnect","last_modified":"2026-07-30T00:28:16+0000","body_markdown":"## Usage\n\n\n```liquid\n\n{% form \"apply-provider-voucher\", provider: voucher_provider %}\n  \u003c!-- Provider-specific fields here --\u003e\n{% endform %}\n```\n\n\nThe `apply-provider-voucher` form applies a voucher issued by a specific voucher provider — for example a third-party gift card — to the current cart. It posts to the same endpoint as the [Apply Voucher](apply-voucher-form-reference) form, but adds a provider discriminator and exposes the fields that the provider's own apply form requires.\n\n| Property | Value |\n|----------|-------|\n| **Form Name** | `apply-provider-voucher` |\n| **Category** | Checkout |\n\n## Parameters\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `provider` | Yes | The voucher provider to apply a voucher from. |\n\n## Fields\n\nThe fields rendered are determined by the selected provider's adapter, so they vary by provider (for example a card number, PIN, and amount). Credential fields such as card numbers and PINs are never replayed from a previous submission, so their values are always blank.\n\nThe form renders nothing if the provider has no registered adapter.\n\n## Form Object\n\nInside the form block, you can access the `form` object which provides:\n\n- `form.errors` — Any validation errors after submission"}