Network Token
Overview
The Network Token is intended to provide you with the ability to interface with other Spinwheel partners as it relates to passing leads, reducing authentication friction, decreasing costs, and reducing redundant data pulls for a connected user.
Partner Configuration
All partners using the Network Tokens will be required to have a configuration added to their partner setup to ensure they have access to the specific API functionalities. The Network Token process works on a Producer-Consumer relationship, which ensures that Tokens are not accessible between partners who have not consented to interact with Network Token data.
Please confirm with your Spinwheel representative which partners you expect to be interfacing with using the Network Token.
Network Token: User Creation
As a consumer of the Token you will need to follow the API steps outlined here. As shown in the API, you will need to provide some user data as confirmation that you have the required consent to connect this user, which means the producer will need to provide some supporting details alongside the Token, such as date of birth, last four digits of the social security number, and an audit object of the user consent date.
Assuming all fields have been provided correctly, the noted API will trigger a user creation for that Network Token and will contain all of the data fields as if the user completed the connect steps above. This user will now be eligible to have a credit report, score, and other features enrolled on the Spinwheel platform under your partner.

Network Token: User Creation with Debt Profile Snapshot
Spinwheel offers the ability to connect a user via Network token with their existing Debt Profile data. This follows the same workflow with the addition of the include array. When noting a CREDIT_REPORT there, the successfully connected user will return a snapshot reference of the user's already existing credit report within their Debt Profile.
When utilizing the include parameter, you will return a dataStatus.statusCode - below is the breakdown for potential responses:
| Code | status | Meaning | API response example |
|---|---|---|---|
| 2000 | SUCCESS | Response includes creditReports, liabilities, and summaries. | Success with credit report |
| 4040 | ERROR | User is successfully connected, however no credit report was found for the user. | Credit report not found |
| 4030 | ERROR | User is successfully connected, however no credit report data was returned. Contact your Spinwheel Representative for Client Configuration. | Credit bureau not configured |
| 5000 | ERROR | User is successfully connected, however the credit report failed to return. | Credit report failed |
Updated 3 days ago

