Environments and Assets

Please be advised

All of our sample code utilizes the sandbox environment and asset URLs, these will need to be changed before moving to production.

The URLs below are referenced in the code samples as environment_url and assets_url.

As noted above, your environment_url, assets_url, OID, and authToken will all need to be updated accordingly as you switch between your production and sandbox environments.

Sandbox Account

URL TypeURL
environmenthttps://api.emergepay-sandbox.chargeitpro.com/virtualterminal/v1
assetshttps://assets.emergepay-sandbox.chargeitpro.com

Production Account

URL TypeURL
environmenthttps://api.emergepay.chargeitpro.com/virtualterminal/v1
assetshttps://assets.emergepay.chargeitpro.com

Credentials

Want your own credentials?

Below are our shared test credentials for the sandbox environment.

For your own private test credentials and login information to our Dashboard to see your test transactions in real-time, please connect with your Integration Specialist.

Merchant credential best practices

Credentials (OID, or organization ID, and authToken) are specific to each merchant’s account.

Most merchants will have one merchant account per location, while some may choose to have separate accounts in order to separate their payment device transactions from their e-commerce transactions.

Partner level credentials

As a Developer you can create a partner authToken tied to your Gravity Payments partner account that you can submit with each merchant’s unique OID when making API requests. The partner authToken will authorize all requests for merchants associated with that partner account.

Alternatively, you can obtain separate merchant authTokens that are associated with each individual merchant location as described above. Those merchant authTokens can authorize requests for that merchant account only.

Using a partner authToken can facilitate the merchant onboarding process as you will not need to wait for credentials to be generated for each merchant before you can begin submitting transactions on their behalf. Also with merchant specific authTokens, you would be required to store a dedicated authToken in your software application for each merchant, whereas with a partner authToken you need to store only one authToken for authorizing all requests for all of your merchants.

When submitting requests with either partner or merchant authTokens, you will need to include the merchant’s OID as part of your request data, as the OID is used along with your authToken to authorize your requests.

NameShared Test Value
OID1394243001
authTokeneyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0aWQiOjEyLCJmcW9pZCI6IjEtMTM5NDI0MzAwMSIsInRva2VuX3VzZSI6Im9ydCIsInJuZCI6MTI2MTI5MzY4Ni45MDc4MTc4LCJncm91cHMiOlsiT3JnQVBJVXNlcnMiXSwiaWF0IjoxNTIzOTk2OTQ5fQ.SpHIMHvvpg83oXLQPDoy8c5Z3k6fAXuSudZ9s2aaA9c

Sandbox Endpoint

URL TypeURL
devicehttps://api.emergepay-sandbox.chargeitpro.com/device/v1/
assetshttps://assets.emergepay-sandbox.chargeitpro.com/

Production Endpoint

URL TypeURL
devicehttps://api.emergepay.chargeitpro.com/device/v1/
assetshttps://assets.emergepay.chargeitpro.com/