Synapse

API Rate Limits

The following is a table of the the most common API calls and their respective rate limits. These limits cannot be increased. Please take this into account when building out your application.

HTTP Verb

URL

Functionality

Rate Limits (per min/per user)

POST

/oauth/<user:id>

This API call allows you to get oauth_key for users.

POST

/oauth/<user:id>/login

Using basic auth to get refresh_token for users.

GET

/users

View all users created with your client keys (paginated).

100

POST

/users

Allows you to register a new user.

100

GET

/users/<user:id>

View user info and refresh_token.

PATCH

/users/<user:id>

Add/update KYC, log in credentials, profile, etc.

GET

/users/<user:id>/nodes

View all nodes linked to a user (paginated).

100

POST

/users/<user:id>/nodes

Allows you to create a deposit account or link an external bank account to a user.

100

GET

/users/<user:id>/nodes/<node:id>

View node info.

100

PATCH

/users/<user:id>/nodes/<node:id>

Update supp_id, verify micro-deposits, etc.

100

DELETE

/users/<user:id>/nodes/<node:id>

Unindex node from a user.

100

POST

/users/<user:id>/nodes/<node:id>/subnets

Allows you to issue a virtual account number on top of a node.

100

GET

/users/<user:id>/nodes/<node:id>/subnets

View all subnets linked to a node (paginated).

100

GET

/users/<user:id>/nodes/<node:id>/subnets/<subnet:id>

View subnet info.

100

PATCH

/users/<user:id>/nodes/<node:id>/subnets/<subnet:id>

Update subnet info.

100

GET

/users/<user:id>/trans

View all transactions of a user (paginated).

100

GET

/users/<user:id>/nodes/<node:id>/trans

View all transactions of a node (paginated).

100

POST

/users/<user:id>/nodes/<node:id>/trans

Allows you to create a transaction.

100

GET

/users/<user:id>/nodes/<node:id>/trans/<trans:id>

View transaction info.

100

PATCH

/users/<user:id>/nodes/<node:id>/trans/<trans:id>

Update notes on a transaction.

100

DELETE

/users/<user:id>/nodes/<node:id>/trans/<trans:id>

Only works if transaction has been created or queued.

100

GET

/subscriptions

View all subscriptions created with your client keys (paginated).

POST

/subscriptions

Create a subscription with webhook preferences.

GET

/subscriptions/<subscription:id>

View a subscription.

PATCH

/subscriptions/<subscription:id>

Update scope, url, is_active, etc.

GET

<:user_id>/statements

View a users statement

GET

<:node_id>/statements

View a node statements

Client Libraries

Language-specific SDKs built around the Synapse API

Currently in Beta

Instead of using the API directly, you can use our client libraries:

Python | JavaScript | Ruby | PHP | Go

Deprecated Client Libraries

For platforms using older versions of the client libraries we recommend updating to the new libraries above. The older libraries are no longer maintained and will soon be deprecated.

Note: The older client libraries do not support changing an account from personal to business. To use this and other newer features, we recommend upgrading to a newer library.

Library Initialization

import synapsepy

client = Client(
	client_id='client_id_1239ABCdefghijk1092312309',
	client_secret='client_secret_1239ABCdefghijk1092312309',
	fingerprint='1023918209480asdf8341098',
	ip_address='1.2.3.132',
	devmode=True
)

const Synapse = require('synapsenode');
const Client = Synapse.Client;

const client = new Client({
  client_id: process.env.CLIENT_ID,
  client_secret: process.env.CLIENT_SECRET,
  fingerprint: process.env.FINGERPRINT,
  ip_address: '<ip_address>',
  isProduction: false
});

args = {
  # synapse client_id
  client_id:        ENV.fetch("client_id"),
  # synapse client_secret
  client_secret:    ENV.fetch("client_secret"),
  # a hashed value, either unique to user or static for app
  fingerprint:      "fp",
  # end user's IP
  ip_address:       'ip',
  # (optional) requests go to sandbox endpoints if true
  development_mode: true,
  # (optional) if true logs requests to stdout
  logging: true,
  # (optional) file path to write logs to
  log_to: nil,
  # (optional) rases for 2FA and MFA if set to true
  raise_for_202: true
}

client  = Synapse::Client.new(args)

require_once 'vendor/synapsefi/synapsephp/synapse_rest/client.php';

$clientObj = (object) [
   'client_id' => 'your_client_id',
   'client_secret' => 'your_client_secret',
   'fingerprint' => '|your_finger_print',
   'ip_address' => 'your_ip_address',
   'devmode' => True,
   'logging' => True,
   'handle202' => True
];
client = Client($clientObj);

import github.com/SynapseFI/SynapseGo

// credentials used to set headers for each method request
var client = synapse.New(
"CLIENT_ID",
"CLIENT_SECRET",
"FINGERPRINT",
"IP_ADDRESS",
)

Automatic OAuth Updates

You do not need to add oauth_key to the headers after a user is created and authentication is performed. The libraries automatically do that for you.

Encrypting Sensitive Information

Best Practices

Whenever transmitting sensitive information such as passwords, card numbers, or pins the data should be encrypted. This adds a necessary layer of protection for your users.

Information to Encrypt

Below is are lists of information that must be encrypted before you send it to Synapse. You may use the associated public key to encrypt the information.

Padding

Please make sure you are using PKCS1_v1_5 padding for encrypting your data

Bank Logins

Field

Required By

info.bank_id

Link w/ Bank Login

info.password

Link w/ Bank Login

mfa_answer

Link w/ Bank Login

If you wish to encrypt bank login info while transmitting the information from the client device, you can use the following encryption key.

Bank Logins Public Key

Interchange and Debit Cards

Field

Required By

card_number

Link a Card

exp_date

Link a Card

pin

Interchange (Link Card) Public Keys

Sandbox Public Key for Linking Cards

SANDBOX - Interchange (Link Card) Public Key

Production Public Key for Linking Cards

PRODUCTION - Interchange (Link Card) Public Key

Legacy Card Issuance (Subnets-Debit Card) Public Keys

Sandbox Set PIN Public Key for Legacy Card Issuance

Use the following public key when setting a PIN with Native Card Issuance in Sandbox or when sending card_number and exp_date to link a card in Sandbox.

SANDBOX - Legacy Card Issuance (Subnets-Debit Card) Public Key

Production Set PIN Public Key for Legacy Card Issuance

Use the following public key when setting a PIN with Native Card Issuance in Production or when sending card_number and exp_date to link a card in Production.

PRODUCTION - Legacy Card Issuance (Subnets-Debit Card) Public Key

Native Card Issuance Public Keys

Use the following public key when setting a PIN with Native Card Issuance in Sandbox.

SANDBOX - Set PIN - Native Card Issuance Public Key

Use the following public key when setting a PIN with Native Card Issuance in Production.

PRODUCTION - Set PIN - Native Card Issuance Public Key

Common Errors

Common errors returned and their formats

The API returns JSON with an error code and description in case of any error during the request as shown. In case the error is in a specific field, it also returns the field name in an error object.

Response

{
  "error": {
    "en": "Generic Error Description"
  },
  "error_code": "400",
  "http_code": "409",
  "success": false
}

Understanding Error Codes

Please remember to check the http_status, error_status, and JSON associated with the error response to better understand the error.

Error Messages

When building out your application, we recommend relying only on the HTTP Status and Error Codes for your error handling logic. Error messages are subject to change.

HTTP Status Codes and Error Status Codes

List of Codes

Master list of codes

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Verify Address

Check if an address is valid

posthttps://uat-api.synapsefi.com/v3.1/address-verification

Request Body

Key

Type

Description

address_street

string

[Required] Street address associated with the document owner, this can be home address of a person or business address of a corp. Please include apartment suite or unit numbers

address_city

string

[Required] City associated with the document owner, this can be home address of a person or business address of a corp

address_subdivision

string

[Required] State abbreviation associated with the document owner. This value needs to be in ISO Alpha-2 (i.e. CA)

address_country_code

string

[Required] Country associated with the document owner, this can be home address of a person or business address of a corp. This value needs to be in ISO Alpha-2 (i.e. US)

address_postal_code

string

[Required] Postal code associated with the document owner, this can be home address of a person or business address of a corp

Deliverability

View Results in Right Panel for Example Responses

Deliverability Result

Description

usps_deliverable

Standard supplied address is a USPS deliverable address.

deliverable

Address is deliverable based on supplemental check. Check normalized_address object in response for deliverable address to use (e.g. in case "ST" supplied when deliverable address has "AVE").

deliverable_incorrect_unit

Base address is deliverable but supplied unit appears incorrect (e.g. actual unit number may be "APT 103" and original input may point to a non-existent unit like "APT 1003").

deliverable_missing_unit

Base address is deliverable but expected unit was not supplied. Check normalized_address object in response for deliverable address to use.

deliverable_unnecessary_unit

Address is deliverable but additional unit supplied when not necessary.

google_undeliverable

User will not be verified, please try reentering or inputting a new address.

Deliverability Analysis Object

Key

Type

Description

deliverability_analysis. partial_valid

boolean

True if address is partially valid.

deliverability_analysis. primary_number_invalid

boolean

True if primary address number is invalid.

deliverability_analysis. primary_number_missing

boolean

True if primary address number is missing.

deliverability_analysis. secondary_invalid

boolean

True if secondary address line (e.g. unit) is invalid or unnecessary.

deliverability_analysis. secondary_missing

boolean

Secondary address line (e.g. unit) missing.

HTTP

POST /v3.1/address-verification HTTP/1.1
Host: uat-api.synapsefi.com
Content-Type: application/json

{
  "address_street": "170 St Germain St",
  "address_city": "SF",
  "address_subdivision": "CA",
  "address_country_code": "US",
  "address_postal_code": "94404"
}

200 google_undeliverable

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

200 usps_deliverable

200 deliverable

200 deliverable_incorrect_unit

200 deliverable_missing_unit

200 deliverable_unnecessary_unit

{
  "deliverability": "usps_deliverable",
  "deliverability_analysis": {
    "partial_valid": false,
    "primary_number_invalid": false,
    "primary_number_missing": false,
    "secondary_invalid": false,
    "secondary_missing": false
  },
  "normalized_address": {
    "address_city": "SAN FRANCISCO",
    "address_country_code": "US",
    "address_postal_code": "94114",
    "address_street": "170 SAINT GERMAIN AVE",
    "address_subdivision": "CA"
  }
}

{
    "deliverability": "google_undeliverable",
    "deliverability_analysis": {
        "partial_valid": true,
        "primary_number_invalid": true,
        "primary_number_missing": false,
        "secondary_invalid": false,
        "secondary_missing": false
    },
    "normalized_address": {
        "address_city": "SAN FRANCISCO",
        "address_country_code": "US",
        "address_postal_code": "94114",
        "address_street": "17 SAINT GERMAIN AVE",
        "address_subdivision": "CA"
    }
}

{
  "deliverability": "deliverable",
  "deliverability_analysis": {
    "partial_valid": false,
    "primary_number_invalid": false,
    "primary_number_missing": false,
    "secondary_invalid": false,
    "secondary_missing": false
  },
  "normalized_address": {
    "address_city": "SUMMERSIDE",
    "address_country_code": "CA",
    "address_postal_code": "C1N 1C4",
    "address_street": "370 WATER ST",
    "address_subdivision": "PE"
  }
}

{
  "deliverability": "deliverable_incorrect_unit",
  "deliverability_analysis": {
    "partial_valid": true,
    "primary_number_invalid": false,
    "primary_number_missing": false,
    "secondary_invalid": true,
    "secondary_missing": false
  },
  "normalized_address": {
    "address_city": "SAN FRANCISCO",
    "address_country_code": "US",
    "address_postal_code": "94105",
    "address_street": "1 MARKET ST STE BAB",
    "address_subdivision": "CA"
  }
}

{
  "deliverability": "deliverable_missing_unit",
  "deliverability_analysis": {
    "partial_valid": true,
    "primary_number_invalid": false,
    "primary_number_missing": false,
    "secondary_invalid": false,
    "secondary_missing": true
  },
  "normalized_address": {
    "address_city": "SAN FRANCISCO",
    "address_country_code": "US",
    "address_postal_code": "94105",
    "address_street": "1 MARKET ST",
    "address_subdivision": "CA"
  }
}

{
  "deliverability": "deliverable_unnecessary_unit",
  "deliverability_analysis": {
    "partial_valid": true,
    "primary_number_invalid": false,
    "primary_number_missing": false,
    "secondary_invalid": true,
    "secondary_missing": false
  },
  "normalized_address": {
    "address_city": "CORONADO",
    "address_country_code": "US",
    "address_postal_code": "92118",
    "address_street": "255 ALAMEDA BLVD UNIT 5",
    "address_subdivision": "CA"
  }
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Verify Routing Number

View the details of a routing number for verification

posthttps://uat-api.synapsefi.com/v3.1/routing-number-verification

Request Object

Key

Type

Description

routing_num

string

Routing number of bank

type

string

Type of account (i.e. ACH-US)

HTTP

POST /v3.1/routing-number-verification HTTP/1.1
Host: uat-api.synapsefi.com
Content-Type: application/json

{
  "routing_num": "084008426",
  "type": "ACH-US"
}

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "address": "5050 POPLAR AVENUE, MEMPHIS, TN, US",
  "bank_code": "ibn",
  "bank_name": "Independent Bank (TN)",
  "horizontal_logo": "https://cdn.synapsepay.com/bank_logos_v3p1/Independent Bank (TN)_h.png",
  "logo": "https://cdn.synapsepay.com/bank_logos_v3p1/Independent Bank (TN)_v.png",
  "meta": {
    "primary_color": "EE3124",
    "secondary_color": "000000"
  },
  "name": "INDEPENDENT BANK",
  "url": "http://www.independent-bank.com"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View All Users

Get a list of users and their information

gethttps://uat-api.synapsefi.com/v3.1/users

Query Params

page

int32

Page number

per_page

int32

Number of users per page

query

string

Name/Email to search

show_refresh_tokens

string

[yes/no] If user objects should have refresh tokens

Users Object

Key

Type

Description

error_code

string

See Common Errors for more information

http_code

string

See Common Errors for more information

limit

integer

Number of users per page

page

integer

Page number

page_count

integer

Number of pages

success

boolean

Request success

users[]

array of objects

List of user objects. See View User for more information

users_count

integer

Total number of users

GET /v3.1/users HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

users = client.get_all_users()

users = client.getAllUsers();

client.get_users()

$client->get_all_users();

data, err := client.GetUsers()

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "page": 1,
  "page_count": 688,
  "success": true,
  "users": [
    {
      "_id": "594dad16838454002da3015f",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/594dad16838454002da3015f"
        }
      },
      "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFI"
      },
      "documents": [
        {
          "entity_scope": "Arts & Entertainment",
          "entity_type": "M",
          "id": "189d2fc37c1ee5694aa62f302bcd7c0efa",
          "id_score": 0.95,
          "name": "Charlie Brown",
          "permission_scope": "SEND|RECEIVE|1000|DAILY",
          "physical_docs": [
           {
              "document_type": "GOVT_ID_BACK",
              "id": "07520abc16d0fa4224af7e53d6f57b69080c531a176dcfa249ec570f9192e09e",
              "last_updated": 1498262807101,
              "status": "SUBMITTED|VALID"
            },
            {
              "document_type": "GOVT_ID",
              "id": "c1a1e29ee0d1d0eeacbbafe5d386498d4f5274a4b7499559544d75a964a05e77",
              "last_updated": 1498262807101,
              "status": "SUBMITTED|VALID"
            }
          ],
          "social_docs": [
            {
              "document_type": "PHONE_NUMBER",
              "id": "54522fd5748d2dedeab0034a09f91",
              "last_updated": 1498262807104,
              "status": "SUBMITTED|VALID"
            },
            {
              "document_type": "FACEBOOK",
              "id": "0c32234c59b71311b0f3057635",
              "last_updated": 1498262807104,
              "status": "SUBMITTED|VALID"
            },
            {
              "document_type": "EMAIL",
              "id": "2c45158f6431ca874bbe82",
              "last_updated": 1498262807104,
              "status": "SUBMITTED|VALID"
            },
            {
              "document_type": "IP",
              "id": "28d9177b22c127d9a51d8903",
              "last_updated": 1498262807104,
              "status": "SUBMITTED|VALID"
            }
          ],
          "virtual_docs": [
            {
              "document_type": "SSN",
              "id": "acaff78248e74aac19c2a4531",
              "last_updated": 1498262807099,
              "status": "SUBMITTED|INVALID"
            }
          ],
          "watchlists": "NO_MATCH"
        }
      ],
      "emails": [],
      "extra": {
        "cip_tag": 1,
        "date_joined": 1498262801436,
        "extra_security": true,
        "is_business": false,
        "is_trusted": true,
        "last_updated": 1498262807088,
        "public_note": null,
        "supp_id": "122eddfgbeafrfvbbb"
      },
      "is_hidden": false,
      "legal_names": [
        "Charlie Brown"
      ],
      "logins": [
        {
          "email": "[email protected]",
          "scope": "READ_AND_WRITE"
        }
      ],
      "permission": "SEND-AND-RECEIVE",
      "phone_numbers": [
        "[email protected]",
        "901.111.1111"
      ],
      "photos": [],
      "refresh_token": "refresh_xsAb2Pv9Sf8QNBq1yMhlcGoTwVJ0mEUjeF3XnILi",
      "watchlists": "NO_MATCH"
    },
    {
      ...
    },
    {
      ...
    }
  ],
  "users_count": 13760
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View User

Get user information by user ID

gethttps://uat-api.synapsefi.com/v3.1/users/user_id

Path Params

user_id

string

required

Object ID of user

Query Params

full_dehydrate

string

[yes/no] Return all available user information including address information, screening results, etc.

User Object

Key

Type

Description

_id

string

Object ID of the user

_links.self.href

string

HAL-style link for the object

client.id

string

Object ID of client

client.name

string

Name of the client that created the user

documents[]

array of objects

List of Base Document Objects

extra.cip_tag

integer

Customer Identification Program number

extra.date_joined

integer

Date user joined (milliseconds since Unix epoch time).

extra.is_business

boolean

Flag for businesses

extra.is_trusted

boolean

Flag for trusted users

extra.last_updated

integer

Date user was last updated (milliseconds since Unix epoch time).

extra.supp_id

string

Additional ID to assign to user

legal_names

array of strings

Legal names associated with the user

logins[]

array of objects

List of login objects

permission

string

See User Permissions for more information

phone_numbers

array of strings

List of emails and phone numbers for verifying MFA

refresh_token

string

User-specific refresh token for oauth (expires after 10 uses)

watchlists

string

Flag to indicate if user is a SOFT_MATCH or MATCH in watchlists / sanctions lists checks performed by Synapse's KYC verification system. Verified users who pass these checks should have NO_MATCH reflected for this flag, while unverified users will generally show as PENDING. See Sanctions Tiers and Watchlists Explained for more information.

Login Object

Key

