Postman

Postman is a powerful HTTP client for testing the QuickBooks Payments API by displaying requests and responses in manageable formats

 QuickBooks Payments resource endpoints and orchestrations collection (with OAuth 2.0 authorization)

The steps on this page use Postman for Mac, v 5.4.1.

Using Postman

Setup

  1. Create an app.
  2. Download and install Postman: https://www.getpostman.com.
  3. Click the Run in Postman button corresponding to the desired collection from the list above. This sets up the Postman UI and downloads the collection.
  4. Configure the Postman Authorization header.

Make calls

Once you configure Postman authorization header, requests in the Postman collections here will access your sandbox.

  1. For each request, refresh the authorization header:
  1. Select the desired endpoint from the collection. Replace { {baseurl} } with sandbox.api.intuit.com.
The request URL now looks something line this: https:// sandbox.api.intuit.com/v4/customers/<customer-id>/cards/<card-id>
The endpoint-specific parameters <customer-id> and <card-id> are specific to the cards resource.

  1. Click Send to issue the API request.

    qbpayments/docs/develop/explore-the-quickbooks-payments-api/PaymentsSend.jpg

For reference information about a specific endpoint in the collection, see the QuickBooks Payments API reference.

Note

Note

Use this tool only for testing and prototyping your API requests. Use QuickBooks Online SDKs for your production code.

Configuring the Postman Authorization header

Information in this section provides configuration details for the OAuth authorization header, which is supplied with each request to the QuickBooks Online API.

OAuth 2.0

Before submitting a request from the collection, Postman must generate an OAuth 2.0 access token based on OAuth 2.0 keys from your app’s dashboard on developer.intuit.com.

  1. Sign-on to your developer account on developer.intuit.com and click My Apps.
  2. Find and open the app you want to use.
  3. Navigate to the Keys tab on your app’s dashboard. You use the development keys for this configuration.

Now, from the Authorization tab on the Postman UI, for Type select OAuth 2.0 and click Get New Access Token. You need the following information when configuring this dialog:

Postman Authorization Field Information from your developer account
Token Name A user defined name for this token. It appears in the Postman Existing Tokens list to use in Send requests.
Grant Type This must be set to Authorization Code.
Callback URL Enter: https://www.getpostman.com/oauth2/callback. This must also be configured as a Redirect URI on the app’s Keys tab of the app profile via My Apps on the developer site. Make sure to configure this in the development keys section on this tab.
Auth URL https://appcenter.intuit.com/connect/oauth2
Access Token URL https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer
Client ID Obtain these values from the Keys tab on the app profile via My Apps on the developer site. Make sure you get them development keys section on this tab.
Client Secret Obtain these values from the Keys tab on the app profile via My Apps on the developer site. Make sure you get them development keys section on this tab.
Scope Specify: com.intuit.quickbooks.payments openid email profile
State This can be any string. It provides information that might be useful to your application upon receipt of the response. The Intuit Authorization Server roundtrips this parameter, so your application receives the same value it sent.
Client Authentication Set to Send client credentials in body

Using the collections in a production environment

To use the collections in a production environment you need the folllowing: