Skip to main content

In-store payments

Basic Authentication

Last updated: 02-Mar-2023

API Key and User ID are required to generate a basic Auth key. API Keys can be directly generated in the Admin Panel.

Perform the following steps to obtain API key.

  1. Go to <Verifone Central || Verifone Developer Portal> -> API Keys. API Keys screen will be displayed.
  2. Login with the credentials provided in your e-mail sent by the Verifone POS Cloud Support team. The Transaction screen will be displayed. Picture
  3. Go to My Account drop box located on the top right corner of the screen. API Keys popup screen will be displayed.Picture
  4. Click Create API Key to generate an API Key. API Key Created pop-up screen will be displayed.Picture
  5. Click Copy public key to copy the API key. Once the key is copied, a success message appears at the bottom right corner of your screen.

NOTE: Ensure that an API key is created for each customer and also ensure to store the API key in a secure place. The API key will get expired one year from the date of activation. The system will automatically send an e-mail notification to renew the API Key. This e-mail is sent every week during the last three months, and every day during the last week before the expiration date.

Follow the steps to create a User ID.

  1. Go to <Verifone Central | | Verifone Developer Portal> -> My Account. The Transactions screen will be displayed.Picture30
  2. Select My Account to locate the User ID.Picture31
  3. Copy the User ID from the latter part of the URL.

 

Encoding API Keys

To encode API keys, follow the authentication method below.

  1. Indicate Authorization: Basic "user-uid:api key" in the header.
  2. Replace the "user-uid" and "api key" values.
  3. Encode the whole string in base64.

For example:
The following "user-uid:api key" string 777c31b3-a85f-4823-93a5-9055d1b:cGEFFLjYuUCtmerXlhTfAdaPpYVnXDJZmg

Result: base64 Nzc3YzMxYjMtYTg1Zi00ODIzLTkzYTUtOTA1NWQxYjpjR0VGRkxqWXVVQ3RtZXJYbGhUZkFkYVBwWVZuWERKWm1n

Header: Authorization: Basic Nzc3YzMxYjMtYTg1Zi00ODIzLTkzYTUtOTA1NWQxYjpjR0VGRkxqWXVVQ3RtZXJYbGhUZkFkYVBwWVZuWERKWm1n

Setting up the Basic Auth in POSTMAN

Following are the steps to generate Basic Auth key:

  1. Go to <POSTMAN>. My Workspace screen will be displayed.Picture32
  2. Enter the API Key and the UID in the respective text boxes.
  3. Go to Authorization tab and select Basic Auth from the TYPE dropdown list.
  4. Enter the User ID in the username field and API Key in the password field to send the request. Picture33
  5. Click Send to set up the basic auth key. The Basic Auth key will be generated in the response field.Picture34
  6. Place the Basic Auth code in the Authentication textbox to test the APIs. 

Run Get Status API to establish the connection and to get the device information. Once the connection is established, other transaction capabilities can be tested using the provided APIs.

  7.  Click Send and wait for the response from the POS Cloud server along with the terminal status.

 NOTE: Ensure the registered terminal details and the connection status are displayed in the response field, the connection status as POS State: Connected.

Need help?

Do you have a question? On our Support page you will find a list with answers to frequently asked questions.
Did not find the answer you are looking for? Please contact us. We are happy to help.

Logo of Verifone