Type

Description

email

string

scope

string

Permissions granted to login credentials

Additional Information

Use this call when you need to:

Grab a new refresh_token from the user (for Issue OAuth Key)
View KYC documents, including those not stored on your servers
Check the status of a user's documents

GET /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

user_id = “594e0fa2838454002ea317a0”

client.get_user(user_id)

const userID = '594e0fa2838454002ea317a0';

client.getUser(userID);

user_id = “594e0fa2838454002ea317a0”

client.get_user(user_id: user)

$user_id = '5c65b5b47f9c208c97ea1e7e';

$user = $client->get_user($user_id);

userID := “594e0fa2838454002ea317a0”

user, err := client.GetUser(userID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

400 Bad Request

{
  "_id": "594e0fa2838454002ea317a0",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/594e0fa2838454002ea317a0"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "id_score": 0.95,
      "name": "Test User",
      "permission_scope": "SEND|RECEIVE|TIER|1",
      "physical_docs": [
       {
          "document_type": "GOVT_ID_BACK",
          "id": "07520abc16d0fa4224af7e53d6f57b69080c531a176dcfa249ec570f9192e09e",
          "last_updated": 1498288034877,
                    "status": "SUBMITTED|VALID"
                },
        {
          "document_type": "GOVT_ID",
          "id": "c486c2cb8c1bce695fcfae3197e14aa5b8ddec184c2779d00d581abee5d9a04c",
          "last_updated": 1498288034877,
          "status": "SUBMITTED|VALID"
        }
      ],
      "social_docs": [
        {
          "document_type": "FACEBOOK",
          "id": "8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7",
          "last_updated": 1498288034880,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1498288034880,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1498288034880,
          "status": "SUBMITTED|VALID"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1498288034875,
          "status": "SUBMITTED|VALID"
        }
      ],
      "watchlists": "NO_MATCH"

    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1498288029784,
    "extra_security": false,
    "is_business": false,
    "is_trusted": true,
    "last_updated": 1498288034864,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]",
    "901.111.1111"
  ],
  "photos": [],
  "refresh_token": "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
  "watchlists": "NO_MATCH"  
}

{
  "error": {
    "en": "Unable to locate object. Unable to locate user object with filter {'_id': ObjectId('594e0fa2838454002ea317a0')}"
  },
  "error_code": "404",
  "http_code": "404",
  "success": false
}

View User w/ Full Dehydrate

Return all available user information including address information, screening results, etc.

gethttps://uat-api.synapsefi.com/v3.1/users/user_id?full_dehydrate=yes

Path Params

user_id

string

required

Object ID of user

Query Params

full_dehydrate

string

required

yes

Prerequisite to Using This API Call

Your platform will need to have purchased the "KYC and Sanctions" Data service as part of its contract with Synapse in order to use the View User w/ Full Dehydrate call.

User Object

Key

Type

Description

_id

string

Object ID of the user

_links.self.href

string

HAL-style link for the user object

client.id

string

ID of the client that created the user

client.name

string

Name of the client that created the user

documents[]

array of objects

extra.cip_tag

integer

Customer Identification Program number

extra.date_joined

integer

Date user joined (milliseconds since Unix epoch time).

extra.is_business

boolean

Flag for businesses

extra.is_trusted

boolean

Flag for trusted users

extra.last_updated

integer

Date user was last updated (milliseconds since Unix epoch time).

extra.supp_id

string

Additional ID to assign to the node

legal_names

array of strings

Legal names associated with the user

logins[]

array of objects

List of login objects

permission

string

See User Permissions for mor information

phone_numbers

array of strings

List of emails and phone numbers for verifying MFA

refresh_token

string

User-specific refresh token for oauth (expires after 10 uses)

Login Object

Key

Type

Description

email

string

scope

string

Permissions granted to login credentials

Full Dehydrate Base Document Object

Key

Type

Description

address_city

string

City associated with the document owner, this can be home address of a person or business address of a corp

address_country_code

string

Country associated with the document owner, this can be home address of a person or business address of a corp. This value needs to be in ISO Alpha-2 (i.e. US)

address_postal_code

string

Postal code associated with the document owner, this can be home address of a person or business address of a corp

address_street

string

Street address associated with the document owner, this can be home address of a person or business address of a corp. Please include apartment suite or unit numbers

address_subdivision

string

State abbreviation associated with the document owner. This value needs to be in ISO Alpha-2 (i.e. CA) for US states

alias

string

Alias of the document owner (this can be the name or in case of businesses it can be the DBA entry)

day

string

In case of a person this is day of birth. In case of business entity, this is day of organization

email

string

Email associated with the document

entity_scope

string

See Base Documents for more information

entity_type

string

See Base Documents for more information

string

Base document ID

string

IP of where the document is being submitted from

month

string

In case of a person this is month of birth. In case of business entity, this is month of organization

name

string

Name of the document owner

permission_scope

string

See Base Documents Intro for more information

phone_number

string

Phone number associated with the document

physical_docs

array of objects

screening_results

array of objects

List of screening tests and results. If MATCH user may require further investigation

social_docs

array of objects

virtual_docs

array of objects

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Full Dehydrate Sub-Document Object

Key

Type

Description

document_type

string

Type of sub-document (EMAIL, PHONE_NUMBER, AOI, etc.)

document_value

string

Value of sub-document (may be hashed depending on the type of document)

string

ID of the sub-document

last_updated

string

Date sub-document was last updated (milliseconds since Unix epoch time)

meta.matches.address

string

Address match

meta.matches.dob

string

Date of birth match

meta.matches.identification

string

Identification match

GET /v3.1/users/594e0fa2838454002ea317a0?full_dehydrate=yes HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

user_id = “594e0fa2838454002ea317a0”

client.get_user(user_id, full_dehydrate=True)

const userID = '594e0fa2838454002ea317a0';
const fullDehydrate = true;

client.getUser(userID, fullDehydrate);

user_id = “594e0fa2838454002ea317a0”

client.get_user(use_id: user, full_dehydrate: true)

$full_dehydrate = 'yes';
$user_id = '5c65b5b47f9c208c97ea1e7e';

$user = $client->get_user($user_id, $full_dehydrate);

userID := “594e0fa2838454002ea317a0”
queryParams := "full_dehydrate=yes"

user, err := client.GetUser(userID, queryParams)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

400 Bad Request

{
  "_id": "594e0fa2838454002ea317a0",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/594e0fa2838454002ea317a0"
    }
  },
  "_v": 2,
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "address_city": "SF",
      "address_country_code": "US",
      "address_postal_code": "94114",
      "address_street": "1 Market St.",
      "address_subdivision": "CA",
      "alias": "Test",
      "day": 2,
      "email": "[email protected]",
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "id_score": 0.95,
      "ip": "::1",
      "month": 5,
      "name": "Test User",
      "permission_scope": "SEND|RECEIVE|TIER|1",
      "phone_number": "901.111.1111",
      "physical_docs": [
        {
          "document_type": "GOVT_ID_BACK",
          "document_value": "https://cdn.synapsepay.com/uploads/2019/09/06/x05PvNUbO2VX98rTnJQzaAwiuF7KCgy41ljEeh6HYWkqZd3pRG.gif",
          "id": "07520abc16d0fa4224af7e53d6f57b69080c531a176dcfa249ec570f9192e09e",
          "last_updated": 1498288034877,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 1
          },
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "GOVT_ID",
          "document_value": "https://cdn.synapsepay.com/uploads/2017/06/24/DioeVvEbMOfxzpLGZNCPnJKYuHQ7t89s4FBmTk00rRgyc35WXU.gif",
          "id": "c486c2cb8c1bce695fcfae3197e14aa5b8ddec184c2779d00d581abee5d9a04c",
          "last_updated": 1498288034877,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 1
          },
          "status": "SUBMITTED|VALID"
        }
      ],
      "screening_results": {
        "561": "NO_MATCH",
        "aucl": "NO_MATCH",
        "concern_location": "NO_MATCH",
        "dpl": "NO_MATCH",
        "dtc": "NO_MATCH",
        "el": "NO_MATCH",
        "eucl": "NO_MATCH",
        "fatf_non_cooperative_jurisdiction": "NO_MATCH",
        "fbi_bank_robbers": "NO_MATCH",
        "fbi_counter_intelligence": "NO_MATCH",
        "fbi_crimes_against_children": "NO_MATCH",
        "fbi_criminal_enterprise_investigations": "NO_MATCH",
        "fbi_cyber": "NO_MATCH",
        "fbi_domestic_terrorism": "NO_MATCH",
        "fbi_human_trafficking": "NO_MATCH",
        "fbi_murders": "NO_MATCH",
        "fbi_violent_crimes": "NO_MATCH",
        "fbi_wanted_terrorists": "NO_MATCH",
        "fbi_white_collar": "NO_MATCH",
        "fincen_red_list": "NO_MATCH",
        "fse": "NO_MATCH",
        "fto_sanctions": "NO_MATCH",
        "futures_sanctions": "NO_MATCH",
        "hkma_sanctions": "NO_MATCH",
        "hm_treasury_sanctions": "NO_MATCH",
        "isn": "NO_MATCH",
        "mas_sanctions": "NO_MATCH",
        "monitored_location": "NO_MATCH",
        "ns-isa": "NO_MATCH",
        "ofac_561_list": "NO_MATCH",
        "ofac_eo13645": "NO_MATCH",
        "ofac_fse": "NO_MATCH",
        "ofac_fse_ir": "NO_MATCH",
        "ofac_fse_sy": "NO_MATCH",
        "ofac_isa": "NO_MATCH",
        "ofac_ns_isa": "NO_MATCH",
        "ofac_plc": "NO_MATCH",
        "ofac_sdn": "NO_MATCH",
        "ofac_ssi": "NO_MATCH",
        "ofac_syria": "NO_MATCH",
        "ofac_ukraine_eo13662": "NO_MATCH",
        "osfi": "NO_MATCH",
        "pep": "NO_MATCH",
        "plc": "NO_MATCH",
        "primary_concern": "NO_MATCH",
        "sdn": "NO_MATCH",
        "ssi": "NO_MATCH",
        "tel_sanctions": "NO_MATCH",
        "ukcl": "NO_MATCH",
        "uvl": "NO_MATCH"
      },
      "social_docs": [
        {
          "document_type": "FACEBOOK",
          "document_value": "https://www.facebook.com/valid",
          "id": "8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7",
          "last_updated": 1498288034880,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 1
          },
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "PHONE_NUMBER",
          "document_value": "901.111.1111",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1498288034880,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 1
          },
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "document_value": "[email protected]",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1498288034880,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 1
          },
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "IP",
          "document_value": "::1",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1498288034880,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 1
          },
          "status": "SUBMITTED|VALID"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "document_value": "2222",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1498288034875,
          "meta": {
            "matches": {
              "address": "not_found",
              "dob": "not_found",
              "identification": "not_found"
            },
            "retry_count": 2
          },
          "status": "SUBMITTED|VALID"
        }
      ],
      "watchlists": "NO_MATCH",
      "year": 1989
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1498288029784,
    "extra_security": false,
    "is_business": false,
    "is_trusted": true,
    "last_updated": 1498288034864,
    "note": null,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "flag": "NOT-FLAGGED",
  "ips": [
    "127.0.0.1"
  ],
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]",
    "901.111.1111"
  ],
  "photos": [],
  "refresh_token": "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
  "watchlists": "NO_MATCH"  
}

{
  "error": {
    "en": "Unable to locate object. Unable to locate user object with filter {'_id': ObjectId('594e0fa2838454002ea317a0')}"
  },
  "error_code": "404",
  "http_code": "404",
  "success": false
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Create User w/ KYC

posthttps://uat-api.synapsefi.com/v3.1/users

Request Body

Key

Type

Description

logins[]

array of objects

[Required] List of login credentials

phone_numbers

array of strings

[Required] All the phone numbers you wish to register with this account

legal_names

array of strings

[Required] All the legal names you wish to register with this account

documents[]

array of objects

List of user KYC documents. See Base Documents for more information

extra.cip_tag

integer

CIP tag associated with the account

extra.extra_security

boolean

If you wish for the user to get a 2FA code every time they OAuth or Login themselves, set this to true

extra.note

string

Any note that you wish to supply to Synapse about the user (not returned with user object)

extra.public_note

string

Any note that you wish to attach to the user (returned with user object)

extra.is_business

boolean

Set to true if business account

extra.supp_id

string

[Max Characters: 250] Additional ID to assign to the node

User Login Credentials Object

Key

Type

Description

email

string

[Required] Login email

password

string

[Required] Must be at least 8 characters long and include a combination of the following: a lowercase letter, an uppercase letter, a number, and a special character

POST /v3.1/users HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "logins": [
    {
      "email": "[email protected]",
      "password": "8AD999FdD522A0BC5D84933BEF09?943"
    }
  ],
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "legal_names": [
    "Test User"
  ],
  "documents": [
    {
      "email": "[email protected]",
      "phone_number": "901.111.1111",
      "ip": "::1",
      "name": "",
      "alias": "",
      "entity_type": "LLC",
      "entity_scope": "Arts & Entertainment",
      "day": 2,
      "month": 5,
      "year": 1989,
      "address_street": "1 Market St.",
      "address_city": "SF",
      "address_subdivision": "CA",
      "address_postal_code": "94105",
      "address_country_code": "US",
      "virtual_docs": [],
      "physical_docs": [],
      "social_docs": []
    }
  ],
  "extra": {
    "supp_id": "122eddfgbeafrfvbbb",
    "cip_tag": 1,
    "is_business": true
  }
}

body = {
  "logins": [
    {
      "email": "[email protected]"
    }
  ],
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "legal_names": [
    "Test User"
  ],
  ...
}

client.create_user(body)

client.createUser({
  logins: [
    {
      email: '[email protected]'
    }
  ],
  phone_numbers: [
    '901.111.1111',
    '[email protected]'
  ],
  legal_names: [
    'Test User'
  ],
  ...
});

body = {
  "logins": [
    {
      "email": "[email protected]"
    }
  ],
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "legal_names": [
    "Test User"
  ],
  ...
}

client.create_user(payload: body)

$logins_object = (object) [
  'email' => '[email protected]'
];
$legalnames_array = array();
$legalnames_array[] = 'test';

$phoneNumbers_array = array();
$phoneNumbers_array[] = '901.111.1111';

$logins_array = array();
$logins_array[] = $logins_object;
$body = (object) [
  'login_obj' => $logins_obj
  'legal_names' => '$legal_names',
  'phone_number' => '$phone_number'
];

$newuser = $client->create_user($body);

body = `{
  "logins": [
    {
      "email": "[email protected]"
    }
  ],
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "legal_names": [
    "Test User"
  ],
  ...
}`

data, err := client.CreateUser(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa575eaf3f300689a49dd",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa575eaf3f300689a49dd"
    }
  },
  "client": {
    "id": "5beb506f6d7ceb002490631d",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "LLC",
      "id": "90ef29abef3019223ae06c46d775fb47c37b635ded928b8f3bb5270760a45aad",
      "id_score": 0.95,
      "name": "",
      "permission_scope": "UNVERIFIED",
      "physical_docs": [],
      "social_docs": [
        {
          "document_type": "EMAIL",
          "id": "5525ec87ba67bf30171955a04964c5632e273758e696bd0511d65d804b32189e",
          "last_updated": 1552590195485,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552590195490,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552590195642,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552590195779,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "ADDRESS",
          "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
          "last_updated": 1552590195699,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "virtual_docs": [],
      "watchlists": "PENDING"

    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552590194140,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552590194140,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "UNVERIFIED",
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_BIZcntlaEiquKpJy0mdvHf3QPYGsjMg8bCFwLNke",
  "watchlists": "PENDING"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Create User w/o KYC

posthttps://uat-api.synapsefi.com/v3.1/users‌‌

Request Body

Key

Type

Description

logins[]

array of objects

[Required] List of login credentials

phone_numbers

array of strings

[Required] All the phone numbers you wish to register with this account

legal_names

array of strings

[Required] All the legal names you wish to register with this account

documents[]

array of objects

User KYC documents

extra.cip_tag

integer

CIP tag associated with the account

extra.extra_security

boolean

If you wish for the user to get a 2FA code every time they OAuth or Login themselves, set this to true

extra.note

string

Any note that you wish to supply to Synapse about the user (not returned with user object)

extra.public_note

string

Any note that you wish to attach to the user (returned with user object)

extra.is_business

boolean

Set to true if business account

extra.supp_id

string

Additional ID to assign to node

User Login Credentials Object

Key

Type

Description

email

string

[Required] Login email

password

string

[Required] Must be at least 8 characters long and include a combination of the following: a lowercase letter, an uppercase letter, a number, and a special character

HTTP

POST /v3.1/users HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "logins": [
    {
      "email": "[email protected]",
      "password": "8AD999FdD522A0BC5D84933BEF09?943"
    }
  ],
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "legal_names": [
	  "Test User"	
  ],
  "documents":[],
  "extra": {
    "supp_id": "122eddfgbeafrfvbbb",
    "cip_tag":1,
    "is_business": false
  }
}

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa2e2eaf3f300689a4588",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa2e2eaf3f300689a4588"
    }
  },
  "client": {
    "id": "5beb506f6d7ceb002490631d",
    "name": "SynapseFI"
  },
  "documents": [],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552589537830,
    "extra_security": false,
    "is_business": false,
    "is_trusted": true,
    "last_updated": 1552589537830,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "UNVERIFIED",
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_gxQw9MsVblGiJTyZrPUNkWhjqz2m68R7c5D30ufL",
  "watchlists": "PENDING"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update User Status

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

permission

string

User permission status. See Users Intro for more information

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_GXAMgwobNa0J9ziqW2hnfBycU0m7RTFS5sEeP1l8|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "permission":"MAKE-IT-GO-AWAY"
}

body = {
  "permission":"MAKE-IT-GO-AWAY"
}

user.update_info(body)

const body = {
  permission:"MAKE-IT-GO-AWAY"
}
user.updateUser(body);

body = {
  "permission":"MAKE-IT-GO-AWAY"
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'permission' => 'MAKE-IT-GO-AWAY`
    )
  )
);

$client->update_info($body);

