If the merchant would like to use a logo and/or background image on the hosted payment form, image files must be uploaded to the payment gateway server in order to be displayed properly. The location of the logo and background images on the payment gateway servers must be referenced using the payment form header and footer API fields or the Merchant Interface settings.
To upload a logo or background image to the payment gateway:
Save the file in any of the following formats: .gif, .jpg, or .png (other file formats will not be accepted).
If needed, rename the logo or background image file according to the following Authorize.Net naming conventions:
Only use letters, numbers and/or the underscore character
Do not use spaces
Include the merchant ID and one of the following prefixes for identification purposes: logo_, background_, header_, footer_
Good Examples | Bad Examples |
logo_merchantIDhere.jpg |
logo.jpg |
background_merchantIDhere.png |
background.jpg |
header_merchantIDhere.jpg |
online forms.png |
footer_merchantIDhere.gif |
Send the logo and/or background file in an email to support@authorize.net with the subject line "Payment Form Image Upload." The images are then uploaded to a secure payment gateway server.
To reference the logo or background image, add the following HTML to the payment form request:
Note: The sample code included in this document uses dummy field values (indicated by italics). When testing or using sample code, be sure to enter valid field values.
Sample 1. Including a logo reference in the HTML Form POST
<INPUT TYPE="HIDDEN" name="x_logo_url" VALUE= "https://secure.authorize.net/mgraphics/filename.ext">
|
To add a background image, add:
Sample 2. Including a background image reference in the HTML Form POST
<INPUT TYPE="HIDDEN" name="x_background_url" VALUE= "https://secure.authorize.net/mgraphics/filename.ext">
|
IMPORTANT: Submitting these fields will provide basic placement of the logo and background images on the payment form. To customize the placement of these images on the payment form, they can be referenced in HTML in either the payment form header or footer API fields (x_header_html_payment_form and x_footer_html_payment_form) or in the Merchant Interface payment form header and footer settings.