Shift4¶

EXPERIENCE THE FUTURE OF COMMERCE. Accept payments everywhere with Shift4's end-to-end commerce solution.

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the shift4.com/contact-support or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials¶

Credentials that have to be issued:

shiftfour__auth_token → Auth token
shiftfour__client_guid→ Client GUID
shiftfour__clerk_id → Clerk ID
shiftfour__company_name → Company name
shiftfour__interface_name → Interface name
shiftfour__test_mode → true/false
shiftfour__currency → choose currency (You can set these parameters according to available currencies and features for your Shift4 wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

Press Connect at Shift4 Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

Auth token
Client GUID
Clerk ID
Company name
Interface name
Test mode → true/false
Currency → USD

Success

You have connected Shift4 H2H merchant account!

API examples:¶

Minimum data set to create a payment invoices for payment_card_usd_hpp service¶

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_usd_hpp",
      "commerce_account":"Hello World",
      "currency":"USD",
      "amount":25,
      "reference_id":"042048b7-d8c2-4c21-bc2b-548e2134c64c",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":"1"
        }
      },
      "customer":{
        "reference_id":"shift4",
        "first_name":"John",
        "last_name":"Doe",
        "email":"[email protected]",
        "ip":"192.168.1.1"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Maximum data set to create a payment invoices for payment_card_usd_hpp service¶

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_usd_hpp",
      "commerce_account":"Hello World",
      "currency":"USD",
      "amount":25,
      "reference_id":"042048b7-d8c2-4c21-bc2b-548e2134c64c",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":"1"
        }
      },
      "customer":{
        "reference_id":"shift4",
        "first_name":"John",
        "last_name":"Doe",
        "email":"[email protected]",
        "ip":"192.168.1.1",
        "city":"London",
        "postCode":"E16AN",
        "street":"Baker Street"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Provider Options¶

Provider_Options

Charge after failed challenge
- if true, allows an attempt to charge funds even if the user has not authenticated (e.g. entered an incorrect code or clicked "reject"); if false, the payment will be cancelled

Question

"Still looking for help connecting your Shift4 account?" Please contact our support team!