body := `{
  "permission":"MAKE-IT-GO-AWAY"
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bb155ddaadcf02b6d902620",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb155ddaadcf02b6d902620"
    }
  },
  "client": {
    "id": "5ade26b4567a900029e2afd2",
    "name": "Synapsefi"
  },

  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "LLC",
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "id_score": 0.95,
      "name": "Test User",
      "permission_scope": "SEND|RECEIVE",
      "physical_docs": [
        {
          "document_type": "GOVT_ID",
          "id": "67ebd5ba7ca3c6b4857710d51a9399794c5958bb9c27bd54a3212179a48f7e84",
          "last_updated": 1538348584971,
          "status": "SUBMITTED|VALID"
        }
      ],
      "social_docs": [
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1538348584986,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1538348584986,
          "status": "SUBMITTED"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1538348584986,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1538348584987,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "FACEBOOK",
          "id": "8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7",
          "last_updated": 1538348584987,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "ADDRESS",
          "id": "90913d23fbdf3603e5747036e03c5998874b465aa78e7dc7dfc87a901f50891c",
          "last_updated": 1538348584987,
          "status": "SUBMITTED"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "7cb85697d26e2c1010266fd64a22afd396167ca630a4bad21a9e8fcff865bb1c",
          "last_updated": 1538348584948,
          "status": "SUBMITTED|VALID"
        }
      ]
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1538348500635,
    "extra_security": false,
    "is_business": false,
    "is_trusted": true,
    "last_updated": 1538367080540,
    "public_note": null,
    "supp_id": "my_user_id"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "MAKE-IT-GO-AWAY",
  "phone_numbers": [
    "901.111.1111",
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_hqbzjWQnuo1dMJA2a0O0Nx6Em7tIGSXk9Z8vfFyi",
  "watchlists": "PENDING"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Remove User Information

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id#

Path Params

user_id

string

required

Object ID of user

Request Body

Remove Login Object

Key

Type

Description

update.remove_login.email

string

Remove Phone Number

Key

Type

Description

update.remove_phone_number

string

Phone number or email to remove from phone_numbers

Removing Last Base Document

Any attempt to remove a user's only base document will be unsuccessful. If you wish to remove the user's base document, please add a new base document to the user's account

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "update": {
    "remove_login": {
      "email": "[email protected]"
    }
  }
}

body = {
  "update": {
    "remove_login": {
      "email": "[email protected]"
    }
  }
}

user.update_info(body)

const body = {
  "update": {
    "remove_login": {
      "email": "[email protected]"
    }
  }
};

user.updateUser(body);

body = {
  "update": {
    "remove_login": {
      "email": "[email protected]"
    }
  }
}

user.user_update(payload: body)

$removephone = (object)[
  "remove_phone_number" => "777.111.1111"
];
$updateuser = (object)[
  "update" => $removephone
];
$user->update_info($updateuser);

body := `{
  "update": {
    "remove_login": {
      "email": "[email protected]"
    }
  }
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552595038091,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"
}

Base Documents

Base Document Object

Key

Type ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌

Description

entity_scope

string

Industry in which the document owner operates. In case of an individual it can be their field of profession; in case of a corp this can be their line of business. Can be hard-coded as NOT_KNOWN.

entity_type

string

Entity type of the document owner, this can be gender in case of an individual or DBA in case of a business. Can be hard-coded as Not Known (e.g. if platform doesn't ask individual end-users to specify gender).

string

ID of the base document

id_score

string

[If Part of Your Decisioning (i.e. On Spec Sheet)] Based on documents submitted for user and can be found in the base document. If the ID score is above an agreed-upon threshold, user will be SEND-AND-RECEIVE. If the score is below a certain threshold, user will be UNVERIFIED and additional KYC will be required. More details here.

name

string

Name of the base document owner

permission_scope

string

See Base Documents Intro

physical_docs[]

array of objects

See Sub-Document Object for more information

social_docs[]

array of objects

See Sub-Document Object for more information

virtual_docs[]

array of objects

See Sub-Document Object for more information

watchlists

string

Flag to indicate if any documents triggered a MATCH in watchlists / sanctions lists checks performed by Synapse's KYC verification system. See Sanctions Tiers and Watchlists Explained for more information.

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Add Base Documents

Add another set of base documents to the user

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id######

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌

Description

name

string

[Required] Name of the document owner

alias

string

Alias of the document owner (this can be the name or in case of businesses it can be the DBA entry)

email

string

[Required] Email associated with the document

phone_number

string

[Required] Phone number associated with the document

string

[Required] IP of where the document is being submitted from

entity_scope

string

[Required] See Base Documents for more information

entity_type

string

[Required] See Base Documents for more information

day

integer

[Required] In case of a person this is day of birth. In case of business entity, this is day of organization

month

integer

[Required] In case of a person this is month of birth. In case of business entity, this is month of organization

year

integer

[Required] In case of a person this is year of birth (must be over 18 unless account is a joint account with parent/legal guardian). In case of business entity, this is year of organization

address_street

string

[Required] Street address associated with the document owner, this can be home address of a person or business address of a corp. Please include apartment suite or unit numbers

address_city

string

[Required] City associated with the document owner, this can be home address of a person or business address of a corp

address_subdivision

string

[Required] State abbreviation associated with the document owner. This value needs to be in ISO Alpha-2 (i.e. CA)

address_postal_code

string

[Required] Postal code associated with the document owner, this can be home address of a person or business address of a corp

address_code_country

string

[Required] Country associated with the document owner, this can be home address of a person or business address of a corp. This value needs to be in ISO Alpha-2 (i.e. US)

physical_docs[]

array of objects

See Physical Documents for more information

social_docs[]

array of objects

See Social Documents for more information

virtual_docs[]

array of objects

See Virtual Documents for more information

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents": [
    {
      "email": "[email protected]",
      "phone_number": "901.111.1111",
      "ip": "::1",
      "name": "New Test User",
      "alias": "Test",
      "entity_type": "M",
      "entity_scope": "Arts & Entertainment",
      "day": 2,
      "month": 5,
      "year": 1989,
      "address_street": "1 Market St.",
      "address_city": "SF",
      "address_subdivision": "CA",
      "address_postal_code": "94105",
      "address_country_code": "US",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ],
      "physical_docs": [
        {
          "document_value": "data:image/gif;base64,SUQs==",
          "document_type": "GOVT_ID"
        }
      ],
      "social_docs": [
        {
          "document_value": "https://www.facebook.com/valid",
          "document_type": "FACEBOOK"
        }
      ]
    }
  ]
}

body = {
  "documents": [
    {
      "email": "[email protected]",
      "phone_number": "901.111.1111",
      "ip": "::1",
      "name": "New Test User",
      "alias": "Test",
      "entity_type": "M",
      "entity_scope": "Arts & Entertainment",
      "day": 2,
      "month": 5,
      "year": 1989,
      "address_street": "1 Market St.",
      "address_city": "SF",
      "address_subdivision": "CA",
      "address_postal_code": "94105",
      "address_country_code": "US",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ],
      "physical_docs": [
        {
          "document_value": "data:image/gif;base64,SUQs==",
          "document_type": "GOVT_ID"
        }
      ],
      "social_docs": [
        {
          "document_value": "https://www.facebook.com/valid",
          "document_type": "FACEBOOK"
        }
      ]
    }
  ]
}

user.update_info(body)

const body = {
  "documents": [
    {
      "email": "[email protected]",
      "phone_number": "901.111.1111",
      "ip": "::1",
      "name": "New Test User",
      "alias": "Test",
      "entity_type": "M",
      "entity_scope": "Arts & Entertainment",
      "day": 2,
      "month": 5,
      "year": 1989,
      "address_street": "1 Market St.",
      "address_city": "SF",
      "address_subdivision": "CA",
      "address_postal_code": "94105",
      "address_country_code": "US",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ],
      "physical_docs": [
        {
          "document_value": "data:image/gif;base64,SUQs==",
          "document_type": "GOVT_ID"
        }
      ],
      "social_docs": [
        {
          "document_value": "https://www.facebook.com/valid",
          "document_type": "FACEBOOK"
        }
      ]
    }
  ]
};

user.updateUser(body);

body = {
  "documents": [
    {
      "email": "[email protected]",
      "phone_number": "901.111.1111",
      "ip": "::1",
      "name": "New Test User",
      "alias": "Test",
      "entity_type": "M",
      "entity_scope": "Arts & Entertainment",
      "day": 2,
      "month": 5,
      "year": 1989,
      "address_street": "1 Market St.",
      "address_city": "SF",
      "address_subdivision": "CA",
      "address_postal_code": "94105",
      "address_country_code": "US",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ],
      "physical_docs": [
        {
          "document_value": "data:image/gif;base64,SUQs==",
          "document_type": "GOVT_ID"
        }
      ],
      "social_docs": [
        {
          "document_value": "https://www.facebook.com/valid",
          "document_type": "FACEBOOK"
        }
      ]
    }
  ]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => '2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8',
      'email' => '[email protected]'
    )
  )
);

$client->update_info($body);

body := `{
  "documents": [
    {
      "email": "[email protected]",
      "phone_number": "901.111.1111",
      "ip": "::1",
      "name": "New Test User",
      "alias": "Test",
      "entity_type": "M",
      "entity_scope": "Arts & Entertainment",
      "day": 2,
      "month": 5,
      "year": 1989,
      "address_street": "1 Market St.",
      "address_city": "SF",
      "address_subdivision": "CA",
      "address_postal_code": "94105",
      "address_country_code": "US",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ],
      "physical_docs": [
        {
          "document_value": "data:image/gif;base64,SUQs==",
          "document_type": "GOVT_ID"
        }
      ],
      "social_docs": [
        {
          "document_value": "https://www.facebook.com/valid",
          "document_type": "FACEBOOK"
        }
      ]
    }
  ]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Education",
      "entity_type": "LLC",
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "id_score": null,
      "name": "Another Test Name",
      "permission_scope": "SEND|RECEIVE",
      "physical_docs": [],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552591927398,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "id": "e42ade1108e478339c31c89d27bd69b414346633ff55db9b37c3e2e3d2281af9",
          "last_updated": 1552591927398,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "ADDRESS",
          "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
          "last_updated": 1552591927398,
          "status": "SUBMITTED"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552591927398,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552591927398,
          "status": "SUBMITTED"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1552591927398,
          "status": "SUBMITTED|VALID"
        }
      ]
    },
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "name": "New Test User",
      "permission_scope": "UNVERIFIED",
      "physical_docs": [
        {
          "document_type": "GOVT_ID",
          "id": "9f28b5f32884b0413622a07edab8fc4cbb6b1d7c0463ffbb8b7b37fd4b06dbc6",
          "last_updated": 1552592280581,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552592280769,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552592281377,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "FACEBOOK",
          "id": "8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7",
          "last_updated": 1552592280670,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1552592280759,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552592281129,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "ADDRESS",
          "id": "1674a8d0b19d89a09f3138be55dd22295fc9dc91d7086ec4b9088b052e10939c",
          "last_updated": 1552592281230,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1552592280571,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552592279612,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Another Test Name"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update Base Documents

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id#

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

documents[]

array of objects

[Required] List of base documents with IDs and fields you wish to update

Base Document Object

Key

Type

Description

string

[Required] Base document ID

email

string

Email associated with the document

name

string

Name of the document owner

entity_scope

string

Industry in which the document owner operates. In case of an individual it can be their field of profession, in case of a corp this can be their line of business

entity_type

string

Entity type of the document owner, this can be gender in case of an individual or DBA in case of a business

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "email":"[email protected]",
    "name": "Another Test Name",
    "entity_scope": "Education",
    "entity_type": "LLC"
  }]
}

body = {
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "email":"[email protected]",
    "name": "Another Test Name",
    "entity_scope": "Education",
    "entity_type": "LLC"
  }]
}

user.update_info(body)

const body = {
  documents: [{
    id: 'ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc',
    email: '[email protected]',
    name: 'Another Test Name',
    entity_scope: 'Education',
    entity_type: 'LLC'
  }]
};

user.updateUser(body);

body = {
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "email":"[email protected]",
    "name": "Another Test Name",
    "entity_scope": "Education",
    "entity_type": "LLC"
  }]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => 'ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc',
      'email' => '[email protected]'
    )
  )
);

$client->update_info($body);

body := `{
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "email":"[email protected]",
    "name": "Another Test Name",
    "entity_scope": "Education",
    "entity_type": "LLC"
  }]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Education",
      "entity_type": "LLC",
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "id_score": null,
      "name": "Another Test Name",
      "permission_scope": "UNVERIFIED",
      "physical_docs": [],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552591727579,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "id": "e42ade1108e478339c31c89d27bd69b414346633ff55db9b37c3e2e3d2281af9",
          "last_updated": 1552591778333,
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "ADDRESS",
          "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
          "last_updated": 1552591727579,
          "status": "SUBMITTED"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552591727580,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552591727580,
          "status": "SUBMITTED"
        }
      ],
      "virtual_docs": [],
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552591778244,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Another Test Name"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "UNVERIFIED",
  "phone_numbers": [
    "901.111.111",
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Remove Base Document

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id##

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

documents[]

array of objects

List of base documents with IDs and fields you wish to update

Base Document Object

Key

Type

Description

string

[Required] Base document ID

permission_scope

string

Set as DELETE_DOCUMENT

Removing Last Base Document

Any attempt to remove a user's only base document will be unsuccessful. If you wish to remove the user's base document, please add a new base document to the user's account

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "permission_scope":"DELETE_DOCUMENT"
  }]
}

body = {
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "permission_scope":"DELETE_DOCUMENT"
  }]
}

user.update_info(body)

const body = {
  documents: [{
    id:'ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc',
    permission_scope: 'DELETE_DOCUMENT'
  }]
};

user.updateUser(body);

body = {
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "permission_scope":"DELETE_DOCUMENT"
  }]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => 'ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc',
      'permission_scope' => 'DELETE_DOCUMENT'
    )
  )
);

$client->update_info($body);

body := `{
  "documents":[{
    "id":"ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
    "permission_scope":"DELETE_DOCUMENT"
  }]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552595038091,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"  
}

Sub-Documents

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Add Sub-Documents

Add sub documents to a user's base document

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id#######

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

documents[]

array of objects

[Required] List of base documents with the sub-documents you would like to add

Base Document Object w/ Sub-Document Objects

Key

Table

Description

string

[Required] Base document ID

physical_docs[]

array of objects

List of physical documents you would like to add. See Sub-Documents for more information

social_docs[]

array of objects

List of social documents you would like to add. See Sub-Documents for more information

virtual_docs[]

array of objects

List of virtual documents you would like to add. See Sub-Documents for more information

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}

body = {
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}

user.update_info(body)

const body = {
  documents: [
    {
      id: "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      virtual_docs: [
        {
          document_value: "2222",
          document_type: "SSN"
        }
      ]
    }
  ]
};

user.updateUser(body);

body = {
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => '2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8',
      'email' => '[email protected]'
    )
  )
);

$client->update_info($body);

body := `{
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "document_value": "2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Education",
      "entity_type": "LLC",
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "id_score": null,
      "name": "Another Test Name",
      "permission_scope": "SEND|RECEIVE",
      "physical_docs": [],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552592285422,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "id": "e42ade1108e478339c31c89d27bd69b414346633ff55db9b37c3e2e3d2281af9",
          "last_updated": 1552592285422,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "ADDRESS",
          "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
          "last_updated": 1552592285422,
          "status": "SUBMITTED"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552592285422,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552592285422,
          "status": "SUBMITTED"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1552593584936,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552593584852,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Another Test Name"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"  
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update Sub-Documents

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id###

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

documents[]

array of objects

[Required] List of base documents with the sub-documents you would like to add

Base Document Object w/ Sub-Document Objects

Key

Type

Description

string

[Required] Base document ID

physical_docs[]

string

List of physical documents you would like to update

social_docs[]

string

List of social documents you would like to update

virtual_docs[]

string

List of virtual documents you would like to update

Sub-Document Object

Key

Type

Description

string

[Required] Sub-document ID

document_type

string

[Required] Type of sub-document

document_value

string

[Required] Updated value of sub-document

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "document_value": "111-11-2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}

body = {
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "document_value": "111-11-2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}

user.update_info(body)

const body = {
  documents: [
    {
      id: "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      virtual_docs: [
        {
          id: "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          document_value: "111-11-2222",
          document_type: "SSN"
        }
      ]
    }
  ]
};

user.updateUser(body);

body = {
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "document_value": "111-11-2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => '2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8',
      'email' => '[email protected]'
    )
  )
);

$client->update_info($body);

body := `{
  "documents": [
    {
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "virtual_docs": [
        {
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "document_value": "111-11-2222",
          "document_type": "SSN"
        }
      ]
    }
  ]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Education",
      "entity_type": "LLC",
      "id": "ab43a7aa8e7b4cc4b551f590afc43ffa6185693ed19a98ccf9ebe54c6e0b8efc",
      "id_score": null,
      "name": "Another Test Name",
      "permission_scope": "UNVERIFIED",
      "physical_docs": [],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552591780229,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "id": "e42ade1108e478339c31c89d27bd69b414346633ff55db9b37c3e2e3d2281af9",
          "last_updated": 1552591780229,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "ADDRESS",
          "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
          "last_updated": 1552591780229,
          "status": "SUBMITTED"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552591780229,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552591780229,
          "status": "SUBMITTED"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1552591926196,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552591926109,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Another Test Name"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "UNVERIFIED",
  "phone_numbers": [
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"  
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Remove Sub-Document

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id####

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

documents[]

array of objects

[Required] List of base documents with the sub-documents you would like to remove

Base Document Object w/ Sub-Document Objects

Key

Type

Description

string

[Required] Base document ID

physical_docs[]

array of objects

List of physical documents you would like to remove

social_docs[]

array of objects

List of social documents you would like to remove

virtual_docs[]

array of objects

List of virtual documents you would like to remove

Sub-Document Object

Key

Type

Description

string

[Required] Sub-document ID

document_type

string

[Required] Set as DELETE_DOCUMENT

PATCH /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents": [
    {
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "physical_docs": [
        {
          "document_type": "DELETE_DOCUMENT",
          "document_value": "data:image/gif;base64,SUQs==",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f"
        }
      ]
    }
  ]
}

body = {
  "documents": [
    {
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "physical_docs": [
        {
          "document_type": "DELETE_DOCUMENT",
          "document_value": "data:image/gif;base64,SUQs==",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f"
        }
      ]
    }
  ]
}

user.update_info(body)

const body = {
  documents: [
    {
      id: "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      physical_docs: [
        {
          document_type: "DELETE_DOCUMENT",
          document_value: "data:image/gif;base64,SUQs==",
          id: "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f"
        }
      ]
    }
  ]
};

user.updateUser(body);

body = {
  "documents": [
    {
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "physical_docs": [
        {
          "document_type": "DELETE_DOCUMENT",
          "document_value": "data:image/gif;base64,SUQs==",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f"
        }
      ]
    }
  ]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => '2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8',
      'email' => '[email protected]'
    )
  )
);

$client->update_info($body);

body := `{
  "documents": [
    {
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "physical_docs": [
        {
          "document_type": "DELETE_DOCUMENT",
          "document_value": "data:image/gif;base64,SUQs==",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f"
        }
      ]
    }
  ]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8aa9687d093e00686b7331",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "name": "New Test User",
      "permission_scope": "SEND|RECEIVE",
      "physical_docs": [],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": 1552595380063,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": 1552595380064,
          "status": "SUBMITTED"
        },
        {
          "document_type": "FACEBOOK",
          "id": "8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7",
          "last_updated": 1552595380064,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1552595380064,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "IP",
          "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
          "last_updated": 1552595380064,
          "status": "SUBMITTED|VALID"
        },
        {
          "document_type": "ADDRESS",
          "id": "1674a8d0b19d89a09f3138be55dd22295fc9dc91d7086ec4b9088b052e10939c",
          "last_updated": 1552595380064,
          "status": "SUBMITTED"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": 1552595380063,
          "status": "SUBMITTED|VALID"
        }
      ],
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1552591205225,
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": 1552595405790,
    "public_note": null,
    "supp_id": "122eddfgbeafrfvbbb"
  },
  "is_hidden": false,
  "legal_names": [
    "Another Test Name"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "[email protected]"
  ],
  "photos": [],
  "refresh_token": "refresh_dX9ZSf47vNiIyH13ajxEkTQVP68qr0KuMlRLo5Wg",
  "watchlists": "PENDING"  
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Add 2FA Device

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id#####

