Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Web Hosting. The merchant must have a website which is hosted and publicly available. The Cascading Style Sheet and company logo are hosted by the merchant.

  2. HTML or Plaintext plain text editor. Form elements will need to be added to existing or new HTML, with either a HTML or Plaintext plan text editor.

  3. Merchant Account. A merchant account is required to begin processing live transactions.

  4. Submit Final Amount Only. 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.

...

You will use the form below to route customers to Hosted Payments. The form will ultimately consist of one or more these request fields:

Field Name

Description

Length

Required

Format

profile_id

Merchant Identifier

20

Y

N

payment_amount

The Amount of the transaction

12

N

N

invoice_number

Custom Invoice Number Field

17

N

A

client_reference_number

Custom Reference Number

96

N

A

Profile ID

This element is mandatory as it is Merchant Identifier routing the customer specifically to your payment page.

...

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.

Fields

Description

tran_type

The transaction type from the original request.

tran_amount

The amount of the transaction.

invoice_number

Identical to the request field of the same name.

currency_code

Defaults to 840 – USD.

client_ref_number

Identical to the request field of the same name.

acct_number

Truncated card or bank account number.

exp_date

Cardholder expiration date.

Format: MMYY

billing_address

Street address entered by the cardholder during checkout.

billing_zip

ZIP Code entered by the cardholder during checkout.

retrieval_ref_number

12-digit MerchantE generated reference number.

auth_code

Authorization code provided by the issuing bank.

resp_code

At this time, resp_code will always be 000 indicating an approved sale.

resp_text

A textual response for the transaction result.

tran_id

 

tran_date

Timestamp of the transaction.

Format: MM/DD/YYYY HH:MM:SS AM/PM

card_id

The returned value is the token for the card which was stored.

Response Example

Refer to the following examples to view the format of response messages that you will receive after sending a request.

...