{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"include":{"value":""},"outline":{"value":"false"},"indent":{"value":""},"style":{"value":"none"},"exclude":{"value":"Getting Started"},"type":{"value":"list"},"class":{"value":""},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"d2c99473-68e0-4566-a469-17d58682fa1d"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"97546a7a-ffa7-4435-87a3-e32a9a71d00a"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Getting Started","type":"text"}]},{"type":"paragraph","content":[{"text":"There are few basic requirements to get started:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Web Hosting","type":"text","marks":[{"type":"strong"}]},{"text":". The merchant must have a website which is hosted and publicly available. The Cascading Style Sheet and company logo are hosted by the merchant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML or plain text editor","type":"text","marks":[{"type":"strong"}]},{"text":". Form elements will need to be added to existing or new HTML, with either a HTML or plan text editor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Merchant Account","type":"text","marks":[{"type":"strong"}]},{"text":". A merchant account is required to begin processing live transactions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Submit Final Amount Only","type":"text","marks":[{"type":"strong"}]},{"text":". ME Hosted Checkout will only process the amount sent in the transaction_amount field. Shipping charges, local tax, etc. will need to be accommodated before the transaction is submitted.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Transaction Flow","type":"text"}]},{"type":"paragraph","content":[{"text":"MerchantE’s Hosted Payments will guide your customers through the checkout process to ensure their experience is as simple as possible. When your customer is redirected to your payment page, your customer will have the option to checkout as a guest, create a payment account, or they can log in to make a payment. The checkout experience between guest checkout and a payment account holder checkout is slightly different. Customers that “Checkout as Guest” have a limited view of Hosted Payments.","type":"text"}]},{"type":"paragraph","content":[{"text":" In both cases, the user will the follow the transaction flow:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":453,"id":"889f2c8b-8c24-4fc9-8066-7a59b01073d9","collection":"contentId-3255238692","type":"file","height":147}}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A customer is on a merchant’s e-Commerce website and clicks Checkout.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The customer is redirected to the MerchantE Hosted Payment Page","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The customer enters their payment details and submits the payment.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the payment is approved","type":"text","marks":[{"type":"strong"}]},{"text":", the customer is presented with a payment receipt and has the option to return to the merchant’s website.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the payment is declined","type":"text","marks":[{"type":"strong"}]},{"text":", the customer is presented with a generic payment decline and advised to reach out to the issuer for more details.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Integration with Website","type":"text"}]},{"type":"paragraph","content":[{"text":"The following are the recommended steps to integrate ME’s Hosted Payments into an e-Commerce website. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Obtain a profile ID once the merchant account setup has been completed.","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify or create HTML pages with ‘buy now’ or ‘checkout’ links or images.","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insert Payment Page URL form (shown below) in HTML.","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If necessary, test the form by processing a sale. Ensure that both response URLs function properly.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Payment Page Request Message","type":"text"}]},{"type":"paragraph","content":[{"text":"You will use the form below to route customers to Hosted Payments. The form will ultimately consist of one or more these request fields:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"11b36b4a-9748-4491-9eb8-68b96cd5e48c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"Field Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[311.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"Length","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"Format","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"profile_id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[311.0]},"content":[{"type":"paragraph","content":[{"text":"Merchant Identifier","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"payment_amount","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[311.0]},"content":[{"type":"paragraph","content":[{"text":"The Amount of the transaction","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"12","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"invoice_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[311.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Invoice Number Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"17","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"A","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"client_reference_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[311.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Reference Number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"96","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"A","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Profile ID","type":"text"}]},{"type":"paragraph","content":[{"text":"This element is mandatory as it is Merchant Identifier routing the customer specifically to your payment page.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Payment Amount","type":"text"}]},{"type":"paragraph","content":[{"text":"This element is only necessary if you have the Custom Amount flag turned off, since in that scenario the payment amount will be sent across from your website to Hosted Payments.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": If you do not send the amount when this flag is turned off, a hardcoded $0.00 amount will be sent when the customer navigates to the Hosted Payment Page and the customer will not be able to proceed with payment.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Invoice Number","type":"text"}]},{"type":"paragraph","content":[{"text":"This element is only necessary if you intend on sending an Invoice Number to Hosted Payments. If not, this will automatically be generated once the transaction is processed successfully.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Client Reference Number","type":"text"}]},{"type":"paragraph","content":[{"text":"This element is only necessary if you intend on sending a client reference number from your side to Hosted Payments. If not, this will automatically be generated once the transaction is processed successfully.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Payment Page Request Message Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to the following examples to learn how to format request messages in different scenarios. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"All Optional information sent","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example where ","type":"text"},{"text":"all optional information is sent","type":"text","marks":[{"type":"strong"}]},{"text":", the ","type":"text"},{"text":"Custom Amount is off","type":"text","marks":[{"type":"strong"}]},{"text":". The Invoice and Ref Number fields are sent as part of the request.","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"No Optional Information Sent","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example where ","type":"text"},{"text":"no Optional Information is sent","type":"text","marks":[{"type":"strong"}]},{"text":", the ","type":"text"},{"text":"Custom Amount is on","type":"text","marks":[{"type":"strong"}]},{"text":". The Invoice and Ref Number fields are ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" sent as part of the request.","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Custom Amount turned on","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, the ","type":"text"},{"text":"Custom Amount is turned on","type":"text","marks":[{"type":"strong"}]},{"text":". The Invoice and Ref Number fields are sent as part of the request.","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Custom Amount turned off","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, the ","type":"text"},{"text":"Customer Amount is turned off","type":"text","marks":[{"type":"strong"}]},{"text":". The Invoice and Ref Number fields are ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" sent as part of the request.","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Post Response Message","type":"text"}]},{"type":"paragraph","content":[{"text":"The following table contains each field available in the response. It is not necessary to use response data, though it can be helpful to store transaction data, or for integration efforts.","type":"text"}]},{"type":"paragraph","content":[{"text":"These fields are sent in an HTTP POST to the merchant’s response url once a transaction has been approved. You can set your Response URL in the Advanced URL Management sections of the Settings and Configuration Page in the Hosted Payments Admin section.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"721eba1b-619e-4c8f-9792-97ee1c595ea2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"Fields","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"tran_type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"The transaction type from the original request.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"tran_amount","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"The amount of the transaction.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"invoice_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Identical to the request field of the same name.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"currency_code","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Defaults to 840 – USD.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"client_ref_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Identical to the request field of the same name.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"acct_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Truncated card or bank account number.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"exp_date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Cardholder expiration date.","type":"text"}]},{"type":"paragraph","content":[{"text":"Format: ","type":"text"},{"text":"MMYY","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"billing_address","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Street address entered by the cardholder during checkout.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"billing_zip","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"ZIP Code entered by the cardholder during checkout.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"retrieval_ref_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"12-digit MerchantE generated reference number.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"auth_code","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Authorization code provided by the issuing bank.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"resp_code","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"At this time, resp_code will always be ","type":"text"},{"text":"000","type":"text","marks":[{"type":"strong"}]},{"text":" indicating an approved sale.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"resp_text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"A textual response for the transaction result.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"tran_id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"tran_date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"Timestamp of the transaction.","type":"text"}]},{"type":"paragraph","content":[{"text":"Format: ","type":"text"},{"text":"MM/DD/YYYY HH:MM:SS AM/PM","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"card_id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"text":"The returned value is the token for the card which was stored.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Example","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to the following examples to view the format of response messages that you will receive after sending a request.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Post Response for a Sales Transaction using a Credit Card","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example response message is for a credit card sales transaction.","type":"text"}]},{"type":"codeBlock","content":[{"text":"tran_date=Fri Mar 27 17:42:42 UTC 2020&acct_number=411111XXXXXX1111&tran_amount=500.00& tran_type=Sale&billing_address=123&tran_id=e0266d9ceaf234dd99427aebe1a13393¤cy_code =USD&auth_code=T9939 H&resp_text=ApprovalT9939H&client_ref_number=&retrieval_ref_number= &hpp_tran_id=1971 &billing_zip=12345&resp_code=000&exp_date=1122&invoice_number=","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Post Response for a Sales Transaction using ACH","type":"text"}]},{"type":"paragraph","content":[{"text":"The following response message is for an ACH sales transaction.","type":"text"}]},{"type":"codeBlock","content":[{"text":"auth_type=WEB&amount=500.00&account_type=S&tran_id=1991&ip_address=127.0.0.1&ach_request= SALE&transaction_type=H&ref_num=&resp_text=ACH+IP+Address+Invalid&account_num=XXXXXX4738& profile_key=yyyy&profile_id=xxxx4100006000500000001&transit_num= XXXXX0399&resp_code=811&cust_name=name","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Security Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"These settings are intended for advanced integrations of ME Hosted Checkout, and will require a server-side programming language to implement properly, such as PHP, JSP, ASP, etc. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Security Code","type":"text"}]},{"type":"paragraph","content":[{"text":"The Security Code is a password used to secure requests to ME Hosted Checkout. When a Security Code is set, requests that do not validate will be redirected to the ","type":"text"},{"text":"cancel_url","type":"text","marks":[{"type":"strong"}]},{"text":" appended with the name-pair value ","type":"text"},{"text":"resp_text=invalid_tran_key","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"To validate a request, create an MD5 hash of the following fields (in this order) :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile Key (A security code generated by MerchantE)","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Security Code","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Transaction Amount ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The result of this MD5 hash then needs to be sent in the field ","type":"text"},{"text":"transaction_key","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"PHP Example of MD5 Hash","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example shows how the MD5 hash can be formatted in PHP.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\">","type":"text"}]},{"type":"paragraph","content":[{"text":"There are also two fields:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resp HTTP Username","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Password","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"These fields are used when sending the response data to the ","type":"text"},{"text":"response_url","type":"text","marks":[{"type":"strong"}]},{"text":". If present, standard HTTP authentication will be used.","type":"text"}]},{"type":"paragraph","content":[{"text":"Reading this data will depend on the programming language used, however the first row of the header will be the word BASIC followed by the username and password, Base64 encoded, separated by a colon.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]},{"text":" Header row 1: BASIC dGVzdDp0ZXN0","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]},{"text":". dGVzdDp0ZXN0 Base64 decoded: test:test ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"PHP Example for retrieving Apache headers","type":"text"}]},{"type":"paragraph","content":[{"text":"The following PHP function will return the decoded authentication pair (test:test in the above example).","type":"text"}]},{"type":"codeBlock","content":[{"text":"function getHttpCredentials() {\n$headers = apache_request_headers();\nforeach ($headers as $header => $value) {\nif(strtolower(substr($value, 0, 5)) == 'basic') {\nreturn base64_decode(substr($value, 6));\n }\n }\n}","type":"text"}]}],"version":1}

Browser not supported