Path Params

user_id

string

required

Object ID of user

Request Body

Sandbox 2FA

Two-factor authentication pins will not be sent out in sandbox

Key

Type

Description

documents[ ‌]

array of objects

[Required] List of base documents objects with the social_docs and 2FA devices you wish to add to the user

Base Document Object

Key

Type

Description

string

[Required] Base document ID

social_docs[ ‌‌]

array of objects

[Required] List of social document objects you wish to add to the user

Social Document Object

Key

Type

Description

document_type

string

[Required] Set as PHONE_NUMBER_2FA or EMAIL_2FA

document_value

string

[Required] Email or Phone Number to send MFA pin

Additional Information

When a new device is registered to the user, an MFA pin will be sent to the email or phone number provided. To verify the device, the correct pin must be submitted to the API as the mfa_answer. See Verify 2FA Device for more information

PATCH /v3.1/users/5c2eaec9e4cf47006728fd29 HTTP/1.1
Host: https://uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_TEQJHb801qI0jG7UZ2fzt9SKY5u4AWswBRmlDPO3|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111"
    }]
  }]
}

body = {
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111"
    }]
  }]
}

user.user_update(body)

const body = {
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111"
    }]
  }]
}

user.updateUser(body);

body = {
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111"
    }]
  }]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => '2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8',
      "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111"
    }]
    )
  )
);

$client->update_info($body);

