Set up Heartland payments
Heartland is a direct payment processor option in Rex. Enter your Heartland API credentials to start accepting credit card payments at checkout.
1
Open the Payment Settings modal
On the venue details page, click the **Payment** settings card. The Payment Settings modal opens.
Venues›[Your Venue]
2
Turn off Sandbox mode
If the **Sandbox mode** toggle is on, switch it off. Sandbox mode uses Rex test credentials and simulates payments — no real money is charged. Turn it off to configure live payment processing.
3
Select Heartland as the payment processor
From the **Payments** dropdown, select **Heartland**. Four credential fields appear.
4
Enter your Heartland credentials
Fill in all four fields with values from your Heartland merchant account:
| Field | Description |
|---|---|
| Payment key | Your Heartland public API key (starts with `pkapi_`). |
| Payment secret | Your Heartland secret API key (starts with `skapi_`). |
| Payment URL | The Heartland Portico gateway endpoint. |
| Payment MID | Your Heartland merchant ID. |
5
Save changes
Click **Save changes**. All four fields are required — the modal will not save if any field is empty.
Updated May 12, 2026
Was this helpful?