Elavon Payment Gateway

Elavon's hosted payment gateway (EPG). Secure payment links for a booking, paid on Elavon's own page, with your hotel as merchant of record. Elavon Payment Gateway official site ↗

What it covers

Payment links and what happened to them. Once certified, the concierge can create a payment link for an amount the booking flow provides, share it with the guest, and read back whether it was paid. The guest enters their card on Elavon's hosted page — card details never pass through Maison, and your hotel stays the merchant of record. Staff-facing tools cover refunds, voids, captures, cancelling a link, and reading the merchant, account and transaction records Elavon holds. Every tool is listed below as not yet certified until Maison has run it against your sandbox.

Elavon is a family of gateways, not one product. This integration is for Elavon Payment Gateway (EPG). Merchant accounts on Converge or Fusebox use different APIs and are not covered — check which one your Elavon portal login belongs to before connecting.

What you need

Your merchant alias, issued by Elavon for the merchant account the concierge should act for.
A secret API key (it starts with sk_). The public pk_ key is not accepted — it only works for hosted card forms, which Maison does not use.
Whether links should charge immediately or authorise for a later capture, and how many hours a link stays open.

The concierge never asks a guest for a card number, and never calls a booking paid because a link was created. A payment counts only when Elavon reports a completed transaction for that specific link.

Setup steps

Get your EPG credentials from Elavon
Ask your Elavon contact for the merchant alias and secret API key for the account the concierge should use. Elavon issues them by hand; there is no self-service key page yet.
Enter them in the admin console
Paste the merchant alias and secret key on the integration's settings page and save. They are encrypted at rest and never shown again.
Choose capture mode and link lifetime
Pick whether a paid link charges the card immediately or only authorises it, and how many hours a link stays open before it expires. Optionally choose the Elavon account if the merchant has more than one.
Run a sandbox payment
With sandbox credentials, ask the concierge for a payment link for a small amount, pay it with an Elavon test card, and confirm the transaction reads as captured. Maison certifies the tools after this check.

Available tools

21 tools are available for Elavon Payment Gateway. The concierge calls them on a guest's behalf during a conversation; which are enabled is set per property, so you only turn on what you want it to be able to do.

Enabled by default (7)

On as soon as the integration is connected, with nothing else to configure.

Tool	What it does
`elavon_get_account`	OPERATOR-GRADE: Retrieve details for a specific Elavon account.
`elavon_get_accounts`	OPERATOR-GRADE: List all virtual-terminal accounts available under this merchant.
`elavon_get_merchant`	OPERATOR-GRADE: Retrieve details for a specific Elavon merchant by ID.
`elavon_get_merchants`	OPERATOR-GRADE: List all merchants configured under this Elavon account.
`elavon_get_payment_link`	Retrieve the current state and URL of a payment link.
`elavon_get_processor_accounts`	OPERATOR-GRADE: List processor accounts (gateway processors) linked to this merchant.
`elavon_list_transactions`	List transactions. Use the filter param to narrow by state or type (e.g. state_in_authorized,captured). Only one filter expression per call (field_op_value grammar with underscores).

Available on request (14)

Off by default. Ask Maison to enable any of these for your property — several change data in your Elavon Payment Gateway account, so they are opt-in rather than assumed.

Tool	What it does
`elavon_cancel_payment_link`	OPERATOR-GRADE: Cancel an active payment link so it can no longer be paid. Cannot be undone.
`elavon_create_payment_link`	Create a hosted-payment URL to send to a guest. The link charges the card immediately (capture on payment). Expires after the configured TTL. Each link is limited to one payment (conversionLimit: 1). shopperEmailAddress is required — Elavon sends an automatic receipt to the guest.
`elavon_create_shopper`	Create a shopper profile for a returning guest to enable stored-card use on future visits.
`elavon_email_receipt`	Email a transaction receipt to a guest's address.
`elavon_get_notification`	Retrieve the full payload of a specific Elavon notification event.
`elavon_get_order`	Retrieve details for a specific order.
`elavon_get_payment_link_events`	List events (viewed, attempted, completed, cancelled) for a specific payment link.
`elavon_get_shopper`	Retrieve a shopper profile by ID.
`elavon_get_shopper_stored_cards`	List stored-card tokens for a shopper. Returns only last-four digits and card brand — never full card data.
`elavon_get_transaction`	Retrieve details for a single transaction (sale, refund, or void).
`elavon_list_notifications`	List webhook notification events received from Elavon. Use the filter param to narrow by eventType (e.g. eventType_eq_saleAuthorized). Only one filter expression per call (field_op_value grammar with underscores).
`elavon_list_payment_links`	List payment links. Use the filter param to narrow results (e.g. status_eq_active or status_in_active,expired). Only one filter expression per call (field_op_value grammar with underscores).
`elavon_list_shoppers`	List shopper profiles. Use the filter param to search by email or name (e.g. email_eq_guest@example.com). Only one filter expression per call (field_op_value grammar with underscores).
`elavon_update_shopper`	Update contact details on an existing shopper profile.

Not yet certified (3)

Built and working against the Elavon Payment Gateway API, but Maison is not yet certified with Elavon Payment Gateway to use them in production, so they cannot be enabled today. Listed so you can see what is coming rather than discover the gap when you ask for it.

Tool	What it does
`elavon_capture_transaction`	OPERATOR-GRADE: Capture a previously authorized transaction using the EPG partial-captures endpoint.
`elavon_refund_transaction`	OPERATOR-GRADE: Refund a captured transaction. Omit amount and currencyCode to refund the full amount; provide both for a partial refund.
`elavon_void_transaction`	OPERATOR-GRADE: Void an authorized transaction before it is captured. Cannot be undone.