body = `{
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111"
    }]
  }]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c2eaec9e4cf47006728fd29",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c2eaec9e4cf47006728fd29"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
      "id_score": null,
      "name": "Test User",
      "permission_scope": "SEND|RECEIVE",
      "physical_docs": [
        {
          "document_type": "GOVT_ID",
          "id": "160f760b57c303b473fee3f701376e12c55ea843810cf34deba8eb06f7030857",
          "last_updated": 1546563275725,
          "status": "SUBMITTED|VALID"
        }
      ],
      "social_docs": [
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1546563275725,
          "status": "SUBMITTED|VALID"
        },
        {
          ...
        },
        {
          "document_type": "PHONE_NUMBER_2FA",
          "id": "6de32f3fee5263baf1558758e8afc9f44284de5d31dd4056fdd0e6bd835c5a38",
          "last_updated": 1546563606001,
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "7cb85697d26e2c1010266fd64a22afd396167ca630a4bad21a9e8fcff865bb1c",
          "last_updated": 1546563275725,
          "status": "SUBMITTED|VALID"
        }
      ],
      "watchlists": "PENDING"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1546563269349,
    "extra_security": false,
    "is_business": false,
    "is_trusted": true,
    "last_updated": 1546563605868,
    "public_note": null,
    "supp_id": "my_user_id"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "901.111.4444"
  ],
  "photos": [],
  "refresh_token": "refresh_2SAzILKq90XN0mOhVbr7vE4R5pTQWfYktdHaleUg",
  "watchlists": "PENDING"  
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Verify 2FA Device

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

documents[]

array of objects

[Required] List of base documents objects with the social_docs and 2FA devices you wish to add to the user

Base Document Object

Key

Type

Description

string

[Required] Base document ID

social_docs[]

array of objects

[Required] List of social document objects you wish to add to the user

Social Document Object

Key

Type

Description

document_type

string

[Required] Set as PHONE_NUMBER_2FA or EMAIL_2FA

document_value

string

[Required] Email or Phone Number to send MFA pin

mfa_answer

string

[Required] MFA pin sent to user's Email or Phone Number

Additional Information

The initial 2FA document status will be SUBMITTED|REVIEWING
If you View User before submitting the pin, the status will update to SUBMITTED|MFA_PENDING
When the pin is submitted successfully, the 2FA document status will update to SUBMITTED|VALID
When the pin is submitted unsuccessfully, the 2FA document status will update to SUBMITTED|INVALID

PATCH /v3.1/users/5c2eaec9e4cf47006728fd29 HTTP/1.1
Host: https://uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_TEQJHb801qI0jG7UZ2fzt9SKY5u4AWswBRmlDPO3|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111",
      "mfa_answer":"123456"
    }]
  }]
}

body = {
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111",
      "mfa_answer":"123456"
    }]
  }]
}

user.user_update(body)

user.updateUser({
  documents: [{
    id: '<BASE_DOC_ID>',
    social_docs: [{
      id: '<SUB_DOC_ID>',
      document_value: '901.111.1111',
      document_type: 'PHONE_NUMBER_2FA',
      mfa_answer: '123456'
    }]
  }]
});

body = {
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111",
      "mfa_answer":"123456"
    }]
  }]
}

user.user_update(payload: body)

$body = array (
  'documents' =>
  array (
    array (
      'id' => '2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8',
      "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111",
      "mfa_answer":"123456"
    }]
    )
  )
);

$user = $client->update_info($body);

body = `{
  "documents":[{
    "id":"26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
    "social_docs":[{
      "document_type":"PHONE_NUMBER_2FA",
      "document_value":"901.111.1111",
      "mfa_answer":"123456"
    }]
  }]
}`

data, err := user.Update(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c2eaec9e4cf47006728fd29",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c2eaec9e4cf47006728fd29"
    }
  },
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "26d63977a590d1794bc14ad7801cd733653db578f7450c7a283d42bac3179998",
      "id_score": null,
      "name": "Test User",
      "permission_scope": "SEND|RECEIVE",
      "physical_docs": [
        {
          "document_type": "GOVT_ID",
          "id": "160f760b57c303b473fee3f701376e12c55ea843810cf34deba8eb06f7030857",
          "last_updated": 1546563608496,
          "status": "SUBMITTED|VALID"
        }
      ],
      "social_docs": [
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": 1546563608496,
          "status": "SUBMITTED|VALID"
        },
        {
          ...
        },
        {
          "document_type": "PHONE_NUMBER_2FA",
          "id": "6de32f3fee5263baf1558758e8afc9f44284de5d31dd4056fdd0e6bd835c5a38",
          "last_updated": 1546563798369,
          "status": "SUBMITTED|VALID"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "7cb85697d26e2c1010266fd64a22afd396167ca630a4bad21a9e8fcff865bb1c",
          "last_updated": 1546563608496,
          "status": "SUBMITTED|VALID"
        }
      ],
      "watchlists": "NO_MATCH"
    }
  ],
  "emails": [],
  "extra": {
    "cip_tag": 1,
    "date_joined": 1546563269349,
    "extra_security": false,
    "is_business": false,
    "is_trusted": true,
    "last_updated": 1546563798273,
    "public_note": null,
    "supp_id": "my_user_id"
  },
  "is_hidden": false,
  "legal_names": [
    "Test User"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "SEND-AND-RECEIVE",
  "phone_numbers": [
    "901.111.4444"
  ],
  "photos": [],
  "refresh_token": "refresh_2SAzILKq90XN0mOhVbr7vE4R5pTQWfYktdHaleUg",
  "watchlists": "NO_MATCH"  
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Generate UBO/Reg GG

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/ubo

Path Params

user_id

string

required

Object ID of user

Request Body

Unless specified, all of the following objects and associated fields are required to generate this document

Successful Response

If the response is successful, then the UBO/Reg GG form will be automatically uploaded it as a REG__GG as a physical document to the business user.

Key

Type

Description

compliance_contact

object

Contact information

entity_info

object

Information about the business

owners

object

Owner information

primary_controlling_contact

object

Primary Controlling Contact information

signer

object

Signer information

Compliance Contact Object

Key

Type

Description

document_id

string

Document ID of business’s compliance contact

relationship_to_entity

string

Compliance contact's title at the business

Entity Info Object

Key

Type

Description

document_id

string

Document ID of business opening account

cryptocurrency

boolean

Set as false if business is not involved with cryptocurrency

gambling

boolean

Set as false if business is not involved with the internet gambling business

majority_owned_by_listed

boolean

Set as false if business is not majority owned (50% or more) by a public company

msb.federal

boolean

Set as false if business does not have Money Transmission Licenses (MTL) in any states

msb.states

array of strings

List of states that business has Money Transmission Licenses (MTL) in

public_company

boolean

Set as false if business is not a public company

registered_sec

boolean

Set as false if business is not registered with U.S. Securities and Exchange Commission (SEC)

regulated_financial

boolean

Set as false if business is not a regulated financial company

Owners Object

Key

Type

Description

document_id

string

Document ID of beneficial owner

ownership

string

Optional Percentage of owner's ownership of the business ( only required if higher than 10%)

title

string

Owner's title in relation to business

Primary Controlling Contact Object

Key

Type

Description

document_id

string

Document ID of business’s primary controlling contact. This is typically an executive officer or senior manager (ex: CEO or CFO) OR an individual who regularly performs similar functions

relationship_to_entity

string

Primary controlling contact's title at the business

Signer Object

Key

Type

Description

document_id

string

Document ID of individual completing the form

relationship_to_entity

string

Signer's title at the business

PATCH /v3.1/users/5bda4a1314c7fa00a808f6a6/ubo HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "entity_info": {
    "cryptocurrency": true,
    "msb": {
      "federal": true,
      "states": [
        "AL"
      ]
    },
    "public_company": false,
    "majority_owned_by_listed": false,
    "registered_SEC": false,
    "regulated_financial": false,
    "gambling": false,
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  },
  "signer": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
  "compliance_contact": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
  "primary_controlling_contact": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
  "owners": [
    {
      "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
      "title": "CEO",
      "ownership": 95
    }
  ]
}

body = {
  "entity_info": {
    "cryptocurrency": true,
    "msb": {
      "federal": true,
      "states": [
        "AL"
      ]
    },
    "public_company": false,
    "majority_owned_by_listed": false,
    "registered_SEC": false,
    "regulated_financial": false,
    "gambling": false,
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  },
  "signer": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
  ...
}

user.create_ubo(body)

const body = {
  "entity_info": {
    "cryptocurrency": true,
    "msb": {
      "federal": true,
      "states": [
        "AL"
      ]
    },
    "public_company": false,
    "majority_owned_by_listed": false,
    "registered_SEC": false,
    "regulated_financial": false,
    "gambling": false,
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  },
  "signer": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
   ....
}

user.generateUboForm(body);

body = {
  "entity_info": {
    "cryptocurrency": true,
    "msb": {
      "federal": true,
      "states": [
        "AL"
      ]
    },
    "public_company": false,
    "majority_owned_by_listed": false,
    "registered_SEC": false,
    "regulated_financial": false,
    "gambling": false,
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  },
  "signer": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
   ....
}

user.create_ubo(payload: body)

$entity = (object) [
   "cryptocurrency" => True,
   "gambling" => False,
   "document_id" => "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
];

$client->create_ubo($entity);

body = `{
  "entity_info": {
    "cryptocurrency": true,
    "msb": {
      "federal": true,
      "states": [
        "AL"
      ]
    },
    "public_company": false,
    "majority_owned_by_listed": false,
    "registered_SEC": false,
    "regulated_financial": false,
    "gambling": false,
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  },
  "signer": {
    "document_id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
    "relationship_to_entity": "CEO"
  },
	...
}`

data, err := user.CreateUBO(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": {
    "$oid": "5bda4a1314c7fa00a808f6a6"
  },
  "client": {
    "id": "5a4d5a7805f18c00240bb488",
    "name": "Platform Name"
  },
  "documents": [
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "M",
      "id": "dd09124227effbeae576fb18ff7859e508a89e08d6789c275ce027349d51e0c7",
      "id_score": null,
      "name": "John Smith",
      "permission_scope": "UNVERIFIED",
      "physical_docs": [
        {
          "document_type": "GOVT_ID",
          "id": "acd8420c558d8fb88062359263213784cf0bc88557895f93bf42d5897f5c4fe0",
          "last_updated": {
            "$date": 1541033002528
          },
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "social_docs": [
        {
          "document_type": "ADDRESS",
          "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
          "last_updated": {
            "$date": 1541033003566
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "EMAIL",
          "id": "ec1bd13f97d4dcfa7ae28a18150e325f867d901f89545e0c0a257a532b106a27",
          "last_updated": {
            "$date": 1541033003479
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "DATE",
          "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
          "last_updated": {
            "$date": 1541033003675
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "PHONE_NUMBER",
          "id": "b4eee6916fa7bca402af00e6b16e3c8d50737a7189dd81d4fd46ae2c2c0e1b36",
          "last_updated": {
            "$date": 1541033003533
          },
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
          "last_updated": {
            "$date": 1541033001461
          },
          "status": "SUBMITTED|REVIEWING"
        }
      ]
    },
    {
      "entity_scope": "Arts & Entertainment",
      "entity_type": "LLC",
      "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
      "name": "Fake Business",
      "permission_scope": "UNVERIFIED",
      "physical_docs": [
        {
          "document_type": "GOVT_ID",
          "id": "7840958571593e69a4727205be0e1a6d0cdb99656a8ed96e6802de46f3b740b5",
          "last_updated": {
            "$date": 1541032460556
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "EIN_DOC",
          "id": "2a8bf6873eda6dc774747ac045f92408210211e388adf23faf38e254b1fa9c8c",
          "last_updated": {
            "$date": 1541032755544
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "REG_GG",
          "id": "63f2650014448a3f81d316b21204bbe6960881be227e5760a6897542e15e4a1e",
          "last_updated": {
            "$date": 1541033341748
          },
          "status": "SUBMITTED"
        }
      ],
      "social_docs": [
        {
          "document_type": "PHONE_NUMBER",
          "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
          "last_updated": {
            "$date": 1541032756436
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "ADDRESS",
          "id": "bce9d06d8d58a609c87a9cee2153e2cc1cee79d846121cd86907ba90433634ec",
          "last_updated": {
            "$date": 1541032756524
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "EMAIL",
          "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
          "last_updated": {
            "$date": 1541032756429
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "DATE",
          "id": "b8e669e729f2dface01775c91668e35ed5b6340bcec291a6393b4ea8e6b0dfe9",
          "last_updated": {
            "$date": 1541032756584
          },
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "virtual_docs": [
        {
          "document_type": "SSN",
          "id": "7cb85697d26e2c1010266fd64a22afd396167ca630a4bad21a9e8fcff865bb1c",
          "last_updated": {
            "$date": 1541032459593
          },
          "status": "SUBMITTED|REVIEWING"
        },
        {
          "document_type": "TIN",
          "id": "a55cc12f46e8091f741b978d5fa556b2f8772a75007a82aae10a2fd810f644cb",
          "last_updated": {
            "$date": 1541032754521
          },
          "status": "SUBMITTED|REVIEWING"
        }
      ],
      "watchlists": "PENDING"
    }
  ],
  "extra": {
    "cip_tag": 1,
    "date_joined": {
      "$date": 1541032445648
    },
    "extra_security": false,
    "is_business": true,
    "is_trusted": true,
    "last_updated": {
      "$date": 1541033341412
    },
    "public_note": null,
    "supp_id": "my_user_id"
  },
  "is_hidden": false,
  "legal_names": [
    "Fake Business"
  ],
  "logins": [
    {
      "email": "[email protected]",
      "scope": "READ_AND_WRITE"
    }
  ],
  "permission": "UNVERIFIED",
  "phone_numbers": [
    "901.111.1111"
  ],
  "photos": [],
  "refresh_token": "refresh_2SAzILKq90XN0mOhVbr7vE4R5pTQWfYktdHaleUg",
  "watchlists": "PENDING"     
}

KYC Sandbox Test Values

Fingerprint Sandbox Test Values

Register New Fingerprint

posthttps://uat-api.synapsefi.com/oauth/user_id/

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

refresh_token

string

[Required] User's refresh token. See View User for more information

Unique and Static Fingerprints

You can either submit unique device fingerprints for each user or a static fingerprints maintained by your platform

Sandbox Test Values

POST /v3.1/oauth/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fcxx
Content-Type: application/json

{
  "refresh_token": "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq"
}

client.update_headers(fingerprint='e83cf6ddcf778e37bfe3d48fc78a6502062fcxx')

user.oauth()

const newFingerprint = 'myNewFingerprint123';

user.registerNewFingerprint(newFingerprint);

fp = 'e83cf6ddcf778e37bfe3d48fc78a6502062fcxx'

client.update_headers(fingerprint: fp)

user.authenticate()

$body = (object) [
   "refresh_token" => "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq"
];

$user->ouath($body);

data, err := user.RegisterFingerprint("e83cf6ddcf778e37bfe3d48fc78a6502062fcxx")

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error": {
    "en": "Fingerprint not registered. Please perform the MFA flow."
  },
  "error_code": "10",
  "http_code": "202",
  "phone_numbers": [
    "[email protected]",
    "901-111-2222"
  ],
  "success": false
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Select 2FA Device

posthttps://uat-api.synapsefi.com/oauth/user_id

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

refresh_token

string

[Required] User's refresh token

phone_number

string

[Required] 2FA device to send verification PIN

2FA PIN Expiration

2FA codes expire after 15 minutes or 900 seconds. Remember to account for this when building out your application

POST /v3.1/oauth/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fcxx
Content-Type: application/json

{
  "refresh_token": "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
  "phone_number": "[email protected]"
}

user.select_2fa_device('[email protected]')

const newFingerprint = 'myNewFingerprint123';
const device2FA = '[email protected]';

user.supplyDevice2FA(newFingerprint, device2FA);

user.select_2fa_device(device: "[email protected]")

$body = (object) [
   "refresh_token" => "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
   "phone_number":"[email protected]"
];

$oauthpayload = $user->select_2fa_device($body);

data, err := user.Select2FA("[email protected]")

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "10",
  "http_code": "202",
  "message": {
    "en": "MFA sent to [email protected]"
  },
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Verify 2FA PIN

posthttps://uat-api.synapsefi.com/oauth/user_id

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

refresh_token

string

[Required] User's refresh token

validation_pin

string

[Required] Validation PIN submitted to 2FA device

POST /v3.1/oauth/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fcxx
Content-Type: application/json

{
  "refresh_token": "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
  "validation_pin": "123456"
}

user.confirm_2fa_pin('123456')

const newFingerprint = 'myNewFingerprint123';
const validationPin = '123456';

user.verifyFingerprint2FA(newFingerprint, validationPin);

user.confirm_2fa_pin(pin: "123456")

$body = (object) [
   "refresh_token" => "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
   "pin":"123456"
];

$oauthpayload = $user->confirm_2fa_pin($body);

data, err := user.Verify2FA(“123456”)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "client_id": "589acd9ecb3cd400fa75ac06",
  "client_name": "SynapseFI",
  "expires_at": "1498297791",
  "expires_in": "7200",
  "oauth_key": "oauth_vxGS10t7OQzBoVJIM4Z0rbnjyXsc8lCigaH6ewRp",
  "refresh_expires_in": 6,
  "refresh_token": "refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq",
  "scope": [
    "USER|PATCH",
    "USER|GET",
    "NODES|POST",
    "NODES|GET",
    "NODE|GET",
    "NODE|PATCH",
    "NODE|DELETE",
    "TRANS|POST",
    "TRANS|GET",
    "TRAN|GET",
    "TRAN|PATCH",
    "TRAN|DELETE"
  ],
  "user_id": "594e0fa2838454002ea317a0"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Issue Public Key

gethttps://uat-api.synapsefi.com/v3.1/client?issue_public_key=YES&scope=scope_parameters

Query Params

issue_public_key

string

required

Set to YES

scope_parameters

string

required

Scopes that you wish to issue the public key for

Response Object

Key

Type

Description

client

object

Client details

public_key_obj.client_obj_id

string

Object ID of client

public_key_obj.expires_at

integer

Expiration date (milliseconds since Unix epoch time).

public_key_obj.expires_in

integer

How long key will be authorized (milliseconds since Unix epoch time)

public_key_obj.scope

array of strings

List of scopes accessible with key. See Issue Public Key for more information

Available Scopes

Scope

Permission

OAUTH|POST

Allowed to authenticate users

USERS|POST

Allowed to create users

USERS|GET

Allowed to get list of users

USER|GET

Allowed to get a user

USER|PATCH

Allowed to update a user

SUBSCRIPTIONS|GET

Allowed to get list of subscriptions

SUBSCRIPTIONS|POST

Allowed to create subscriptions

SUBSCRIPTION|GET

Allowed to get a subscription

SUBSCRIPTIONS|PATCH

Allowed to update a subscription

CLIENT|REPORTS

Allowed to view client reports

CLIENT|CONTROLS

Allowed to view client controls

GET /v3.1/client?issue_public_key=YES&amp;scope=OAUTH|POST,USERS|POST,USERS|GET,USER|GET,USER|PATCH,SUBSCRIPTIONS|GET,SUBSCRIPTIONS|POST,SUBSCRIPTION|GET,SUBSCRIPTION|PATCH,CLIENT|REPORTS,CLIENT|CONTROLS HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
Content-Type: application/json

scope = [
  "USERS|POST",
  "USER|PATCH",
  "NODES|POST",
  ...
]
pubkey = client.issue_public_key(scope)

client.issuePublicKey();

scope= "OAUTH|POST"

client.issue_public_key(scope: scope)

$scope = 'OAUTH|POST,USERS|POST,USERS|GET,USER|GET,USER|PATCH,SUBSCRIPTIONS|GET,SUBSCRIPTIONS|POST,SUBSCRIPTION|GET,SUBSCRIPTION|PATCH,CLIENT|REPORTS,CLIENT|CONTROLS';

$client->issue_public_key($scope);

scope := "OAUTH|POST,USERS|POST,USERS|GET,USER|GET,USER|PATCH,..."

data, err := client.GetPublicKey(scope)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "client": {
  	...
  },
  "public_key_obj": {
    "client_obj_id": "589acd9ecb3cd400fa75ac06",
    "expires_at": "1506039889",
    "expires_in": "900",
    "public_key": "public_key_SxfMV0uJ2qEXc5gjiCt4ebKnYIwDA3mURv7OrsTW",
    "scope": [
      "OAUTH|POST",
      "USERS|POST",
      "USERS|GET",
      "USER|GET",
      "USER|PATCH",
      "SUBSCRIPTIONS|GET",
      "SUBSCRIPTIONS|POST",
      "SUBSCRIPTION|GET",
      "SUBSCRIPTION|PATCH",
      "CLIENT|REPORTS",
      "CLIENT|CONTROLS"
    ]
  }
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Issue OAuth Key

To perform an action for a user, you need to supply a valid OAuth Key in the header field of the API request

posthttps://uat-api.synapsefi.com/v3.1/oauth/user_ID

Path Params

user_ID

string

required

Object ID of user

Request Body

Key

Type

Description

refresh_token

string

[Required] User-specific refresh token for oauth (expires after 10 uses)

scope

array of strings

Defines the level of access a user's oauth_token provides. By default, the oauth_token provides access to all available scopes. To limit this, set scope in the request body.

OAuth Expiration

OAuth keys expire every two hours. Remember to account for this when building out your application

Available Scopes

Scope

Comment

USER|PATCH

OAuth can be used to update User document

USER|GET

OAuth can be used to get User

NODES|POST

OAuth can be used to add Nodes

NODES|GET

OAuth can be used to get Nodes

NODE|GET

OAuth can be used to get Node

NODE|PATCH

OAuth can be used to update Node

NODE|DELETE

OAuth can be used to delete Node

TRANS|POST

OAuth can be used to add Transaction

TRANS|GET

OAuth can be used to get Transaction

TRAN|GET

OAuth can be used to get Transaction

TRAN|PATCH

OAuth can be used to update Transaction

TRAN|DELETE

OAuth can be used to cancel Transaction

SUBNETS|POST

OAuth can be used to create Subnets

SUBNETS|GET

OAuth can be used to get Subnets

SUBNET|GET

OAuth can be used to get a Subnet

SUBNET|PATCH

OAuth can be used to update a Subnet

STATEMENTS|GET

OAuth can be used to get Statements

STATEMENT|GET

OAuth can be used to get a Statement

HTTP

POST /v3.1/oauth/594e0fa2838454002ea317a0 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "refresh_token": "refresh_mjNgn2w50pv03kxB6o1bHqOZVfJzYuTKW7PiChDe",
  "scope": [
    "USER|PATCH",
    "USER|GET",
    "NODES|POST",
    "NODES|GET",
    "NODE|GET",
    "NODE|PATCH",
    "NODE|DELETE",
    "TRANS|POST",
    "TRANS|GET",
    "TRAN|GET",
    "TRAN|PATCH",
    "TRAN|DELETE",
    "SUBNETS|GET",
    "SUBNETS|POST",
    "SUBNET|GET",
    "SUBNET|PATCH",
    "STATEMENTS|GET",
    "STATEMENT|GET"
  ]
}

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "client_id": "5beb506f6d7ceb002490631f",
  "client_name": "Synapse Financial Tech",
  "expires_at": "1552594769",
  "expires_in": "7200",
  "oauth_key": "oauth_wAjQXY408UEN6Mv7SJsHZaKLzbBFirTloDp0uW53",
  "refresh_expires_in": 10,
  "refresh_token": "refresh_mjNgn2w50pv03kxB6o1bHqOZVfJzYuTKW7PiChDe",
  "scope": [
    "USER|PATCH",
    "USER|GET",
    "NODES|POST",
    "NODES|GET",
    "NODE|GET",
    "NODE|PATCH",
    "NODE|DELETE",
    "TRANS|POST",
    "TRANS|GET",
    "TRAN|GET",
    "TRAN|PATCH",
    "TRAN|DELETE",
    "SUBNETS|GET",
    "SUBNETS|POST",
    "SUBNET|GET",
    "SUBNET|PATCH",
    "STATEMENTS|GET",
    "STATEMENT|GET"
  ],
  "user_id": "594e0fa2838454002ea317a0"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View All Platform Nodes

Get a list of all platform nodes including nodes made by users

gethttps://uat-api.synapsefi.com/v3.1/nodes

Query Params

filter

string

{"supp_id": "supp_1234"}

page

int32

Page number

per_page

int32

Number of nodes returned per page

type

string

Node type to search for

Nodes Object

Key

Type

Description

error_code

string

See Common Errors for more information

http_code

string

See Common Errors for more information

limit

integer

Number of nodes per page

node_count

integer

Total number of nodes

nodes[]

array of objects

List of node objects. See View User Node for more information

page

integer

Page number

page_count

integer

Number of pages

success

boolean

Request success

GET /v3.1/nodes HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_25BpgCAt3ymEJdkF8iwrKVlOqLZ071IehGTUaz6n|client_secret_bomP73QBiEHwJvO6tMCGXy8NUlgLj14xakzf50RK
Content-Type: application/json

client.get_all_nodes()

client.getPlatformNodes();

client.get_all_nodes()

$client->get_all_platform_nodes()

data, err := client.GetNodes()

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 2,
  "node_count": 4362,
  "nodes": [
    {
      "_id": "5c898e67d23e5f45c2c36a8b",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5c898e427d093e0066629c02/nodes/5c898e67d23e5f45c2c36a8b"
        }
      },
      "allowed": "CREDIT-AND-DEBIT",
      "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFI"
      },
      "extra": {
        "note": null,
        "other": {
          "access_token": "5c898e656c4a18003995e751",
          "updated_on": 1552533158000
        },
        "supp_id": ""
      },
      "info": {
        "account_num": "8902",
        "address": "PO BOX 85139, RICHMOND, VA, US",
        "balance": {
          "amount": "750.00",
          "currency": "USD",
          "updated_on": 1552533158000
        },
        "bank_logo": "https://cdn.synapsepay.com/bank_logos/new/co.png",
        "bank_long_name": "CAPITAL ONE N.A.",
        "bank_name": "CAPITAL ONE N.A.",
        "class": "SAVINGS",
        "match_info": {
          "email_match": "no_match",
          "name_match": "no_match",
          "phonenumber_match": "no_match"
        },
        "name_on_account": " ",
        "nickname": "SynapsePay Test Savings Account - 8902",
        "routing_num": "6110",
        "type": "BUSINESS"
      },
      "is_active": true,
      "timeline": [
        {
          "date": 1552518759241,
          "note": "Node created."
        },
        {
          "date": 1552518759715,
          "note": "Unable to send micro deposits as node allowed is not CREDIT."
        }
      ],
      "type": "ACH-US",
      "user_id": "5c898e427d093e0066629c02"
    },
    {
      "_id": "5c898e67d23e5f45bfc3372a",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5c898e427d093e0066629c02/nodes/5c898e67d23e5f45bfc3372a"
        }
      },
      "allowed": "CREDIT-AND-DEBIT",
      "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFI"
      },
      "extra": {
        "note": null,
        "other": {
          "access_token": "5c898e656c4a18003995e751",
          "updated_on": 1552533158000
        },
        "supp_id": ""
      },
      "info": {
        "account_num": "8901",
        "address": "PO BOX 85139, RICHMOND, VA, US",
        "balance": {
          "amount": "800.00",
          "currency": "USD",
          "updated_on": 1552533158000
        },
        "bank_logo": "https://cdn.synapsepay.com/bank_logos/new/co.png",
        "bank_long_name": "CAPITAL ONE N.A.",
        "bank_name": "CAPITAL ONE N.A.",
        "class": "CHECKING",
        "match_info": {
          "email_match": "no_match",
          "name_match": "no_match",
          "phonenumber_match": "no_match"
        },
        "name_on_account": " ",
        "nickname": "SynapsePay Test Checking Account - 8901",
        "routing_num": "6110",
        "type": "PERSONAL"
      },
      "is_active": true,
      "timeline": [
        {
          "date": 1552518758734,
          "note": "Node created."
        },
        {
          "date": 1552518759260,
          "note": "Unable to send micro deposits as node allowed is not CREDIT."
        }
      ],
      "type": "ACH-US",
      "user_id": "5c898e427d093e0066629c02"
    }
  ],
  "page": 1,
  "page_count": 2181,
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View All User Nodes

Get a list of all user nodes by user ID

gethttps://uat-api.synapsefi.com/v3.1/user_id/nodes

Path Params

user_id

string

required

Object ID of user

Query Params

filter

string

{"supp_id": "supp_1234"}

page

int32

Page number

per_page

int32

Number of nodes per page

type

string

Node type to search for

Nodes Object

Key

Type

Description

error_code

string

See Common Errors for more information

http_code

string

See Common Errors for more information

limit

integer

Number of nodes per page

node_count

integer

Total number of nodes

nodes[]

array of objects

List of node objects. See View User Node for more information

page

integer

Page number

page_count

integer

Number of pages

success

boolean

Request success

GET /v3.1/users/594e0fa2838454002ea317a0/nodes HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_auVIbQ8WXC0pnLU9ivEs4tcHDejqFJlwoNrZ3fO1|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

user.get_all_nodes(page=4, per_page=10, type='DEPOSIT-US')

user.getAllUserNodes();

user.get_all_nodes()

$page = 1;
$per_page = 1;
$type = 'DEPOSIT-US';

$user->get_all_nodes($page , $per_page , $type);

data, err := user.GetNodes()

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "node_count": 2,
  "nodes": [
    {
      "_id": "5c8abccb4b7ba9102c674cdf",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331/nodes/5c8abccb4b7ba9102c674cdf"
        }
      },
      "allowed": "CREDIT-AND-DEBIT",
      "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFI"
      },
      "extra": {
        "note": null,
        "other": {
          "access_token": "5c8abcc99c4c720039579019",
          "updated_on": 1552610570000
        },
        "supp_id": ""
      },
      "info": {
        "account_num": "8902",
        "address": "PO BOX 85139, RICHMOND, VA, US",
        "balance": {
          "amount": "750.00",
          "currency": "USD",
          "updated_on": 1552610570000
        },
        "bank_logo": "https://cdn.synapsepay.com/bank_logos/new/co.png",
        "bank_long_name": "CAPITAL ONE N.A.",
        "bank_name": "CAPITAL ONE N.A.",
        "class": "SAVINGS",
        "match_info": {
          "email_match": "match",
          "name_match": "match",
          "phonenumber_match": "no_match"
        },
        "name_on_account": " ",
        "nickname": "SynapsePay Test Savings Account - 8902",
        "routing_num": "6110",
        "type": "PERSONAL"
      },
      "is_active": true,
      "timeline": [
        {
          "date": 1552596171282,
          "note": "Node created."
        },
        {
          "date": 1552596171764,
          "note": "Unable to send micro deposits as node allowed is not CREDIT."
        }
      ],
      "type": "ACH-US",
      "user_id": "5c8aa9687d093e00686b7331"
    },
    {
      "_id": "5c8abccb4b7ba9102a61010d",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331/nodes/5c8abccb4b7ba9102a61010d"
        }
      },
      "allowed": "CREDIT-AND-DEBIT",
      "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFI"
      },
      "extra": {
        "note": null,
        "other": {
          "access_token": "5c8abcc99c4c720039579019",
          "updated_on": 1552610570000
        },
        "supp_id": ""
      },
      "info": {
        "account_num": "8901",
        "address": "PO BOX 85139, RICHMOND, VA, US",
        "balance": {
          "amount": "800.00",
          "currency": "USD",
          "updated_on": 1552610570000
        },
        "bank_logo": "https://cdn.synapsepay.com/bank_logos/new/co.png",
        "bank_long_name": "CAPITAL ONE N.A.",
        "bank_name": "CAPITAL ONE N.A.",
        "class": "CHECKING",
        "match_info": {
          "email_match": "match",
          "name_match": "match",
          "phonenumber_match": "no_match"
        },
        "name_on_account": " ",
        "nickname": "SynapsePay Test Checking Account - 8901",
        "routing_num": "6110",
        "type": "BUSINESS"
      },
      "is_active": true,
      "timeline": [
        {
          "date": 1552596170782,
          "note": "Node created."
        },
        {
          "date": 1552596171279,
          "note": "Unable to send micro deposits as node allowed is not CREDIT."
        }
      ],
      "type": "ACH-US",
      "user_id": "5c8aa9687d093e00686b7331"
    }
  ],
  "page": 1,
  "page_count": 1,
  "success": true
}

Link w/ Bank Login or Link w/ Account/Routing

View User Node

Get a user node by user ID and node ID

gethttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

Query Params

force_refresh

string

[yes/no] Force a system check to retrieve most up-to-date balance information

full_dehydrate

string

[yes/no] return all available node information including decrypted account/routing number, transaction history, etc.

Node Object

Please note, loan nodes follow a different object structure. For more information please see View Loan Details.

Key

Type

Description

_id

string

Object ID of the node

_links.self.href

string

HAL-style link for the node

allowed

string

Denotes available actions for the node. See Node Permissions for more information

client.id

string

ID of the client associated with the node

client.name

string

Name of the client associated with the node

extra.note

string

Account notes

extra.other.updated_on

integer

Date of last update to node (milliseconds since Unix epoch time).

extra.supp_id

string

Supplementary ID provided on node creation

info.balance.amount

float

Current balance associated with the account

info.balance.currency

string

Currency of the node

info.balance.updated_on

integer

Date of last update to node balance (milliseconds since Unix epoch time).

info.document_id

string

Base document ID of user associated with the node

info.monthly_withdrawals_remaining

integer

Remaining withdrawals left for the month

info.name_on_account

string

Name of user associated with the account

info.nickname

string

Nickname of node

info.type

string

Type of account BUSINESS or PERSONAL

is_active

boolean

Denotes active status of node

timeline

array of objects

List of updates to the node. See Timeline Object for more information

type

string

Type of node. See Node Types for more information

user_id

string

User ID associate with node

Timeline Object

Key

Type

Description

date

integer

Date of update to node (milliseconds since Unix epoch time).

note

string

Note about the node update

Force Refresh

If force refresh is successful, the info.balance.updated_on timestamp will update to the most recent date and time of update

Type

Product

ACH-US

CARD-US

[Deprecated] Refer to CARD-US pages from v3.1 Docs site for more details.

CHECK-US

Create Check Recipient

CLEARING-US

Create Clearing Account

CRYPTO-US

Create Crypto Wallet

CUSTODY-US

Create Custody Account

DEPOSIT-US

Create Deposit Account

IB-DEPOSIT-US

IB-SUBACCOUNT-US

INTERCHANGE-US

IOU

LOAN-US

Apply for a One-Time Loan or Apply for a Revolving Credit Loan

RESERVE-US

Reserve Accounts.

SUBCARD-US

[Deprecated]

SYNAPSE-US

[Deprecated]

TRIUMPH-SUBACCOUNT-US

[Deprecated]

WIRE-US

Link Wire Account (Domestic)

WIRE-INT

Link Wire Account (International)

Node Permissions

See below for all available node permissions

GET /v3.1/users/5bc305abd83c197a45848f88/nodes/5bd18a08f9bd8600bea124be HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_cJokUnXuK428GhZESHPMfltOQ0Crv1eF93yBxDa0|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

node_id = '594e606212e17a002f2e3251'

node = user.get_node(node_id, full_dehydrate=True, force_refresh=True)

const nodeID = '594e606212e17a002f2e3251';

user.getNode(nodeID);

node_id = “5bd18a08f9bd8600bea124be”

user.get_user_node(node_id: node_id)

$nodeid = '5c3d416f7b08ab0066ee8cae';
$full_dehydrate=null;
$force_refresh = null;
$user->get_node($nodeid, $full_dehydrate, $force_refresh);

nodeID = '594e606212e17a002f2e3251'

data, err := user.GetNode(nodeID)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bd18a08f9bd8600bea124be",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bc305abd83c197a45848f88/nodes/5bd18a08f9bd8600bea124be"
    }
  },
  "allowed": "CREDIT-AND-DEBIT",
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "extra": {
    "note": null,
    "other": {},
    "supp_id": ""
  },
  "info": {
    "balance": {
      "amount": 0,
      "currency": "USD"
    },
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
    "monthly_withdrawals_remaining": null,
    "name_on_account": " ",
    "nickname": "My Deposit Account"
  },
  "is_active": true,
  "timeline": [
    {
      "date": 1540459015761,
      "note": "Node created."
    }
  ],
  "type": "DEPOSIT-US",
  "user_id": "5bc305abd83c197a45848f88"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Create Node

Node creation template

posthttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/

Path Params

user_id

string

required

Object ID of user

Request Body

Key

Type

Description

type

string

[Required] Type of node. See Node Types for more information

info.document_id

string

[Required] Base document ID of the user. See Base Documents for more information

info.nickname

string

Nickname to assign to the node

extra.supp_id

string

[Max Characters: 250] Additional ID to assign to the node

POST /v3.1/users/5ba52ec00abfb200a8a93e90/nodes HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_wBvo8QzEDZVkTWtG2yX6rn0dgRfJN1P0UjILxq4K|123456789
Content-Type: application/json

{
  "type": "DEPOSIT-US",
  "info": {
    "nickname": "My Deposit Account",
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  }
}

body = {
  "type": "DEPOSIT-US",
  "info": {
    "nickname": "My Deposit Account",
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  }
}

user.create_node(body, idempotency_key='123456')

const body = {
  "type": "DEPOSIT-US",
  "info": {
    "nickname": "My Deposit Account",
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  }
};

user.createNode(body);

body = {
  "type": "DEPOSIT-US",
  "info": {
    "nickname": "My Deposit Account",
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  }
}

user.create_node(payload: body)

$info= (object) [
   "nickname" => "My Deposit Account",
   "document_id" => "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
];
$body = (object) [
   'type' => 'DEPOSIT-US',
   'info' => $info
];

$user->create_node($body);

body := `{
  "type": "DEPOSIT-US",
  "info": {
    "nickname": "My Deposit Account",
    "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8"
  }
}`

data, err := user.CreateNode(body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "node_count": 1,
  "nodes": [
    {
      "_id": "5ba98a1c4d1d6200a4736e25",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5ba52ec00abfb200a8a93e90/nodes/5ba98a1c4d1d6200a4736e25"
        }
      },
      "allowed": "CREDIT-AND-DEBIT",
      "client": {
        "id": "5ade26b4567a900029e2afd2",
        "name": "YY Test Account"
      },
      "extra": {
        "note": null,
        "other": {},
        "supp_id": ""
      },
      "info": {
        "balance": {
          "amount": 0,
          "currency": "USD"
        },
        "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
        "monthly_withdrawals_remaining": null,
        "name_on_account": " ",
        "nickname": "My Deposit Account"
      },
      "is_active": true,
      "timeline": [
        {
          "date": 1537837596112,
          "note": "Node created."
        }
      ],
      "type": "DEPOSIT-US",
      "user_id": "5ba52ec00abfb200a8a93e90"
    }
  ],
  "page_count": 1,
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update Node

Update node values

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id

Path Params

user_id

string

required

Object ID of user

Request Body

Set Nickname

Key

Type

Description

nickname

string

Nickname to assign to the node

Set Supplementary ID

Key

Type

Description

supp_id

string

[Max Characters: 250] Additional ID to assign to the node

Set Allowed Status

Key

Type

Description

allowed

string

Denotes available actions for the node. See permission table below for more information

Node Statuses
For full list of node statuses, go here.

POST /v3.1/users/5ba52ec00abfb200a8a93e90/nodes/5c8abccb4b7ba9102a61010d HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_wBvo8QzEDZVkTWtG2yX6rn0dgRfJN1P0UjILxq4K|123456789
Content-Type: application/json

{
  "supp_id":"new_supp_id_1234"
}

node_id = '5ba05ed620b3aa005882c52a'
body = {
    "supp_id":"new_supp_id_1234"
}
nodes = user.update_node(node_id, body)

user.updateNode('<NODE_ID>', {
  allowed: 'INACTIVE'
})
.then(({ data }) => {
  console.log('data ', data);
});

node_id = '5ba05ed620b3aa005882c52a'
body = {
  "supp_id":"new_supp_id_1234"
}
node = user.generate(node_id:node_id, payload:body)

$user = $client->get_user('your_user_id');

$nodeid = 'your_node_id';
$body = (object)[
   "supp_id" => "new_supp_id_1234"
];
$updatednode = $user->update_node($nodeid, $body);

nodeID := "5ba05ed620b3aa005882c52a"
body := `{
  "supp_id":"new_supp_id_1234"
}`

data, err := user.UpdateNode(nodeID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "node_count": 1,
  "nodes": [
    {
      "_id": "5ba98a1c4d1d6200a4736e25",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5ba52ec00abfb200a8a93e90/nodes/5ba98a1c4d1d6200a4736e25"
        }
      },
      "allowed": "CREDIT-AND-DEBIT",
      "client": {
        "id": "5ade26b4567a900029e2afd2",
        "name": "YY Test Account"
      },
      "extra": {
        "note": null,
        "other": {},
        "supp_id": "new_supp_id_1234"
      },
      "info": {
        "balance": {
          "amount": 0,
          "currency": "USD"
        },
        "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
        "monthly_withdrawals_remaining": null,
        "name_on_account": " ",
        "nickname": "My Deposit Account"
      },
      "is_active": true,
      "timeline": [
        {
          "date": 1537837596112,
          "note": "Node created."
        },
        {
          "date": 1556216986997,
          "note": "Node's 'supp_id' updated to new_supp_id_1234."
        }
      ],
      "type": "DEPOSIT-US",
      "user_id": "5ba52ec00abfb200a8a93e90"
    }
  ],
  "page_count": 1,
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Delete Node

deletehttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

Additional Information

Remaining Balance

Before deleting a node, please make sure that any remaining funds have been transferred out

DELETE /v3.1/users/5c8aa9687d093e00686b7331/nodes/5c8abccb4b7ba9102a61010d HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_kjqbGWY0wV53hN91ZgziaRP6lMop0cv4smdCxfF7|e88f41462eca394f6691da155d0cb73d
Content-Type: application/json

node_id = '5c8abccb4b7ba9102a61010d'
user.delete_node(node_id)

const nodeID = '5c8abccb4b7ba9102a61010d';
user.deleteNode(nodeID);

node_id = '5c8abccb4b7ba9102a61010d'
user.delete_node(node_id: node_id)

$nodeid = '5c8abccb4b7ba9102a61010d';
$user->delete_node($nodeid);

nodeID := "5c8abccb4b7ba9102a61010d"
data, err := user.DeleteNode(nodeID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5c8abccb4b7ba9102a61010d",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c8aa9687d093e00686b7331/nodes/5c8abccb4b7ba9102a61010d"
    }
  },
  "allowed": "CREDIT-AND-DEBIT",
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "extra": {
    "note": null,
    "other": {
      "access_token": "5c8abcc99c4c720039579019",
      "updated_on": 1552610570000
    },
    "supp_id": ""
  },
  "info": {
    "account_num": "8901",
    "address": "PO BOX 85139, RICHMOND, VA, US",
    "balance": {
      "amount": "800.00",
      "currency": "USD",
      "updated_on": 1552610570000
    },
    "bank_logo": "https://cdn.synapsepay.com/bank_logos/new/co.png",
    "bank_long_name": "CAPITAL ONE N.A.",
    "bank_name": "CAPITAL ONE N.A.",
    "class": "CHECKING",
    "match_info": {
      "email_match": "match",
      "name_match": "match",
      "phonenumber_match": "no_match"
    },
    "name_on_account": " ",
    "nickname": "SynapsePay Test Checking Account - 8901",
    "routing_num": "6110",
    "type": "BUSINESS"
  },
  "is_active": false,
  "timeline": [
    {
      "date": 1552596170782,
      "note": "Node created."
    },
    {
      "date": 1552596171279,
      "note": "Unable to send micro deposits as node allowed is not CREDIT."
    },
    {
      "date": 1552597281077,
      "note": "Node's 'is_active' toggled to False."
    }
  ],
  "type": "ACH-US",
  "user_id": "5c8aa9687d093e00686b7331"
}

More on Nodes

List of all available node types

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View User Subnets

View all Account/Routing Number and Debit Card Accounts for a user

gethttps://uat-api.synapsefi.com/v3.1/users/user_id/subnets

Path Params

user_id

string

required

Object ID of user

Query Params

page

int32

Page number

per_page

int32

Number of subnets per page

Subnets Object

Key

Type

Description

error_code

string

See Common Errors for more information

http_code

string

See Common Errors for more information

limit

integer

Number of subnets per page

page

integer

Page number

page_count

integer

Number of pages

subnet_count

integer

Total number of subnets

subnets[]

array of objects

List of subnet objects. See View AC/RT Account or View Debit Card Account for more information

success

boolean

Request success

POST /v3.1/users/59c9f69a89ec34002e1b4b2e/subnets HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

node_id = "59c9b3b96d7d8a002f717c3c"

user.get_all_subnets(node_id)

const nodeID = '59c9b3b96d7d8a002f717c3c';

user.getAllSubnets(nodeID);

node_id= "59c9b3b96d7d8a002f717c3c"

user.get_all_subnets(node_id: node_id)

$nodeid = '59c9b3b96d7d8a002f717c3c';

$user->get_subnets($nodeid);

nodeID := "59c9b3b96d7d8a002f717c3c"

data, err := user.GetNodeSubnets(nodeID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "page": 1,
  "page_count": 1,
  "subnets": [
    {
      "_id": "5cb7cf26b34a6d004345ef3d",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5c64996c7f9c202542e96e09/nodes/5cb7aae388a3e200d87dde81/subnets/5cb7cf26b34a6d004345ef3d"
        }
      },
      "account_class": "CHECKING",
      "account_num": "9891213684",
      "client": {
        "id": "5beb506f6d7ceb002490631f",
        "name": "SynapseFI"
      },
      "created_on": 1555549989904,
      "nickname": "SynapseFI AC/RT",
      "node_id": "5cb7aae388a3e200d87dde81",
      "routing_num": {
        "ach": "084106768",
        "wire": "084106768"
      },
      "status": "INACTIVE",
      "supp_id": null,
      "user_id": "5c64996c7f9c202542e96e09"
    },
    {
      ...
    },
    {
      "_id": "5c77373831551b45f4bba72d",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/5c64996c7f9c202542e96e09/nodes/5c649a1009309d3ec967a657/subnets/5c77373831551b45f4bba72d"
        }
      },
      "account_class": "CHECKING",
      "account_num": "9893500777",
      "client": {
        "id": "5beb506f6d7ceb002490631f",
        "name": "SynapseFI"
      },
      "nickname": "Test",
      "node_id": "5c649a1009309d3ec967a657",
      "routing_num": {
        "ach": "084106768",
        "wire": "084106768"
      },
      "status": "INACTIVE",
      "supp_id": null,
      "user_id": "5c64996c7f9c202542e96e09"
    }
  ],
  "subnets_count": 13,
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View Node Subnets

View all Account/Routing Number and Debit Card Accounts for a node

gethttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

Query Params

page

int32

Page number

per_page

int32

Number of subnets per page

Subnets Object

Key

Type

Description

error_code

string

See Common Errors for more information

http_code

string

See Common Errors for more information

limit

integer

Number of subnets per page

page

integer

Page number

page_count

integer

Number of pages

subnet_count

integer

Total number of subnets

subnets[]

array of objects

List of subnet objects. See View AC/RT Account or View Debit Card Account for more information

success

boolean

Request success

POST /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

node_id = "59c9b3b96d7d8a002f717c3c"

user.get_all_subnets(node_id)

const nodeID = '59c9b3b96d7d8a002f717c3c';

user.getAllSubnets(nodeID);

node_id= "59c9b3b96d7d8a002f717c3c"

user.get_all_subnets(node_id: node_id)

$nodeid = '59c9b3b96d7d8a002f717c3c';

$user->get_subnets($nodeid);

nodeID := "59c9b3b96d7d8a002f717c3c"

data, err := user.GetNodeSubnets(nodeID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "page": 1,
  "page_count": 1,
  "subnets": [
    {
      "_id": "59c9b3c3a82e520029a105a0",
      "_links": {
        "self": {
          "href": "https://uat-api.synapsefi.com/v3.1/users/59c9b3ae89ec34002e1b3c3f/nodes/59c9b3b96d7d8a002f717c3c/subnets/59c9b3c3a82e520029a105a0"
        }
      },
      "account_class": "CHECKING",
      "account_num": "902387862804533",
      "allowed": "CREDIT",
      "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFI"
      },
      "created_on": 1555549989904,
      "nickname": "Test AC/RT",
      "node_id": "59c9b3b96d7d8a002f717c3c",
      "routing_num": {
        "ach": "084106768",
        "wire": "084106768"
      },
      "status": "ACTIVE",
      "supp_id": null,
      "user_id": "59c9b3ae89ec34002e1b3c3f"
    },
    {
      ...
    }
  ],
  "subnets_count": 2,
  "success": true
}

Subnet Statuses

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View AC/RT Account

AC/RT accounts are subnets built on nodes

gethttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Subnet Object

Key

Type

Description

_id

string

Object ID of subnet

_links.self.href

string

HAL-style link for the subnet object

account_class

string

Account class of subnet

account_num

string

Account number associated with subnet

client.id

string

ID of the client associated with the subnet

client.name

string

Name of the client associated with the subnet

created_on

integer

Date of subnet creation (milliseconds since Unix epoch time).

nickname

string

Nickname given to the AC/RT account

node_id

string

Node ID associated with the subnet. Funds will be credited to this node when credits arrive

routing_num.ach

string

Routing number for ACH transfers

routing_num.wire

string

Routing number fo wire transfers

status

string

Subnet status. See Update AC/RT Account for more information

supp_id

string

Additional ID supplied to subnet

user_id

string

User ID associate with the subnet

GET/v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

node_id= "59c9f6a66d7d8a002f71b191"
subnet_id= "59c9f77cd412960028b99d2b"

user.get_subnet(node_id, subnet_id)

const nodeID = '59c9f6a66d7d8a002f71b191';
const subnetID = '59c9f77cd412960028b99d2b';

user.getSubnet(nodeID, subnetID);

node_id= "59c9f6a66d7d8a002f71b191"
subnet_id= "59c9f77cd412960028b99d2b"

user.get_subnet(node_id: node_id, subnet_id: subnet_id)

$nodeid = '59c9f6a66d7d8a002f71b191';
$subnetid = '59c9f77cd412960028b99d2b';

$user->get_subnet($nodeid, $subnetid);

nodeID := "594e606212e17a002f2e3251"
subnetID := "59c9f77cd412960028b99d2b"

data, err := user.GetSubnet(nodeID, subnetID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5cb7cf26b34a6d004345ef3d",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c64996c7f9c202542e96e09/nodes/5cb7aae388a3e200d87dde81/subnets/5cb7cf26b34a6d004345ef3d"
    }
  },
  "account_class": "CHECKING",
  "account_num": "9891213684",
  "client": {
    "id": "5beb506f6d7ceb002490631f",
    "name": "SynapseFI"
  },
  "created_on": 1555549989904,
  "nickname": "My AC/RT",
  "node_id": "5cb7aae388a3e200d87dde81",
  "routing_num": {
    "ach": "084106768",
    "wire": "084106768"
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5c64996c7f9c202542e96e09"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Issue AC/RT Numbers

Create SUBNET

posthttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

Request Body

Key

Type

Description

nickname

string

[Required] Nickname to assign to the node

supp_id

string

Additional ID to supply for the subnet

Sandbox Test Values

Any valid Routing Number and 5-digit Account Number will work in Sandbox (e.g. 322271627 - Chase California Routing Number)

POST /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "nickname":"Test AC/RT"
}

node_id = "59c9f6a66d7d8a002f71b191"
body = {
  "nickname":"Test AC/RT"
}

user.create_subnet(node_id, body)

const nodeID = '59c9f6a66d7d8a002f71b191';
const body = {
  "nickname": "Test AC/RT"
};

user.createSubnet(nodeID, body);

node_id = "59c9f6a66d7d8a002f71b191"
body = {
  "nickname":"Test AC/RT"
}

user.create_subnet(node_id: node_id, payload: body)

$nodeid = '59c9f6a66d7d8a002f71b191';
$body = (object)[
   "nickname" => "Test AC/RT"
];
$user->create_subnet($nodeid, $body);

nodeID := "59c9f6a66d7d8a002f71b191"
body := `{
  "nickname":"Test AC/RT"
}`

data, err := user.CreateSubnet(nodeID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "59c9f77cd412960028b99d2b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b"
    }
  },
  "account_class": "CHECKING",
  "account_num": "692069247603874",
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "created_on": 1555549989904,
  "nickname": "Test AC/RT",
  "node_id": "59c9f6a66d7d8a002f71b191",
  "routing_num": {
    "ach": "084106768",
    "wire": "084106768"
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "59c9f69a89ec34002e1b4b2e"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update AC/RT Subnet Status

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

status

string

Subnet status

supp_id

string

Additional ID supplied to subnet

PATCH /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "status":"INACTIVE"
}

node_id = '594e606212e17a002f2e3251'
subn_id = '59c9f77cd412960028b99d2b'
body = {
  "status":"INACTIVE"
}

user.update_subnet(node_id, subn_id, body)

nodeID = "594e606212e17a002f2e3251";
subnetID = "59c9f77cd412960028b99d2b";
const body = {
  "status":"INACTIVE"
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "status":"INACTIVE"
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body= (object) [
  "status":"INACTIVE"
];

$node_id = '594e606212e17a002f2e3251';
$subnet_id = '59c9f77cd412960028b99d2b';
$user->update_subnet( $node_id, $subnet_id ,$body);

nodeID := "59c9f6a66d7d8a002f71b191"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "status":"INACTIVE"
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "59c9f77cd412960028b99d2b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b"
    }
  },
  "account_class": "CHECKING",
  "account_num": "692069247603874",
  "client": {
    "id": "589acd9ecb3cd400fa75ac06",
    "name": "SynapseFI"
  },
  "created_on": 1555549989904,
  "nickname": "Test AC/RT",
  "node_id": "59c9f6a66d7d8a002f71b191",
  "routing_num": {
    "ach": "084106768",
    "wire": "084106768"
  },
  "status": "INACTIVE",
  "user_id": "59c9f69a89ec34002e1b4b2e"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View Debit Card Account

View a SUBNET

gethttps://uat-api.synapsefi.com/v3.1/users/user_id/nodesnode_id/subnets/subnet_id

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Query Params

full_dehydrate

string

[yes/no] Full Dehydrate yes will return back all the card info including the card number, and cvc.

Subnet Object

Key

Type

Description

_id

string

Object ID of subnet

_links.self.href

string

HAL-style link for the subnet object

access_token

string

Access token of subnet

account_class

string

Account class of subnet

account_num

string

Account number associated with subnet

card_hash

string

Card hash

card_style_id

string

Style ID of card

client.id

string

ID of the client associated with the subnet

client.name

string

Name of the client associated with the subnet

created_on

integer

Date of subnet creation (milliseconds since Unix epoch time).

cvc

string

[Hidden] CVC code

exp

string

Expiration date of card (in YYYY-MM-DD)

nickname

string

Nickname given to the AC/RT account

node_id

string

Node ID associated with the subnet. Funds will be credited to this node when credits arrive

preferences._daily_atm_withdrawal_limit

integer

preferences._daily_transaction_limit

integer

preferences.allow_foreign_transactions

boolean

Flag to allow foreign transactions

preferences.daily_atm_withdrawal_limit

integer

User max ATM withdrawal limit

preferences.daily_transaction_limit

integer

User max transaction limit

preferences.spending_limit

boolean

Flag for user spending limit

status

string

Subnet status. See Subnet Statuses for more information

supp_id

string

Additional ID supplied to subnet

user_id

string

User ID associated with the subnet

GET /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

user.get_subnet(node_id, subnet_id);

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';

user.getSubnet(nodeID, subnetID);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

user.get_subnet(node_id: node_id, subnet_id: subnet_id)

$nodeid = '594e606212e17a002f2e3251';
$subnetid = '59c9f77cd412960028b99d2b';

$user->get_subnet($nodeid, $subnetid);

nodeID := "594e606212e17a002f2e3251"
subID := "59c9f77cd412960028b99d2b"

data, err := user.GetSubnet(nodeID, subID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5cb7c99439f3ae003e4fb3c3",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c64996c7f9c202542e96e09/nodes/5cb7aae388a3e200d87dde81/subnets/5cb7c99439f3ae003e4fb3c3"
    }
  },
  "access_token": "5cb7c9938fe0d6002c7b0685",
  "account_class": "DEBIT_CARD",
  "card_hash": "cf0a70f42c72ef5483f5b32bceb17d84a84e3f96ed4df86fd5f6a4f9eda41a1b",
  "card_number": "1171",
  "card_style_id": null,
  "client": {
    "id": "5beb506f6d7ceb002490631f",
    "name": "SynapseFI"
  },
  "created_on": 1555548562500,
  "cvc": "***",
  "exp": "2023-05-17",
  "nickname": "My Debit Card",
  "node_id": "5cb7aae388a3e200d87dde81",
  "preferences": {
    "_daily_atm_withdrawal_limit": 1500,
    "_daily_transaction_limit": 1500,
    "allow_foreign_transactions": true,
    "daily_atm_withdrawal_limit": 1000,
    "daily_transaction_limit": 1000,
    "spending_limit": false
  },
  "status": "INACTIVE",
  "supp_id": null,
  "user_id": "5c64996c7f9c202542e96e09"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Create Debit Card

Create a SUBNET

posthttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets

Request Body

Key

Type

Description

account_class

string

[Required] Type of account. Set as DEBIT_CARD

nickname

string

Nickname to assign to the node

supp_id

string

Additional ID supplied to subnet

Additional Information

When creating Debit Cards, the subnet will have a status of PENDING while our system attempts to provision a card. If this is successful, the status will be updated to INACTIVE.

POST /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "nickname":"My Debit Card",
  "account_class":"DEBIT_CARD"
}

node_id = "59c9f6a66d7d8a002f71b191"
body = {
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
}

user.create_subnet(node_id, body)

const nodeID = '59c9f6a66d7d8a002f71b191';
const body = {
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
};

user.createSubnet(nodeID, body);

node_id = "59c9f6a66d7d8a002f71b191"
body = {
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
}

user.create_subnet(node_id: node_id, payload: body)

$nodeid = '59c9f6a66d7d8a002f71b191';
$body = (object)[
	"nickname" => "My Debit Card",
	"account_class" => "DEBIT_CARD"
];

$user->create_subnet($nodeid, $body);

nodeID := "59c9f6a66d7d8a002f71b191"
body := `{
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
}`

data, err := user.CreateSubnet(nodeID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "59c9f77cd412960028b99d2b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b"
    }
  },
  "access_token": "5bc920f2fff373002bf0d51b",
  "account_class": "DEBIT_CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "59c9f77cd412960028b99d2b",
    "name": "SynapseFI"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Debit Card",
  "node_id": "59c9f6a66d7d8a002f71b191",
  "preferences": {
    "allow_foreign_transactions": false,
    "daily_atm_withdrawal_limit": 100,
    "daily_transaction_limit": 1000,
    "spending_limit": false
  },
  "status": "PENDING",
  "user_id": "59c9f69a89ec34002e1b4b2e"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Set Pin

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id####

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

card_pin

string

Encrypted card PIN. See Encrypting Sensitive Information for more information. Please note that underlying PIN must be 4 digits long.

Sandbox Set PIN Public Key for Legacy Card Issuance

SANDBOX - Set PIN - Legacy Card Issuance Public Key

Production Set PIN Public Key for Legacy Card Issuance

PRODUCTION - Set PIN - Legacy Card Issuance Public Key

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
  "card_pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body = {
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}

user.update_subnet(node_id, subnet_id, body)

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
};

 user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body =  {
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body = (object)[
  "pin" => "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);

nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bc920f2fff373002bf0d51b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
    }
  },
  "access_token": "5bc920f9a5061e002681c89f",
  "account_class": "DEBIT_CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "5b0da0f66e990e001f0c5f54",
    "name": "YY Test Account"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Debit Card",
  "node_id": "5bb29f5471fd1b0091317410",
  "preferences": {
    "allow_foreign_transactions": true,
    "daily_atm_withdrawal_limit": 10,
    "daily_transaction_limit": 1000,
    "spending_limit": false
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5bb29f48520da000a38cb107"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Ship Debit Card

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id/ship

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

fee_node_id

string

Object ID of node to deduct fee from

expedite

boolean

Flag to expedite shipping speed of card. Extra fees apply

card_style_id

string

Style ID of card

cardholder_name

string

Name to be printed on card

Additional Information

Cards may only be shipped twice every 6 months

PATCH /v3.1/users/5bb6ab05472e2500adffad5a/nodes/5bc920e27eb7c500972c7e33/subnets/5bc920f9a5061e002681c89f/ship HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_46jGbL5oIhAHtTuQVfYDpcqmedZBP9Xa0Owrnv7F|n38dj3h8NE393bv24ovoRY34kd62
Content-Type: application/json

{
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "660",
  "cardholder_name": "Cardholder Name"
}

node_id = '594e606212e17a002f2e3251'
subn_id = '59c9f77cd412960028b99d2b'
body = {
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":False,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}

user.ship_card(node_id, subn_id, body)

const nodeID = '594e606212e17a002f2e3251'
const subnetID = '59c9f77cd412960028b99d2b'
const body = {
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}

user.shipCard(nodeID, subnetID, body);

node_id = "5bbadc6f7b11c3008d045add"
subnet_id = “5bc920f2fff373002bf0d51b”
body= {
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}

user.ship_card(node_id: node_id, payload: body)

$body = (object) [
   "fee_node_id" => "5ba05e7920b3aa006482c5ad",
   "expedite" => false,
   "card_style_id" => "555",
   "cardholder_name" => "Cardholder Name"
];
$nodeid = '5bbadc6f7b11c3008d045add'
$subnetid = '5bc920f2fff373002bf0d51b'

$user->ship_card_subnet($nodeid , $subnetid , $body);

nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}`

