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 Type | URL |
---|---|
environment | https://api.emergepay-sandbox.chargeitpro.com/virtualterminal/v1 |
assets | https://assets.emergepay-sandbox.chargeitpro.com |
Production Account
URL Type | URL |
---|---|
environment | https://api.emergepay.chargeitpro.com/virtualterminal/v1 |
assets | https://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.
Name | Shared Test Value |
---|---|
OID | 1394243001 |
authToken | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0aWQiOjEyLCJmcW9pZCI6IjEtMTM5NDI0MzAwMSIsInRva2VuX3VzZSI6Im9ydCIsInJuZCI6MTI2MTI5MzY4Ni45MDc4MTc4LCJncm91cHMiOlsiT3JnQVBJVXNlcnMiXSwiaWF0IjoxNTIzOTk2OTQ5fQ.SpHIMHvvpg83oXLQPDoy8c5Z3k6fAXuSudZ9s2aaA9c |
Sandbox Endpoint
URL Type | URL |
---|---|
device | https://api.emergepay-sandbox.chargeitpro.com/device/v1/ |
assets | https://assets.emergepay-sandbox.chargeitpro.com/ |
Production Endpoint
URL Type | URL |
---|---|
device | https://api.emergepay.chargeitpro.com/device/v1/ |
assets | https://assets.emergepay.chargeitpro.com/ |