Audience

This document is intended for Netspend’s Partner API developers.

Purpose

This document explains how to create accounts and obtain access tokens in Netspend’s API production environment.

Prerequisites

Before using the instructions in this document, the partner must identify an individual who will be the Partner App Admin. Netspend will create the user and give the user admin privileges to the UAT and production environments.

Create an Account in the live Portal

  1. Access the Dev Portal by following this link: https://developer.netspend.com/
    1
  2. Click the  Sign In/Register button.
    2
    The Account Login page displays.
    2
  3. Click Register Now now. An email verification page displays:
    2
  4. Enter your email address and click the Send Verification Code button.
     A verification code is sent to the email you entered and the following page displays:
    2
  5. Enter the verification code and click the Verify Code button.
    A page displays that allows you to enter your profile information:
    1
  6. Enter your First Name, Last Name and password in the New Password field and confirm it by entering it into the Confirm New Password field. A pop-up is displayed with instructions, if your password does not meet the requirements.
    1
  7. The Register Now button is activated.
    2
  8. Click Register Now. The Multi-Factor Authentication (MFA) screen displays.
    4
  9. Click Get Started. The email verification screen displays.
    2
  10. Select the Stay with email verification radio button, if not already selected.
  11. Click Continue Your account is successfully created and your profile page displays
    1
  12. A Welcome email is sent to your inbox:
    2

You have completed registration! If you experience any issues, please contact your account manager.

Logging as a Netspend User

To login into the developer portal with your Netspend credentials, perform the following steps:

This completes the steps to login into the developer portal using your Netspend credentials.

  1. Access the Dev Portal by following this link: https://developer.netspend.com/
    1
  2. Click the  Sign In/Register button.
    2
    The Account Login page displays:
    2
  3. Enter your Netspend email address. The Account Login page updates and displays the Continue As Employee button.
    2
  4. Click Continue As Employee. The Verify your code screen displays.
    2
  5. Access your Netspend email account for the verification code.
    2
  6. Enter the verification code received on your Netspend email. The Verify button is activated
    2
  7. Click Verify. You are successfully logged into the portal and your profile page displays
    3

This completes the steps to login into the developer portal using your Netspend credentials.

Logging as non-Netspend (other) User

To login into the developer portal with an email other than Netspend, perform the following steps:

This completes the steps to login into the developer portal using your Netspend credentials.

  1. Access the Dev Portal by following this link: https://developer.netspend.com/ 1
  2. Click the  Sign In/Register button.
    2
    The Account Login page displays:
    2
  3. Enter your email address and password.
    n11
  4. Click Log In. The Verify your code screen displays.
    n12
  5. Enter the code received on your email. The Verify button is activated.
  6. Click Verify. You are successfully logged into the portal and your profile page displays.
    n13

This completes the steps to login into the developer portal using your non-Netspend credentials.

Navigating the Live Portal

After you log into the Live Portal, your profile pages displays with links for exploring various parts of the portal.


2

 

 

 

Access Open API Specifications for Netspend’s APIs and Webhooks

 

  1. Click the API link in the live Portal toolbar. The API Catalog page displays.

    2

  2. Click one of the cards to access specifications in the Open API format.

    The corresponding API specification displays. From here you can view the specifications and test APIs. See Obtain Keys for the Test Environment and Test Netspend APIs in the Developer Portal

Access Netspend API Reference

Click the Docs link in the live Portal toolbar.

The API Reference Guide Home page displays with links to details for all of Netspend’s Self Service and Webhooks APIs.
2

 

Access Information For Creating Accounts And Tokens

Click the Quick Guide link in the live Portal toolbar. The Quick Start Guide (this document) displays.

View Teams and Team Apps

Click the Teams link in the live Portal toolbar. The Teams page displays, which lists all the teams you have created.


2

From here you view team details and team apps, and obtain keys for use within your partner applications and Netspend APIs in the test environment.

Access Netspend’s Blogs

Click the Blog link in the Developer Portal toolbar.

The Blog page displays. From here you can view the most recent and most popular blogs, sign up for notifications each time a new blog is posted, and set filters on the types of blogs you want to view.

Access Your Profile Page

Click the My Account link in the Developer Portal toolbar.

From here you can view and edit your profile Information, and access invitations to other teams within the Developer Portal.

Log out of the Developer Portal

Click the Log Out link in the Developer Portal toolbar.

 

Create a Production Access Token

To create an OAUTH access token in the production environment you can use any tool that can submit HTTP requests. This example shows how to create a token using curl.

To form the request, you will need the production API key and secret, both provided to you by your Netspend Product Management point of contact.

 

You pass the API key and secret in the Authorization header. To form the header:

  1. Combine the API key and secret, separated by a colon. Example: "apikey:secret"

  2. Base64-encode the combination, then pass the result in the  Authorization header as in the following example.

Request Example

curl -L -X POST 'https://apis.netspend.com class="brnodisplay" /netspend-api/v1/oauth/accesstoken'

-H 'Content-Type: application/x-www-form-urlencoded'

-H 'Authorization: Basic RzNTMmJYdkJVMGZUelpSUmFuR0F4cFlCYjY2ejVuWEQ6ODhYZkdqa3VD eThuMWt0SQ=='

-- data-urlencode 'grant_type=client_credentials'


Note: The rest of the request content should match the preceding example.

Response Example


The response body contains the following content. The OAuth access token is highlighted in yellow, its life is 24 hours.

{

  "access_token":"Nl6K9cBs IjG1mF9CnqOAjJesIOQn",

  "token_type":"BearerToken",

  "scope":"owned_accounts_full",

  "expires_in":"86399",

}


After you obtain the access token, you can use it in your applications for all calls to the Netspend API.