data, err := user.ShipCard(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "node_id": "5bc920e27eb7c500972c7e33",
  "subnet_id": "5bc920f9a5061e002681c89f",
  "transaction_id": "5bcf7c59c39fa85af5729653"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update Status

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id#

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

status

string

Status of the card

Statuses

Note on Subnet Rate Limit

Cards subnets (and legacy CARD-US nodes) can now only be set to ACTIVE status a maximum of 10 times per week. This is intended to prevent unintended or non-standard use of our Update Card Status API call.

Please note that performing an Update Status API call to set a card to ACTIVE status when the card is already in ACTIVE status will still count against the weekly subnet rate limit referenced above.

Key ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌

Description

ACTIVE

Enables the card to be used for sending and receiving funds

INACTIVE

Disables debits on the node

TERMINATED

Disables the card number and blocks all transactions. This is sometimes used when an account is fraudulent

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
  "status": "ACTIVE"
}

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body = {
  "status": "ACTIVE"
}

user.update_subnet(node_id, subnet_id, body)

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "status": "ACTIVE"
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body = {
  "status": "ACTIVE"
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body = (object)[
  "status" => "ACTIVE"
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);

nodeID := "59c9f6a66d7d8a002f71b191"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "status": "ACTIVE"
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bc920f2fff373002bf0d51b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
    }
  },
  "access_token": "5bc920f9a5061e002681c89f",
  "account_class": "DEBIT_CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "5b0da0f66e990e001f0c5f54",
    "name": "YY Test Account"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Debit Card",
  "node_id": "5bb29f5471fd1b0091317410",
  "preferences": {
    "allow_foreign_transactions": true,
    "daily_atm_withdrawal_limit": 10,
    "daily_transaction_limit": 1000
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5bb29f48520da000a38cb107"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update Preferences

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

preferences.allow_foreign_transactions

boolean

Allow non-US transactions on card

preferences.atm_withdrawal_limit

integer

Max ATM withdrawal limit for debit card

preferences.daily_transaction_limits

integer

Max daily transaction limits for debit card

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}

