Miva Merchant 4 Module FAQs » Gift Certificate Manager (BROK_CERTIFICATES)
The Gift Certificate Manager needs to be registered on the template module's "third party tokens" tab. Aftering registering it, the instructions link will explain where to place the necessary tokens to display the redemption field on the "shipping/billing selection" page.
However, the abiltiy of the Gift Certificate Manager to "bypass shipping and payment selection" for $0.00 orders cannot be accomplished with %module tokens alone. To enable that feature follow these instructions:
In the template that you have assigned to the OSEL screen (the pre-installed template intended for this page is the "Checkout: Shipping/Payment Selection" template) replace the token:
%beginform|OSEL|%
with:
%begin_if|g.BrokCerts_OSEL_suppress|%
<FORM METHOD="post" ACTION="%var|g.secure_sessionurl|%">
<INPUT TYPE="hidden" NAME="Action" VALUE="AUTH">
<INPUT TYPE="hidden" NAME="Screen" VALUE="INVC">
<INPUT TYPE="hidden" NAME="Store_Code" VALUE="%var|g.Store_Code|%">
<INPUT TYPE="hidden" NAME="ShippingMethod" VALUE="">
<INPUT TYPE="hidden" NAME="PaymentMethod" VALUE="">
%else%
<FORM METHOD="post" ACTION="%var|g.secure_sessionurl|%">
<INPUT TYPE = "hidden" NAME = "Action" VALUE = "SHIP,CTAX">
<INPUT TYPE = "hidden" NAME = "Screen" VALUE = "OPAY">
<INPUT TYPE = "hidden" NAME = "ShopTax_Select" VALUE = "%var|g.ShopTax_Select|%">
<INPUT TYPE="hidden" NAME="Store_Code" VALUE="%var|g.Store_Code|%">
this is, by default, right above a <table tag. Right below the matching </table> tag for this table, place:
%end_if%
and replace the %endform% token with </form>
In the template that you have assigned to the OPAY screen (the pre-installed template intended for this page is the "Checkout: Payment" template) replace the token:
%beginform|OPAY|%
with:
%module1|BROK_CERTIFICATES|OPAY_message|%
%begin_if|g.BrokCerts_OPAY_suppress|%
<FORM METHOD="post" ACTION="%var|g.secure_sessionurl|%">
<INPUT TYPE="hidden" NAME="Action" VALUE="AUTH">
<INPUT TYPE="hidden" NAME="Screen" VALUE="INVC">
<INPUT TYPE="hidden" NAME="Store_Code" VALUE="%var|g.Store_Code|%">
<INPUT TYPE="hidden" NAME="PaymentMethod" VALUE="">
%else%
<FORM METHOD = "post" ACTION = "%var|g.OPAY_url|%">
<INPUT TYPE = "hidden" NAME = "Action" VALUE = "AUTH">
<INPUT TYPE = "hidden" NAME = "Screen" VALUE = "INVC">
<INPUT TYPE = "hidden" NAME = "Store_Code" VALUE = "%var|g.Store_Code|%">
<INPUT TYPE = "hidden" NAME = "PaymentMethod" VALUE = "%var|g.PaymentMethod|%">
(NOTE that the token %module1|BROK_CERTIFICATES|OPAY_message|% displays the "payment information message", but this token is REQUIRED as it sets the necessary variables. IF you do not want to display any message, clear out the field in the Gift Certificate Manager admin)
there are two tables right below this point, the second table contains teh %paymentfields% token. Right below that table, place:
%end_if%
and replace the %endform% token with </form>
Integrating with OPT
Integrating Gift Certificate Manager with Other Page Templates
The Gift Certificate Manager needs to be registered on the template module's "third party tokens" tab. Aftering registering it, the instructions link will explain where to place the necessary tokens to display the redemption field on the "shipping/billing selection" page.
However, the abiltiy of the Gift Certificate Manager to "bypass shipping and payment selection" for $0.00 orders cannot be accomplished with %module tokens alone. To enable that feature follow these instructions:
In the template that you have assigned to the OSEL screen (the pre-installed template intended for this page is the "Checkout: Shipping/Payment Selection" template) replace the token:
%beginform|OSEL|%
with:
%begin_if|g.BrokCerts_OSEL_suppress|%
<FORM METHOD="post" ACTION="%var|g.secure_sessionurl|%">
<INPUT TYPE="hidden" NAME="Action" VALUE="AUTH">
<INPUT TYPE="hidden" NAME="Screen" VALUE="INVC">
<INPUT TYPE="hidden" NAME="Store_Code" VALUE="%var|g.Store_Code|%">
<INPUT TYPE="hidden" NAME="ShippingMethod" VALUE="">
<INPUT TYPE="hidden" NAME="PaymentMethod" VALUE="">
%else%
<FORM METHOD="post" ACTION="%var|g.secure_sessionurl|%">
<INPUT TYPE = "hidden" NAME = "Action" VALUE = "SHIP,CTAX">
<INPUT TYPE = "hidden" NAME = "Screen" VALUE = "OPAY">
<INPUT TYPE = "hidden" NAME = "ShopTax_Select" VALUE = "%var|g.ShopTax_Select|%">
<INPUT TYPE="hidden" NAME="Store_Code" VALUE="%var|g.Store_Code|%">
this is, by default, right above a <table tag. Right below the matching </table> tag for this table, place:
%end_if%
and replace the %endform% token with </form>
In the template that you have assigned to the OPAY screen (the pre-installed template intended for this page is the "Checkout: Payment" template) replace the token:
%beginform|OPAY|%
with:
%module1|BROK_CERTIFICATES|OPAY_message|%
%begin_if|g.BrokCerts_OPAY_suppress|%
<FORM METHOD="post" ACTION="%var|g.secure_sessionurl|%">
<INPUT TYPE="hidden" NAME="Action" VALUE="AUTH">
<INPUT TYPE="hidden" NAME="Screen" VALUE="INVC">
<INPUT TYPE="hidden" NAME="Store_Code" VALUE="%var|g.Store_Code|%">
<INPUT TYPE="hidden" NAME="PaymentMethod" VALUE="">
%else%
<FORM METHOD = "post" ACTION = "%var|g.OPAY_url|%">
<INPUT TYPE = "hidden" NAME = "Action" VALUE = "AUTH">
<INPUT TYPE = "hidden" NAME = "Screen" VALUE = "INVC">
<INPUT TYPE = "hidden" NAME = "Store_Code" VALUE = "%var|g.Store_Code|%">
<INPUT TYPE = "hidden" NAME = "PaymentMethod" VALUE = "%var|g.PaymentMethod|%">
(NOTE that the token %module1|BROK_CERTIFICATES|OPAY_message|% displays the "payment information message", but this token is REQUIRED as it sets the necessary variables. IF you do not want to display any message, clear out the field in the Gift Certificate Manager admin)
there are two tables right below this point, the second table contains teh %paymentfields% token. Right below that table, place:
%end_if%
and replace the %endform% token with </form>
Last update: 2004-12-09 05:53
Author: Support
Revision: 1.0
You cannot comment on this entry
Records in this category
- How to Configure a Gift Certificate to Charge Shipping to Redeemer, but Shipping Will be Paid by Gift Certificate
- How to Sell Gift Certificates Within Your Store
- Collecting a Recipient's Name, Email Address, Etc.
- How to Automatically Send Emails to the Recipient
- Unable to get Attributes to Collect the Customer's Data
- Integrating with OPT
- I am using OUISM and need to display the error messages returned by the Gift Certificate Manager. How can I do that?
- I have a module which collects data during checkout but when a customer clicks on "redeem" to redeem a certificatethe data collected by my module is lost. What's happenging and can I fix it?
- The "redemption" field is not showing up during checkout. What am I doing wrong?
- How can I display the remaining certificate balance to the customer?
- Can I display the gift certificate that I created with the "certificate template" to the customer?
- I'd like to be able to have my customers visit my site to view their certificate. How can I go about this?
- When attempting to view the certificates in admin I get a "404 file not found" error (or some other server error).
- How do I prevent shipping from being charged when someone purchases a gift certificate?
- How do I restrict the use of a certificate to a particular product (or How do limit a certificate so that it cannot be used on a particular product)?
- Can I display the certificate redemption field in the Phone Order Manager (http://vikingcoders.com/go.mv?ID=BROK_PHONEORDERS) interface?














