Connecting Shift4

Maven connects to Shift4 using your Public Key and Secret Key. These credentials allow Maven to create charges and vault cards on your behalf.

Prerequisites

A Shift4 account
Public Key and Secret Key
A Maven app

Getting Your Credentials

Go to Shift4 Dashboard and log in.

Navigate to API Keys

Click API Keys in the left sidebar.

Copy Credentials

You’ll see your:

Public Key (starts with pk_)
Secret Key (starts with sk_)

Use the Test keys for sandbox testing and Live keys for production.

Connecting in Maven

Go to Payments

In the Maven Dashboard, navigate to your app and click the Payments tab.

Click Connect Shift4

Click the Shift4 card and enter your credentials.

Enter Credentials

Public Key: Your Shift4 Public Key
Secret Key: Your Shift4 Secret Key

Save

Click Connect. Maven will validate the credentials and save them.

Sandbox Testing

For testing, use your Test API keys from the Shift4 dashboard. Test keys start with pk_test_ and sk_test_. Use test credentials with mvn_test_ API keys to test without real charges.

Processor Response Fields

Charge Mode

Field	Description
`charge_id`	Shift4 charge ID
`customer_id`	Shift4 customer ID
`card_id`	Shift4 card ID
`card_brand`	Card brand
`card_last4`	Last 4 digits

Tokenize Mode (Vault)

Field	Description
`customer_id`	Shift4 customer ID
`card_id`	Shift4 card ID
`card_brand`	Card brand
`card_last4`	Last 4 digits

Using Tokenized Cards

After tokenizing, use the customer and card IDs to create charges via the Shift4 API:

import httpx

resp = httpx.post(
    "https://api.shift4.com/charges",
    auth=("sk_live_your_secret_key", ""),
    data={
        "amount": 4999,
        "currency": "USD",
        "customerId": "cust_xxx",  # from customer_id
        "card": "card_xxx",        # from card_id
    },
)

​Connecting Shift4

​Prerequisites

​Getting Your Credentials

​Connecting in Maven

​Sandbox Testing

​Processor Response Fields

​Charge Mode

​Tokenize Mode (Vault)

​Using Tokenized Cards