user.update_subnet(node_id, subnet_id, body)

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$preferences = (object)[
     "allow_foreign_transactions" => true,
     "daily_atm_withdrawal_limit" => 5,
     "daily_transaction_limit" => 500
];
$body = (object)[
 "preferences" => $preferences
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);

nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bc920f2fff373002bf0d51b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
    }
  },
  "access_token": "5bc920f9a5061e002681c89f",
  "account_class": "DEBIT_CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "5b0da0f66e990e001f0c5f54",
    "name": "YY Test Account"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Debit Card",
  "node_id": "5bb29f5471fd1b0091317410",
  "preferences": {
    "allow_foreign_transactions": true,
    "daily_atm_withdrawal_limit": 5,
    "daily_transaction_limit": 500
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5bb29f48520da000a38cb107"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Dispute Transaction

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/trans/trans_id/dispute

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

trans_id

string

required

Object ID of transaction

Request Body

Key ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌

Type

Description

dispute_reason

string

Reason you are disputing the transaction. See the list of dispute reasons below for more information

dispute_meta.amount_received

integer

[Required for INCORRECT_AMOUNT|ATM] Amount received.

dispute_meta.lost_date

integer

[Required for UNAUTHORIZED|CARD_LOST] Date lost (milliseconds since Unix epoch time)

dispute_meta. type_of_merchandise_or_service

string

[Required for CHARGE_BACK] The type of merchandise or service (e.g. GROCERY).

dispute_meta. merchant_contacted

boolean

[Required for CHARGE_BACK] If merchant was contacted.

dispute_meta. contact_date

integer

[Required for CHARGE_BACK] Contact date (milliseconds since Unix epoch time).

dispute_meta. contact_method

string

[Required for CHARGE_BACK] Contact method (e.g. PHONE).

dispute_attachments

array of objects

Additional attachments with the dispute form when disputing a card transaction

Dispute Reasons

Description

CHARGE_BACK

Request to credit funds to user

CHARGED_TWICE

Card charged a second time for the same transaction

INCORRECT_AMOUNT

Card charged the incorrect amount

INCORRECT_AMOUNT|ATM

User attempted to withdraw money from ATM and received incorrect amount

UNAUTHORIZED|CARD_IN_HAND

Unauthorized transaction made while user has card in their possession

UNAUTHORIZED|CARD_LOST

Unauthorized transaction made and user has reported a lost or stolen card

PATCH /v3.1//users/594e0fa2838454002ea317a0/nodes/5bdb96d0389f2400afb06fe6/trans/5bdb9baed5faec00e4e9933e/dispute HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

// Basic Request Body

{
  "dispute_reason": "CHARGE_BACK",
  "dispute_meta": {
    "type_of_merchandise_or_service": "groceries",
    "merchant_contacted": true,
    "contact_method": "phone",
    "contact_date": 1563474864000
  },
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

// Incorrect Amount Request Body

{
  "dispute_reason": "INCORRECT_AMOUNT|ATM",
  "dispute_meta": {
    "amount_received": 2000
  },
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

// Unauthorized - Lost Card Request Body

{
  "dispute_reason": "UNAUTHORIZED|CARD_LOST",
  "dispute_meta": {
    "lost_date": 1538447536000
  },
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

// Charged Twice Request Body

{
  "dispute_reason": "CHARGED_TWICE",
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

node_id = '594e606212e17a002f2e3251'
trans_id = '594e72124599e8002fe62e4f'
dispute_reason = 'CHARGE_BACK'

user.cancel_trans(node_id, trans_id, dispute_reason)

const nodeID = '594e606212e17a002f2e3251';
const trxnID = '594e72124599e8002fe62e4f';
const body = {
	"dispute_reason":"CHARGE_BACK"
};

user.disputeCardTransaction(nodeID, trxnID, body);

card_id = "5bdb96d0389f2400afb06fe6"
transaction_id = "5bdb9baed5faec00e4e9933e"
body = {
	"dispute_reason":"CHARGE_BACK"
}

user.dispute_card_transactions(node_id: card_id, trans_id: transaction_id, payload: body)

$nodeid = '5bdb96d0389f2400afb06fe6';
$transid = '5bdb9baed5faec00e4e9933e';
$body = (object)[
   "dispute_reason" => "CHARGE_BACK"
];

$user->comment_trans( $nodeid, $transid, $body );

nodeID := "594e606212e17a002f2e3251"
transactionID := "594e72124599e8002fe62e4f"
body := `{
  "dispute_reason": "CHARGE_BACK"
}`

data, err := user.DisputeTransaction(nodeID, transactionID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "dispute_form": "https://cdn.synapsepay.com/uploads/2018/10/25/z4owXU1l0xFkJ9CbtWfV7Zu53gBryLEpsKjcdPDI2qTMQ68eGO.pdf",
  "provisional_credit_tran": "5bd20bd12073c800fe748fe9",
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Delete Debit Card

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id###

PATCH /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "status": "TERMINATED"
}

node_id = '594e606212e17a002f2e3251'
subn_id = '59c9f77cd412960028b99d2b'
body = {
  "status":"TERMINATED"
}

user.update_subnet(node_id, subn_id, body)

nodeID = "594e606212e17a002f2e3251";
subnetID = "59c9f77cd412960028b99d2b";
const body = {
  "status":"TERMINATED"
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "status":"TERMINATED"
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body= (object) [
  "status":"TERMINATED"
];

$node_id = '594e606212e17a002f2e3251';
$subnet_id = '59c9f77cd412960028b99d2b';
$user->update_subnet( $node_id, $subnet_id ,$body);

nodeID := "59c9f6a66d7d8a002f71b191"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "status":"TERMINATED"
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5d6ff580a866b5583c947d9b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5d6ee2b8c166ac007451dc91/nodes/5d6ff577d0ff336520f59169/subnets/5d6ff580a866b5583c947d9b"
    }
  },
  "access_token": "5d6ff5811d856d002c8bd2ee",
  "account_class": "CARD",
  "card_hash": "72c219c82bce62b546f3adc2683398541487c5b37be0f9b57a9bf199c16a58de",
  "card_number": "0539",
  "card_style_id": null,
  "client": {
    "id": "5cacf0f332c5d500256ee252",
    "name": "Mohammed Omar"
  },
  "created_on": 1567618432212,
  "cvc": "***",
  "exp": "2023-10-03",
  "nickname": "My Card",
  "node_id": "5d6ff577d0ff336520f59169",
  "preferences": {
    "allow_foreign_transactions": true,
  },
  "status": "TERMINATED",
  "supp_id": null,
  "user_id": "5d6ee2b8c166ac007451dc91"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Find ATM Locations

gethttps://uat-api.synapsefi.com/v3.1/nodes/atms

Query Params

zip

string

Zip code to search for ATMs

lat

string

Latitude coordinate to search

lon

string

Longitude coordinate to search

radius

string

Radius to search (miles)

page

string

Page number

per_page

string

Number of ATMs per page

GET /v3.1/nodes/atms?zip=94114&radius=5 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_auVIbQ8WXC0pnLU9ivEs4tcHDejqFJlwoNrZ3fO1|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

zip_code = "94114"
radius = "5"

client.locate_atms(zip='94114', lat=None, rad=None, page=None, per_page=None)

client.locateAtms({
  zip: '94114',
  radius: '5'
});

zip_code = "941114"
radius = "5"

client.locate_atm(zip: zip_code, radius: radius)

$zip = 94114;
$lat = null;
$lon = null;
$radius = 5;
$page = 1;
$per_page = 1;

$client->locate_atms($zip , $lat , $lon , $radius , $page , $per_page );

data, err := client.LocateATMs("zip=94114&radius=5")

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "atm_count": 50,
  "atms": [
    {
      "atmLocation": {
        "address": {
          "city": "SAN FRANCISCO",
          "country": "USA",
          "postalCode": "94114",
          "state": "CA",
          "street": "443 CASTRO STREET"
        },
        "coordinates": {
          "latitude": 37.761746,
          "longitude": -122.435024
        },
        "id": "398744",
        "isAvailable24Hours": true,
        "isDepositAvailable": true,
        "isHandicappedAccessible": false,
        "isOffPremise": false,
        "isSeasonal": false,
        "languageType": null,
        "locationDescription": "US BANK CASTRO",
        "logoName": "PAS",
        "name": "U.S. Bank Castro"
      },
      "distance": 0.12729728274872307
    },
    {
      ...
    }
  ],
  "page": 1,
  "page_count": 3,
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

View Card

View a SUBNET

gethttps://uat-api.synapsefi.com/v3.1/users/user_id/nodesnode_id/subnets/subnet_id#

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Query Params

full_dehydrate

string

[yes/no] Full Dehydrate yes will return back all the card info including the card number, and cvc.

Card Subnet Object

Key

Type

Description

_id

string

Object ID of subnet

_links.self.href

string

HAL-style link for the subnet object

access_token

string

Access token of subnet

account_class

string

Account class of subnet

account_num

string

Account number associated with subnet

card_hash

string

Card hash

card_style_id

string

Style ID of card

client.id

string

ID of the client associated with the subnet

client.name

string

Name of the client associated with the subnet

created_on

integer

Date of subnet creation (milliseconds since Unix epoch time).

cvc

string

[Hidden] CVC code

exp

string

Expiration date of card (in YYYY-MM-DD)

nickname

string

Nickname given to the card.

node_id

string

Node ID associated with the subnet. Funds will be credited to this node when credits arrive

preferences.allow_foreign_transactions

boolean

Flag to allow foreign transactions

status

string

Subnet status. See Subnet Statuses for more information

supp_id

string

Additional ID supplied to subnet

user_id

string

User ID associated with the subnet

GET /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

user.get_subnet(node_id, subnet_id);

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';

user.getSubnet(nodeID, subnetID);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

user.get_subnet(node_id: node_id, subnet_id: subnet_id)

$nodeid = '594e606212e17a002f2e3251';
$subnetid = '59c9f77cd412960028b99d2b';

$user->get_subnet($nodeid, $subnetid);

nodeID := "594e606212e17a002f2e3251"
subID := "59c9f77cd412960028b99d2b"

data, err := user.GetSubnet(nodeID, subID)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

200 Full Dehydrate

{
  "_id": "5cb7c99439f3ae003e4fb3c3",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5c64996c7f9c202542e96e09/nodes/5cb7aae388a3e200d87dde81/subnets/5cb7c99439f3ae003e4fb3c3"
    }
  },
  "access_token": "5cb7c9938fe0d6002c7b0685",
  "account_class": "CARD",
  "card_hash": "cf0a70f42c72ef5483f5b32bceb17d84a84e3f96ed4df86fd5f6a4f9eda41a1b",
  "card_number": "1171",
  "card_style_id": null,
  "client": {
    "id": "5beb506f6d7ceb002490631f",
    "name": "SynapseFI"
  },
  "created_on": 1555548562500,
  "cvc": "***",
  "exp": "2023-05-17",
  "nickname": "My Card",
  "node_id": "5cb7aae388a3e200d87dde81",
  "preferences": {
    "allow_foreign_transactions": true,
  },
  "status": "INACTIVE",
  "supp_id": null,
  "user_id": "5c64996c7f9c202542e96e09"
}

{
  "_id": "5dcc4b3cdb7bb297ac3ebd03",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5dc9f78a3c4e285368cf6e29/nodes/5dcc4b2dc2e6f366098e4ab1/subnets/5dcc4b3cdb7bb297ac3ebd03"
    }
  },
  "account_class": "CARD",
  "card_number": "5119130012432573",
  "card_style_id": null,
  "client": {
    "id": "5d76ce618b200d0065333ea1",
    "name": "Test Platform"
  },
  "created_on": 1573669692945,
  "cvc": "440",
  "exp": "2023-11-12",
  "nickname": "My Card",
  "node_id": "5dcc4b2dc2e6f366098e4ab1",
  "preferences": {
    "allow_foreign_transactions": false
  },
  "status": "INACTIVE",
  "supp_id": null,
  "user_id": "5dc9f78a3c4e285368cf6e29"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Create Card

posthttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/#

Request Body

Key

Type

Description

account_class

string

[Required] Type of account. Set as CARD

nickname

string

Nickname to assign to the node

supp_id

string

Additional ID supplied to subnet

POST /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "nickname":"My Card",
  "account_class":"CARD"
}

node_id = "59c9f6a66d7d8a002f71b191"
body = {
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
}

user.create_subnet(node_id, body)

const nodeID = '59c9f6a66d7d8a002f71b191';
const body = {
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
};

user.createSubnet(nodeID, body);

node_id = "59c9f6a66d7d8a002f71b191"
body = {
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
}

user.create_subnet(node_id: node_id, payload: body)

$nodeid = '59c9f6a66d7d8a002f71b191';
$body = (object)[
	"nickname" => "My Debit Card",
	"account_class" => "DEBIT_CARD"
];

$user->create_subnet($nodeid, $body);

nodeID := "59c9f6a66d7d8a002f71b191"
body := `{
	"nickname":"My Debit Card",
	"account_class":"DEBIT_CARD"
}`

data, err := user.CreateSubnet(nodeID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "59c9f77cd412960028b99d2b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b"
    }
  },
  "access_token": "5bc920f2fff373002bf0d51b",
  "account_class": "CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "59c9f77cd412960028b99d2b",
    "name": "SynapseFI"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Card",
  "node_id": "59c9f6a66d7d8a002f71b191",
  "preferences": {
    "allow_foreign_transactions": false,
  },
  "status": "INACTIVE",
  "user_id": "59c9f69a89ec34002e1b4b2e"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Set Pin

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id##

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

string

Encrypted card pin. See Encrypting Sensitive Information for more information. Please note that underlying PIN must be 4 digits.

Sandbox Set PIN Public Key

Production Set PIN Public Key

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body = {
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}

user.update_subnet(node_id, subnet_id, body)

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
};

 user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body =  {
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body = (object)[
  "pin" => "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);

nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "pin": "mlMKMv5+ekyw9M5AtqUBZxgdzj+GEjzddp93qSPw6uRXGpdNiNulVZxcbH1gGGiwEU9UeOwGmgiMaQsDkpbuh3SWY6IxSiPNHI9ryY8z/z+d8MXockQxsKnl1B+ekcLAXx9s2RZM7T6Nfoa+ABGwRV7aFGt91NYaolA0tfU1981J9juB/iljm9cz5JUKDPCxZbn+LW1f4O/5Pt3fDX9Nrre/HsuHtgc7OIu6XTvg1FCm+ds3AkFdHA0dw1aW4j5biXWVEkNpb01PIicANYXtO/AusqH8udBLh0GIU/xNSTzipk/M2hUqoTZdOo7Hu8UZgLbWUEpv7hAAY2tfu/ymsA=="
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bc920f2fff373002bf0d51b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
    }
  },
  "access_token": "5bc920f9a5061e002681c89f",
  "account_class": "CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "5b0da0f66e990e001f0c5f54",
    "name": "YY Test Account"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Card",
  "node_id": "5bb29f5471fd1b0091317410",
  "preferences": {
    "allow_foreign_transactions": true
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5bb29f48520da000a38cb107"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Ship Card

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id/ship/#

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

fee_node_id

string

Object ID of node to deduct fee from

expedite

boolean

Flag to expedite shipping speed of card. Extra fees apply

card_style_id

string

Style ID of card

cardholder_name

string

Name to be printed on card

Additional Information

Cards may only be shipped twice every 6 months

PATCH /v3.1/users/5bb6ab05472e2500adffad5a/nodes/5bc920e27eb7c500972c7e33/subnets/5bc920f9a5061e002681c89f/ship HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_46jGbL5oIhAHtTuQVfYDpcqmedZBP9Xa0Owrnv7F|n38dj3h8NE393bv24ovoRY34kd62
Content-Type: application/json

{
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "660",
  "cardholder_name": "Cardholder Name"
}

node_id = '594e606212e17a002f2e3251'
subn_id = '59c9f77cd412960028b99d2b'
body = {
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":False,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}

user.ship_card(node_id, subn_id, body)

const nodeID = '594e606212e17a002f2e3251'
const subnetID = '59c9f77cd412960028b99d2b'
const body = {
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}

user.shipCard(nodeID, subnetID, body);

node_id = "5bbadc6f7b11c3008d045add"
subnet_id = “5bc920f2fff373002bf0d51b”
body= {
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}

user.ship_card(node_id: node_id, payload: body)

$body = (object) [
   "fee_node_id" => "5ba05e7920b3aa006482c5ad",
   "expedite" => false,
   "card_style_id" => "555",
   "cardholder_name" => "Cardholder Name"
];
$nodeid = '5bbadc6f7b11c3008d045add'
$subnetid = '5bc920f2fff373002bf0d51b'

$user->ship_card_subnet($nodeid , $subnetid , $body);

nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "fee_node_id":"5bba781485411800991b606b",
  "expedite":false,
  "card_style_id": "555",
  "cardholder_name": "Cardholder Name"
}`

data, err := user.ShipCard(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "node_id": "5bc920e27eb7c500972c7e33",
  "subnet_id": "5bc920f9a5061e002681c89f",
  "transaction_id": "5bcf7c59c39fa85af5729653"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Update Card Status

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id/##

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

status

string

Status of the card

Statuses

Key ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌

Description

ACTIVE

Enables the card to be used for sending and receiving funds

INACTIVE

Card cannot be used to send or receive funds. Equivalent to "freezing" the card.

TERMINATED

Disables the card number and blocks all transactions. This is sometimes used when an account is fraudulent

Unlike our legacy card issuance, our native card issuance has no update status limits.

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
  "status": "ACTIVE"
}

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body = {
  "status": "ACTIVE"
}

user.update_subnet(node_id, subnet_id, body)

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "status": "ACTIVE"
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

body = {
  "status": "ACTIVE"
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body = (object)[
  "status" => "ACTIVE"
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);

nodeID := "59c9f6a66d7d8a002f71b191"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "status": "ACTIVE"
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bc920f2fff373002bf0d51b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
    }
  },
  "access_token": "5bc920f9a5061e002681c89f",
  "account_class": "CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "5b0da0f66e990e001f0c5f54",
    "name": "YY Test Account"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Card",
  "node_id": "5bb29f5471fd1b0091317410",
  "preferences": {
    "allow_foreign_transactions": true
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5bb29f48520da000a38cb107"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Allow Foreign Transactions

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id/###

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

subnet_id

string

required

Object ID of subnet

Request Body

Key

Type

Description

preferences.allow_foreign_transactions

boolean

Allow non-US transactions on card

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
  "preferences":{
    "allow_foreign_transactions": true,
  }
}

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}

user.update_subnet(node_id, subnet_id, body)

const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$preferences = (object)[
     "allow_foreign_transactions" => true,
     "daily_atm_withdrawal_limit" => 5,
     "daily_transaction_limit" => 500
];
$body = (object)[
 "preferences" => $preferences
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);

nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":5,
    "daily_transaction_limit":500
  }
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5bc920f2fff373002bf0d51b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
    }
  },
  "access_token": "5bc920f9a5061e002681c89f",
  "account_class": "CARD",
  "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
  "card_number": "5431",
  "card_style_id": null,
  "client": {
    "id": "5b0da0f66e990e001f0c5f54",
    "name": "YY Test Account"
  },
  "created_on": 1555549989904,
  "cvc": "***",
  "exp": "2022-11-17",
  "nickname": "My Card",
  "node_id": "5bb29f5471fd1b0091317410",
  "preferences": {
    "allow_foreign_transactions": true,
  },
  "status": "ACTIVE",
  "supp_id": null,
  "user_id": "5bb29f48520da000a38cb107"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Dispute Transaction

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/trans/trans_id/dispute/

Path Params

user_id

string

required

Object ID of user

node_id

string

required

Object ID of node

trans_id

string

required

Object ID of transaction

Request Body

Key ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌

Type

Description

dispute_reason

string

Reason you are disputing the transaction. See the list of dispute reasons below for more information

dispute_meta.amount_received

integer

[Required for INCORRECT_AMOUNT|ATM] Amount received.

dispute_meta.lost_date

integer

Required for UNAUTHORIZED|CARD_LOST Date lost (milliseconds since Unix epoch time).

dispute_meta. type_of_merchandise_or_service

string

[Required for CHARGE_BACK] The type of merchandise or service (e.g. GROCERY).

dispute_meta. merchant_contacted

boolean

[Required for CHARGE_BACK] If merchant was contacted.

dispute_meta. contact_date

integer

[Required for CHARGE_BACK] Contact date (milliseconds since Unix epoch time).

dispute_meta. contact_method

string

[Required for CHARGE_BACK] Contact method (e.g. PHONE).

dispute_attachments

array of objects

Additional attachments with the dispute form when disputing a card transaction

Dispute Reasons

Value ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌ ‌‌

Description

CHARGE_BACK

Request to credit funds to user

CHARGED_TWICE

Card charged a second time for the same transaction

INCORRECT_AMOUNT

Card charged the incorrect amount

INCORRECT_AMOUNT|ATM

User attempted to withdraw money from ATM and received incorrect amount

UNAUTHORIZED|CARD_IN_HAND

Unauthorized transaction made while user has card in their possession

UNAUTHORIZED|CARD_LOST

Unauthorized transaction made and user has reported a lost or stolen card

PATCH /v3.1//users/594e0fa2838454002ea317a0/nodes/5bdb96d0389f2400afb06fe6/trans/5bdb9baed5faec00e4e9933e/dispute HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_1mtgLwhYHDVKop04XOEjyWJSsnQqZbGkfRF5ux9v|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

// Basic Request Body

{
  "dispute_reason": "CHARGE_BACK",
  "dispute_meta": {
    "type_of_merchandise_or_service": "groceries",
    "merchant_contacted": true,
    "contact_method": "phone",
    "contact_date": 1563474864000
  },
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

// Incorrect Amount Request Body

{
  "dispute_reason": "INCORRECT_AMOUNT|ATM",
  "dispute_meta": {
    "amount_received": 2000
  },
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

// Unauthorized - Lost Card Request Body

{
  "dispute_reason": "UNAUTHORIZED|CARD_LOST",
  "dispute_meta": {
    "lost_date": 1538447536000
  },
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

// Charged Twice Request Body

{
  "dispute_reason": "CHARGED_TWICE",
  "dispute_attachments": [
    "data:image/gif;base64,SUQs=="
  ]
}

node_id = '594e606212e17a002f2e3251'
trans_id = '594e72124599e8002fe62e4f'
dispute_reason = 'CHARGE_BACK'

user.cancel_trans(node_id, trans_id, dispute_reason)

const nodeID = '594e606212e17a002f2e3251';
const trxnID = '594e72124599e8002fe62e4f';
const body = {
	"dispute_reason":"CHARGE_BACK"
};

user.disputeCardTransaction(nodeID, trxnID, body);

card_id = "5bdb96d0389f2400afb06fe6"
transaction_id = "5bdb9baed5faec00e4e9933e"
body = {
	"dispute_reason":"CHARGE_BACK"
}

user.dispute_card_transactions(node_id: card_id, trans_id: transaction_id, payload: body)

$nodeid = '5bdb96d0389f2400afb06fe6';
$transid = '5bdb9baed5faec00e4e9933e';
$body = (object)[
   "dispute_reason" => "CHARGE_BACK"
];

$user->comment_trans( $nodeid, $transid, $body );

nodeID := "594e606212e17a002f2e3251"
transactionID := "594e72124599e8002fe62e4f"
body := `{
  "dispute_reason": "CHARGE_BACK"
}`

data, err := user.DisputeTransaction(nodeID, transactionID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "dispute_form": "https://cdn.synapsepay.com/uploads/2018/10/25/z4owXU1l0xFkJ9CbtWfV7Zu53gBryLEpsKjcdPDI2qTMQ68eGO.pdf",
  "provisional_credit_tran": "5bd20bd12073c800fe748fe9",
  "success": true
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Delete Card

patchhttps://uat-api.synapsefi.com/v3.1/users/user_id/nodes/node_id/subnets/subnet_id/####

PATCH /v3.1/users/59c9f69a89ec34002e1b4b2e/nodes/59c9f6a66d7d8a002f71b191/subnets/59c9f77cd412960028b99d2b HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_xEyuYzmPN6Rp120Kg08Ma3SdO4w5c9ZFBnWfbJer|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

{
  "status": "TERMINATED"
}

node_id = '594e606212e17a002f2e3251'
subn_id = '59c9f77cd412960028b99d2b'
body = {
  "status":"TERMINATED"
}

user.update_subnet(node_id, subn_id, body)

nodeID = "594e606212e17a002f2e3251";
subnetID = "59c9f77cd412960028b99d2b";
const body = {
  "status":"TERMINATED"
};

user.updateSubnet(nodeID, subnetID, body);

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "status":"TERMINATED"
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)

$body= (object) [
  "status":"TERMINATED"
];

$node_id = '594e606212e17a002f2e3251';
$subnet_id = '59c9f77cd412960028b99d2b';
$user->update_subnet( $node_id, $subnet_id ,$body);

nodeID := "59c9f6a66d7d8a002f71b191"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "status":"TERMINATED"
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "_id": "5d6ff580a866b5583c947d9b",
  "_links": {
    "self": {
      "href": "https://uat-api.synapsefi.com/v3.1/users/5d6ee2b8c166ac007451dc91/nodes/5d6ff577d0ff336520f59169/subnets/5d6ff580a866b5583c947d9b"
    }
  },
  "access_token": "5d6ff5811d856d002c8bd2ee",
  "account_class": "CARD",
  "card_hash": "72c219c82bce62b546f3adc2683398541487c5b37be0f9b57a9bf199c16a58de",
  "card_number": "0539",
  "card_style_id": null,
  "client": {
    "id": "5cacf0f332c5d500256ee252",
    "name": "Mohammed Omar"
  },
  "created_on": 1567618432212,
  "cvc": "***",
  "exp": "2023-10-03",
  "nickname": "My Card",
  "node_id": "5d6ff577d0ff336520f59169",
  "preferences": {
    "allow_foreign_transactions": true,
  },
  "status": "TERMINATED",
  "supp_id": null,
  "user_id": "5d6ee2b8c166ac007451dc91"
}

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Find ATM Locations

gethttps://uat-api.synapsefi.com/v3.1/nodes/atms/#

Query Params

zip

string

Zip code to search for ATMs

lat

string

Latitude coordinate to search

lon

string

Longitude coordinate to search

radius

string

Radius to search (miles)

page

string

Page number

per_page

string

Number of ATMs per page

GET /v3.1/nodes/atms?zip=94114&radius=5 HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_auVIbQ8WXC0pnLU9ivEs4tcHDejqFJlwoNrZ3fO1|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

zip_code = "94114"
radius = "5"

client.locate_atms(zip='94114', lat=None, rad=None, page=None, per_page=None)

client.locateAtms({
  zip: '94114',
  radius: '5'
});

zip_code = "941114"
radius = "5"

client.locate_atm(zip: zip_code, radius: radius)

$zip = 94114;
$lat = null;
$lon = null;
$radius = 5;
$page = 1;
$per_page = 1;

$client->locate_atms($zip , $lat , $lon , $radius , $page , $per_page );

data, err := client.LocateATMs("zip=94114&radius=5")

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

{
  "error_code": "0",
  "http_code": "200",
  "limit": 20,
  "atm_count": 50,
  "atms": [
    {
      "atmLocation": {
        "address": {
          "city": "SAN FRANCISCO",
          "country": "USA",
          "postalCode": "94114",
          "state": "CA",
          "street": "443 CASTRO STREET"
        },
        "coordinates": {
          "latitude": 37.761746,
          "longitude": -122.435024
        },
        "id": "398744",
        "isAvailable24Hours": true,
        "isDepositAvailable": true,
        "isHandicappedAccessible": false,
        "isOffPremise": false,
        "isSeasonal": false,
        "languageType": null,
        "locationDescription": "US BANK CASTRO",
        "logoName": "PAS",
        "name": "U.S. Bank Castro"
      },
      "distance": 0.12729728274872307
    },
    {
      ...
    }
  ],
  "page": 1,
  "page_count": 3,
  "success": true
}